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