mirror of
				https://github.com/fspc/gbootroot.git
				synced 2025-11-03 16:05:34 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			128 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			128 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
Program:  gBootRoot  pronounced "bOOtrOOt"
 | 
						|
License:  GNU General Public License
 | 
						|
 | 
						|
The Makefile included with this source package doesn't attempt
 | 
						|
to figure out whether your system has the proper requirements.
 | 
						|
It may seem like a great idea to have a configure script, but
 | 
						|
these things can fail, besides gbootroot is a program designed for users
 | 
						|
who intend to build distributions and boot disks, so understanding what
 | 
						|
things are required to get gbootroot to work completely can be quite 
 | 
						|
beneficial.  At the very least, do a "make", and try gbootroot because the 
 | 
						|
program will tell you what things are missing - hopefully nothing - and then 
 | 
						|
you can refer to this README for help.
 | 
						|
 | 
						|
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
 | 
						|
--------
 | 
						|
 | 
						|
Version 0.7002 or greater.
 | 
						|
http://freshmeat.net/projects/gtk-perl
 | 
						|
 | 
						|
 | 
						|
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:
 | 
						|
#########################
 | 
						|
 | 
						|
"chmod 4755 /usr/bin/uml_net" so normal users can have network capabilities.
 | 
						|
 | 
						|
 | 
						|
Documentation:
 | 
						|
#############
 | 
						|
 | 
						|
Documentaion and FAQ is 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>
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 |