mirror of
https://github.com/fspc/gbootroot.git
synced 2025-02-23 09:03:23 -05:00
9cede96d0f
EXPECT, and a bug where .options wasn't being written to disk or the path was being altered when a variable was being altered. This also gets things trim and ready with the coolest discovery being that a nested kernel can run on the host and in it's nest. I'll be testing other nested levels to discover how far this can go and be incorporated in one package which is nice.
140 lines
4.2 KiB
Plaintext
140 lines
4.2 KiB
Plaintext
$Id: README,v 1.15 2003/01/05 02:10:41 freesource Exp $
|
|
Program: gBootRoot pronounced "bOOtrOOt"
|
|
License: GNU General Public License
|
|
|
|
BUILDING
|
|
---------
|
|
|
|
If you can compile a kernel on your system, then you should have no
|
|
problems getting the Makefile to work, and if you are using the
|
|
sources for the Debian package, then you can always do an "apt-get
|
|
build-dep gbootroot." to automatically figure out your build
|
|
requirements. Gbootroot makes its own root_fs, when the output gets
|
|
colorful (blue and red) you know this is happening. If things go
|
|
wrong at this point you will want to look at the requirements below.
|
|
|
|
You will want wget installed because the Makefile attempts to download
|
|
the necessary sources and then places them in the sources/ directory.
|
|
This is what makes the unofficial Debian and RedHat source packages
|
|
unique, because usually another package would provide the necessary
|
|
sources since official distributions aren't always used online. On the
|
|
other hand, this is a FEATURE. Anytime you want to update gbootroot
|
|
to the current user-mode-linux patch just change the Makefile
|
|
PATCH_VERSION, run "make clean", and then "make".
|
|
|
|
The two root_fs created are root_fs_helper and Initrd.gz.
|
|
Root_fs_helper has lots of different filesystem utilities, but the
|
|
CRUCIAL ones to get the build to work properly are mke2fs and
|
|
mkcramfs. Here's a list of what utilities are included: mke2fs mkcramfs
|
|
genromfs mkfs.minix mkminix mkreiserfs mkfs.jffs mkfs.jffs2
|
|
|
|
These are the build-depends from the debian source package which can
|
|
be used as a guide for other distributions: binutils ((>=
|
|
2.13.90.0.16), fileutils (>= 4.0), gcc (>= 2:2.95.4), make, libc6-dev
|
|
(>= 2.3.1), bin86, wget, mkcramfs, e2fsprogs, reiserfsprog, genromfs,
|
|
xutil-linux, mtd-tools, m4, libreadline4-dev
|
|
|
|
INSTALLING
|
|
----------
|
|
|
|
If you build the package as a non-root user, and you don't have
|
|
permissions to write to system directories you can always run
|
|
gbootroot from the immediate source directory "./gbootroot --home ."
|
|
or "perl -I . ./gbootroot --home ." if there is already another
|
|
installed version on the system.
|
|
|
|
To install on the system type "make install" and follow the
|
|
instructions in the "Important Configurations" section near the bottom
|
|
of this page, and then run gbootroot.
|
|
|
|
When you run gbootroot if a boot or root method are missing required
|
|
programs, pop-up dialog boxes and information from the verbosity box
|
|
will give a good indication of what is causing the problem.
|
|
|
|
|
|
REQUIREMENTS TO RUN GBOOTROOT
|
|
-----------------------------
|
|
|
|
PERL MODULES
|
|
|
|
Gtk-Perl (Required for GUI)
|
|
--------------------------
|
|
|
|
Version 0.7002 or greater.
|
|
http://freshmeat.net/projects/gtk-perl
|
|
|
|
[ The next three are required for automated normal (non-root) user
|
|
functionality . ]
|
|
|
|
Expect (tested with 1.11)
|
|
------------------------
|
|
http://www.perl.com/CPAN/modules/by-module/Expect/
|
|
http://sourceforge.net/projects/expectperl
|
|
RPM version can be found at sf.net/gbootroot.
|
|
|
|
IO::Stty
|
|
--------
|
|
http://www.perl.com/CPAN/modules/by-module/IO/IO-Stty-.02.tar.gz
|
|
RPM versions can be found at sf.net/gbootroot.
|
|
|
|
IO::Tty
|
|
-------
|
|
http://www.perl.com/CPAN/modules/by-module/IO/IO-Tty-0.04.tar.gz
|
|
http://sourceforge.net/projects/expectperl
|
|
RPM versions can be found at sf.net/gbootroot.
|
|
|
|
|
|
BOOT METHODS
|
|
|
|
2 disk compression
|
|
------------------
|
|
|
|
This method will tell you when any of these utilities are missing:
|
|
|
|
ash lilo bzip2 file
|
|
|
|
|
|
ROOT METHODS
|
|
|
|
Yard (This is a method - not a program)
|
|
--------------------------------------
|
|
|
|
Watch the verbosity box, it will be obvious when a required command is
|
|
missing. Make sure you have this file installed on your system:
|
|
|
|
file
|
|
|
|
|
|
IMPORTANT CONFIGURATIONS
|
|
|
|
"chown 0:0 /usr/bin/uml_net; chmod 4755 /usr/bin/uml_net" so normal
|
|
users can have network capabilities; ofcourse, you may totally avoid
|
|
doing the suid thing by using tunctl.
|
|
|
|
Should the host kernel have the skas patch applied?
|
|
|
|
"Yes, I highly recommended it. It's a great performance improvement,
|
|
and gbootroot-nest1 will run a lot better. Modes are figured out
|
|
automatically by skas-or-tt so don't add mode={tt,skas} in the UML
|
|
box"
|
|
|
|
|
|
DOCUMENTATION
|
|
|
|
Documentation and FAQ are in doc/html/index.html
|
|
|
|
|
|
Have fun!
|
|
|
|
-Jonathan
|
|
|
|
Please infuse your suggestions, bug reports, insults, and patronage back to:
|
|
Jonathan Rosenbaum <freesource@users.sourceforge.net>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|