mirror of
https://github.com/fspc/gbootroot.git
synced 2025-11-04 00:05:35 -05:00
147 lines
4.6 KiB
Plaintext
147 lines
4.6 KiB
Plaintext
Program: gBootRoot pronounced "bOOtrOOt"
|
|
License: GNU General Public License
|
|
|
|
The Makefile included with this source package doesn't figure out whether
|
|
your installation has the proper requirements. However, it isn't difficult to
|
|
understand what is necessary to get gbootroot to work. First type "make",
|
|
follow the instructions in the "Important Configurations" section near the
|
|
bottom of this page, and then run gbootroot. The program will indicate to you
|
|
whether anything is missing. If it doesn't work at all, it's generally due to
|
|
not having gtk-perl installed. If the user-mode-linux kernel doesn't work, it
|
|
may be an architecture issue. If you need to customize the kernel, there are
|
|
general directions in the README. 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.
|
|
|
|
Out of the box this program works with the i386 architecture, for other
|
|
architectures genext2fs and user-mode-linux will need to be compiled if
|
|
full functionality is desired. Eventually, the Advanced Kernel Section in
|
|
this program will be able to help with the uml compile.
|
|
|
|
|
|
Perl Modules:
|
|
#############
|
|
|
|
Gtk-Perl (Required)
|
|
--------
|
|
|
|
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
|
|
|
|
IO::Stty
|
|
--------
|
|
http://www.perl.com/CPAN/modules/by-module/IO/IO-Stty-.02.tar.gz
|
|
|
|
IO::Tty
|
|
-------
|
|
http://www.perl.com/CPAN/modules/by-module/IO/IO-Tty-0.04.tar.gz
|
|
http://sourceforge.net/projects/expectperl
|
|
|
|
Binaries:
|
|
#########
|
|
|
|
Genext2fs
|
|
---------
|
|
genext2fs/genext2fs ( included and already compiled for i386 )
|
|
cd genext2fs; make ( other architectures )
|
|
|
|
User-Mode-Linux
|
|
---------------
|
|
user-mode-linux/usr/bin/{linux,uml_*} ( included and already compiled
|
|
for i386 )
|
|
user-mode-linux/usr/lib/uml/{modules*tar} ( included and already compiled
|
|
for i386 )
|
|
user-mode-linux/usr/lib/uml/config ( kernel .config defaults )
|
|
|
|
If you use a different architecture you will need to read
|
|
http://user-mode-linux.sourceforge.net/arch-port.html.
|
|
|
|
Here the basic instructions to compile uml stuff:
|
|
|
|
Get kernel sources from www.kernel.org, and then a matching uml-patch from
|
|
http://sourceforge.net/project/showfiles.php?group_id=429. If you want to
|
|
match the kernel version used by gbootroot check Changes to find out which
|
|
version of uml if being used. You may want to use config as your .config at
|
|
the base of the sources as a starting point, and then modify the kernel
|
|
configuration in whatever way required. There are good instructions on how to
|
|
compile a uml kernel at http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO-2.html.
|
|
Then put the uml kernel in the directory cited above and call it linux; you can
|
|
put the modules in a Replacements directory later on (see FAQ).
|
|
|
|
The helper uml_* tools need to be checked out from cvs and compiled with make:
|
|
|
|
(Instructions for cvs at http://sourceforge.net/cvs/?group_id=429.)
|
|
cvs -d:pserver:anonymous@cvs.user-mode-linux.sourceforge.net:/cvsroot/user-mode-linux login
|
|
cvs -z3 -d:pserver:anonymous@cvs.user-mode-linux.sourceforge.net:/cvsroot/user-mode-linux co tools
|
|
|
|
cd tools/mconsole; make;
|
|
cd ../uml_net; make; chown 0:0 uml_net; chmod 4755 uml_net;
|
|
cd ../uml_router; make;
|
|
cd ../uml_moo; make;
|
|
|
|
Put the uml kernel in the directory cited above with the same names. When
|
|
you run gbootroot's Makefile everything will be put in the proper places.
|
|
|
|
Note: Please send the user-mode-linux-devel and gbootroot-devel lists your
|
|
experiences if you successfully get another architecture working so they can
|
|
be shared with the community.
|
|
|
|
|
|
Boot Methods:
|
|
#############
|
|
|
|
2 disk compression
|
|
------------------
|
|
|
|
This method will tell you when any of these utilities are missing:
|
|
|
|
ash lilo bzip2 file
|
|
|
|
|
|
Root Methods:
|
|
#############
|
|
|
|
Yard
|
|
----
|
|
|
|
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.
|
|
|
|
|
|
Documentation:
|
|
#############
|
|
|
|
Documentaion 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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|