bike
/
gbootroot
mirror of https://github.com/fspc/gbootroot.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

Upldated to the new module sections.

master
freesource 23 years ago
parent
a11343bae2
commit
53bdabd794
2 changed files with 136 additions and 120 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. BIN
      doc/html/images/ABS.jpg
  2. 198
      doc/html/index.html

BIN
doc/html/images/ABS.jpg
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 31 KiB

198
doc/html/index.html
View File

@ -38,8 +38,8 @@ continue &quot;OK&quot; or stop &quot;Cancel&quot;.</P>
<p>
The <u>first row</u> presently has only one Boot Method choice:
"2 disk compression."&nbsp;&nbsp
Clicking on the menu on the right selects the Boot Method.</p>
"2 disk compression."&nbsp;&nbsp;Clicking on the menu on the right selects
the Boot Method.</p>
<P>The <u>second row</u> allows you to select the kernel for the Boot/Root set.&nbsp;&nbsp;You
@ -58,8 +58,8 @@ provided in the Advanced Root Section.
device is the first floppy disk - /dev/fd0.</P>
<p>
The <u>fifth row</u> allows you to choose the size of the device being used. &nbsp;&nbsp;
The default size of 1440 assumes you are using a floppy drive (Note: You may
The <u>fifth row</u> allows you to choose the size of the device being used.&nbsp;&nbsp;The default size of 1440 assumes you are using a floppy drive
(Note: You may
want to experiment with 1722 which works fine with many floppy drives.), but
can be used with other sized devices like tape drives.&nbsp;&nbsp;Click on the
appropriate radio button to choose either gzip or bzip2 compression if the
@ -71,8 +71,8 @@ program doesn't automatically detect it.</p>
The <u>slider bar</u> on the right allows the output of the verbosity box
to be
changed from the highest (2) to the lowest setting (1) or to be turned off (0)
or on again.&nbsp;&nbsp;
At times it may be advantageous to turn off the verbosity box
or on again.&nbsp;&nbsp;At times it may be advantageous to turn off the
verbosity box
since large quantities of output to this box may cause gbootroot to use too
much cpu power; however, output may still be found in the text file "verbose"
in /tmp/gbootroot_tmp'time-date'.</p>
@ -84,9 +84,11 @@ Using the Advanced Boot Section</b></p>
<p><IMG ALT="" SRC="images/ABS.jpg" align="right">
"Stripping"&nbsp;&nbsp; On by default for libraries and binaries.&nbsp;&nbsp; The stripping
Libraries & Binaries & Modules check boxes:&nbsp;&nbsp;Turn off and on the
stripping of symbols.&nbsp;&nbsp;The stripping
behavior for libraries may be changed by clicking on the right mouse button
to change from --strip-debug to --strip-all.</p>
to change --strip-debug to --strip-all.&nbsp;&nbsp;Binaries default to
--strip-all and Modules default to --strip-debug.</p>
<p>
@ -98,37 +100,49 @@ on the actual boot device.</p>
<p>
"Opt. Device"&nbsp;&nbsp;Add devices to the boot disk which are necessary for the
kernel to function properly.&nbsp;&nbsp;
Put a space between each device.&nbsp;&nbsp;
For instance, /dev/fb0 for frame buffer devices.</p>
kernel to function properly.&nbsp;&nbsp;Put a space between each
device.&nbsp;&nbsp;For instance, /dev/fb0 for frame buffer devices.</p>
<p>
"append ="&nbsp;&nbsp;Add append options to brlilo.conf.&nbsp;&nbsp;If you are using a frame
buffer device you could add something like video=matrox:vesa:402,depth:16.</p>
<p>
"Kernel Module"&nbsp;&nbsp;Add the modules found in
/lib/modules/kernel-version which are necessary for the Boot Method to work
properly.&nbsp;&nbsp;
If these modules aren't found in the modules directory it is assumed
that they either are in the kernel or they do not exist.&nbsp;&nbsp;
In the case of 2 disk compression, floppy needs to be included in the
kernel or included as a module. &nbsp;&nbsp;
Kmod inserts the modules, and kmod needs to be built into the kernel along
with initrd and ramdisk.",</p>
properly.&nbsp;&nbsp;If these modules aren't found in the modules directory
it is assumed
that they either are in the kernel or they do not exist.&nbsp;&nbsp;In the
case of 2 disk compression, floppy needs to be included in the
kernel or included as a module. &nbsp;&nbsp;Kmod inserts the modules, and
kmod needs to be built into the kernel along
with initrd and ramdisk."</p>
<p>
"append ="&nbsp;&nbsp; Add append options to brlilo.conf.&nbsp;&nbsp; If you are using a frame
buffer device you could add something like video=matrox:vesa:402,depth:16.</p>
"Kernel Version"&nbsp;&nbsp;Override the kernel version number found in the
kernel header.&nbsp;&nbsp;This will change the /lib/modules/kernel-version
directory.</p>
<br><br><br><br><br><br><br><br><br>
<p>
System.map:&nbsp;&nbsp;When a non-running kernel is chosen it is important
to include a copy of that kernel's System.map file so that depmod can use
the correct set of kernel symbols to resolve kernel references in each
module.&nbsp;&nbsp;This can be found in the kernel's source code after
compilation.
<br><br><br><br><br><br><br>
<P align="center">
<b>Using the Advanced Root Section</b></P>
<p><IMG ALT="" SRC="images/ARS.jpg" align="right">
"Root Device"&nbsp;&nbsp;
This is the device used for the root filesystem when
constructing the Boot/Root set.&nbsp;&nbsp;
You may choose a device which is different
"Root Device"&nbsp;&nbsp;This is the device used for the root filesystem when
constructing the Boot/Root set.&nbsp;&nbsp;You may choose a device which is
different
than the Boot device, but presently only floppy devices are supported.</p>
<p>
@ -137,23 +151,21 @@ than the Boot device, but presently only floppy devices are supported.</p>
<p>
"Root Filename"&nbsp;&nbsp;
The name give to the root filesystem when initially made
in the temporary creation location.&nbsp;&nbsp;
The save button allows the creation to
"Root Filename"&nbsp;&nbsp;The name give to the root filesystem when
initially made in the temporary creation location.&nbsp;&nbsp;The save
button allows the creation to
be saved in the permanent default location when the
Accept button is pressed.</p>
<p>
"Filesystem Size"&nbsp;&nbsp;
Root Methods make the filesystem the size which is
specified here.</p>
"Filesystem Size"&nbsp;&nbsp; Root Methods make the filesystem the size
which is specified here.</p>
<p>
"Compression"&nbsp;&nbsp;
Off by default to allow user-mode-linux testing.&nbsp;&nbsp; Turn on
"Compression"&nbsp;&nbsp;Off by default to allow user-mode-linux
testing.&nbsp;&nbsp;Turn on
compression when you are ready to use a Boot Method
which requires compression.</p>
@ -163,8 +175,8 @@ which requires compression.</p>
<p>
"Template"&nbsp;&nbsp; The template associated with a Root Method.&nbsp;&nbsp;
Not all Root Methods
"Template"&nbsp;&nbsp;The template associated with a Root
Method.&nbsp;&nbsp;Not all Root Methods
have templates.</p>
<p>
@ -173,19 +185,19 @@ have templates.</p>
<p>
"UML"&nbsp;&nbsp; Abbreviation for user-mode-linux. &nbsp;&nbsp;
This is a linux kernel which runs on
"UML"&nbsp;&nbsp;Abbreviation for user-mode-linux.&nbsp;&nbsp;This is a
linux kernel which runs on
top of the host system's linux kernel and allows a you run a live root
filesystem.</p>
<p>
"Accept"&nbsp;&nbsp;
This accepts the created root filesystem if it is found in the
temporary creation directory. &nbsp;&nbsp;
The UML box and the main section will now
reflect the path to this root filesystem. &nbsp;&nbsp;
You can now test with the UML
"Accept"&nbsp;&nbsp;This accepts the created root filesystem if it is
found in the
temporary creation directory.&nbsp;&nbsp;The UML box and the main section
will now
reflect the path to this root filesystem.&nbsp;&nbsp;You can now test with
the UML
button or a put together a complete Boot/Root set with the Submit button.</p>
<br><br><br><br><br><br><br>
@ -203,12 +215,12 @@ devfs=nomount.</p>
<p>
"Root_Fs"&nbsp;&nbsp;Choose an uncompressed root filesystem.&nbsp;&nbsp;
Append with ubd?=.</p>
"Root_Fs"&nbsp;&nbsp;Choose an uncompressed root
filesystem.&nbsp;&nbsp;Append with ubd?=.</p>
<p>
"Abort"&nbsp;&nbsp; Abort user-mode-linux kernel processes.&nbsp;&nbsp;</p>
"Abort"&nbsp;&nbsp;Abort user-mode-linux kernel processes.</p>
<p><P align="center"><b>
@ -217,31 +229,31 @@ About the Yard Box</b></p>
<p><IMG ALT="" SRC="images/yard_box.jpg" align="center"></p>
The Yard Box is a Root Method which is "Generated" from the Advanced Root
Section after a Template is chosen.&nbsp;&nbsp;
It has several interesting features.
Section after a Template is chosen.&nbsp;&nbsp;It has several
interesting features.
<p>
The check boxes at the bottom represent the different stages involved in
creating a root filesystem.&nbsp;&nbsp;
The behavior of these stages may be altered in
creating a root filesystem.&nbsp;&nbsp;The behavior of these stages
may be altered in
three ways: Edit->Stages->one-by-one (default) will perform each stage
sequentially, stopping between each stage, the user may continue the process
by pressing the Continue button. &nbsp;&nbsp;
Edit->Stages->continuous proceeds non-stop
through all the stages.&nbsp;&nbsp;
Edit->Stages->'user defined' allows the user to
by pressing the Continue
button.&nbsp;&nbsp;Edit->Stages->continuous proceeds non-stop
through all the
stages.&nbsp;&nbsp;Edit->Stages->'user defined' allows the user to
choose any stages the user wants, and will then proceed through all the
chosen stages.&nbsp;&nbsp;
Choosing only 'Check', 'Links & Deps', 'Create" is a good
chosen
stages.&nbsp;&nbsp;Choosing only 'Check', 'Links & Deps', 'Create" is a good
example.</p>
<p><IMG ALT="" SRC="images/tests.jpg" align="center"></p>
<p>
The behavior of some of the stages may be altered.&nbsp;&nbsp;
For instance Alt-T allows
The behavior of some of the stages may be
altered.&nbsp;&nbsp;For instance Alt-T allows
you to choose which tests to run on the newly created
root filesystem.</p>
@ -250,21 +262,19 @@ root filesystem.</p>
<p>
Press Alt-S to enable template text searching in either
direction.&nbsp;&nbsp;
Find exact matches or ignore case with the case sensitive check
box.</p>
direction.&nbsp;&nbsp;Find exact matches or ignore case with
the case sensitive check box.</p>
<p><IMG ALT="" SRC="images/file.jpg" align="center"></p>
<p>
Use Ctl-S to save the changes to an open template, and Alt-A to save the
template with a new name.&nbsp;&nbsp;
bOOTrOOT will not allow read-only templates or template links to be saved
with their own name.&nbsp;&nbsp;
A few of these example files are included. &nbsp;&nbsp;
You may make changes to them or clear their buffers.&nbsp;&nbsp;
Then you may save the template with a
template with a new name.&nbsp;&nbsp;bOOTrOOT will not allow read-only
templates or template links to be saved
with their own name.&nbsp;&nbsp;A few of these example files a
re included.&nbsp;&nbsp;You may make changes to them or
clear their buffers.&nbsp;&nbsp;Then you may save the template with a
different name.</p>
<p><IMG ALT="" SRC="images/stripping.jpg" align="center"></p>
@ -272,8 +282,8 @@ different name.</p>
<p>
Edit->Settings->Stripping allows you to turn off/on stripping for
Libraries, Binaries, and Modules.&nbsp;&nbsp;
--strip-all is the default for binaries and libraries,
Libraries, Binaries, and Modules.&nbsp;&nbsp;--strip-all is the
default for binaries and libraries,
and --strip-debug is the default for modules; however libraries may
be changed to --strip-debug in the settings.</p>
@ -291,8 +301,8 @@ environments $PATH variable.
<p>
Edit->'File System" may alter the type of filesystem used to make the root
filesystem.&nbsp;&nbsp;
Because the filesystem is created on a loop device, some
filesystem.&nbsp;&nbsp;Because the filesystem is
created on a loop device, some
filesystem types may complain or not be created at all.</p>
<p><IMG ALT="" SRC="images/replacements.jpg" align="center"></p>
@ -307,8 +317,8 @@ an editor of your choice.
<p>
Create->Replacements creates special replacement files.&nbsp;&nbsp;
Presently it creates
Create->Replacements creates special replacement
files.&nbsp;&nbsp; Presently it creates
an fstab configuration file as Replacements/etc/fstab.new in
$HOME/.gbootroot/yard/.</p>
@ -331,8 +341,8 @@ filesystem.</P>
(Explanation from the first gbootroot.)<br>
"You can use a bzip2 compressed filesystem, this program is easy to use, and
it provides a framework showing a simple initrd method which you can freely
modify.&nbsp;&nbsp;
I wrote this program as an extension to BootRoot which was written
modify.&nbsp;&nbsp;I wrote this program as an extension to BootRoot
which was written
as a solution to help oster at EE (www.experts-exchange.com) create separate
boot and root floppies for an emergency system for his customers."</P>
@ -361,28 +371,31 @@ $HOME/.gbootroot/root_filesystems. </p>
<p>
3.&nbsp;&nbsp; Run gbootroot.&nbsp;&nbsp;
Click on the Advanced Root Section, click on
3.&nbsp;&nbsp;Run
gbootroot.&nbsp;&nbsp;Click on the Advanced Root Section, click on
the UML button. &nbsp;&nbsp;Select root_fs_tomrtbt_1.7.205, and click on the Submit
button.</p>
<p>
4.&nbsp;&nbsp; Click on the Advanced Boot Section.&nbsp;&nbsp;
Root_fs_tomrtbt is about 16M, so add ramdisk_size=16384 to
the 'append=' entry. &nbsp;&nbsp;
From the main box choose '2 disk compression', and
4.&nbsp;&nbsp;Click on the Advanced Boot
Section.&nbsp;&nbsp;Root_fs_tomrtbt is about 16M, so add ramdisk_size=16384 to
the 'append=' entry.&nbsp;&nbsp;From the main box choose '2 disk compression', and
press on the Root Filesystem button and select root_fs_tomrtbt_1.7.205.bz2.
</p>
5.&nbsp;&nbsp; Click the Submit button on the main box.&nbsp;&nbsp;
Have two floppy disks ready.
5.&nbsp;&nbsp;Click the Submit button on the main
box.&nbsp;&nbsp;Have two floppy disks ready.
<p>
6.&nbsp;&nbsp;When you see Lilo you may access the menu using [Ctrl] and
[Tab] to see the available images.
<p>
7.
<P><b>My root filesystem doesn't start in single mode when started like
this:&nbsp;&nbsp&quot;bootdisk 1?&quot;</b></P>
@ -397,9 +410,9 @@ Why on the subject, it should be pointed at the setting up init and its
runlevels is one of the
most challenging areas of creating a bootable root_fs.&nbsp;&nbspOften
your creation will only work with "single" until all the conflicts
are resolved.&nbsp;&nbsp Things are complicated even futher by the fact that
are resolved.&nbsp;&nbsp;Things are complicated even futher by the fact that
devices can now be set up in two majors ways: tty? or ttys/? (devfs).
&nbsp;&nbsp Fortunately, user-mode-linux comes in very handy for hunting
&nbsp;&nbsp;Fortunately, user-mode-linux comes in very handy for hunting
down all the bugs.
@ -431,11 +444,13 @@ zeroing block 1600 at end of filesystem."</p>
I understand Theodore Ts'o reasoning for doing this, but I strongly believe
that the old behavior was very useful for people creating
mini-distributions so I have issued Feature Request (#) at (here).&nbsp;&nbsp;
It should be noted that fdformat is an unacceptable solution because it tends
mini-distributions so I have issued Feature Request (#) at
(here).&nbsp;&nbsp;It should
be noted that fdformat is an unacceptable solution because it tends
to be machine specific, and the original mke2fs behavior made floppies that
worked everywhere.&nbsp;&nbsp;
Feel free to add your comments to the Feature Request.&nbsp;&nbsp; Thanks.</p>
worked
everywhere.&nbsp;&nbsp;Feel free
to add your comments to the Feature Request.&nbsp;&nbsp;Thanks.</p>
<p>
@ -450,7 +465,8 @@ This is because of the way Gtk works.&nbsp;&nbsp; There are two adjustments,
step and page increments.&nbsp;&nbsp;When you press your first mouse button the step
has been set to 282 so that a person can easily switch between 1440 and 1722.
&nbsp;&nbsp;When you use your second mouse button the page is set at 360. You can go
down to zero by pressing your third mouse button on the down arrow.&nbsp;&nbsp; Now
down to zero by pressing your third mouse button on the
down arrow.&nbsp;&nbsp;Now
page up with the second button to 1440 and step with the first button to
1722.&nbsp;&nbsp;Pretty cool, eh?</p>

Write Preview
Loading…
Cancel
Save