Make e2fsprogs optional (and off by default)
[genkernel.git] / README
1 # $Id$
2
3 DEPENDENCIES:
4   - GCC and binutils
5   - GNU Bash
6   - PaX Utilities
7
8 USAGE:
9   See http://www.gentoo.org/doc/en/genkernel.xml or
10   issue ``genkernel --help''.
11
12 PORTING:
13   To port to other arches:
14
15   # cd /usr/share/genkernel
16   # cp -Rp x86 ${myarch}
17   # mkdir /usr/share/genkernel/pkg/${myarch}
18
19   Modify what is needed in the /usr/share/genkernel/${myarch}
20   directory, as well making a generic kernel-config.
21
22 IMPORTANT KERNEL NOTES:
23   - You MUST have /dev/pts turned on.
24     "Block devices->Loopback device support"  
25     "Block devices->RAM disk support"
26   - To boot genkernel properly, the kernel config must have
27     RAM disk support and Initial RAM disk support. You should
28     also set your "Default RAM disk size to 8192"
29
30 BOOTING A KERNEL WITH INITRD:
31
32   GRUB:
33     real_root=  needs to point to your root partition
34     root=       needs to point to the ramdisk (should stay at /dev/ram0)
35     init=       needs to point to the linuxrc file to execute on the ramdisk
36     vga=        should be the resolution you want your screen. 0x317 is
37                 1024x768 - 16bpp and you'll get a pretty splash if
38                 configured properly
39
40   GRUB EXAMPLE ENTRY:
41     title=2.6.0 [ Genkernel ]
42     root (hd0,0)
43     kernel (hd0,0)/boot/kernel-2.6.0-gentoo root=/dev/ram0 init=/linuxrc real_root=/dev/hda3 vga=0x317
44     initrd (hd0,0)/boot/initrd-2.6.0-gentoo