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   - From gentoo-dev-sources-2.6.8 and above, bootsplash has been replaced
  25     with gensplash.  Gensplash has the same kernel configuration requirements
  26     as bootsplash, but works properly with any framebuffer device.
  27   - To build a kernel with Genkernel you must have
  28     "Block devices->Loopback device support"
  29     "Block devices->RAM disk support"
  30   - To boot genkernel properly, the kernel config must have
  31     RAM disk support and Initial RAM disk support. You should
  32     also set your "Default RAM disk size to 8192"
  33
  34 BOOTING A KERNEL WITH INITRD:
  35
  36   GRUB:
  37     real_root=  needs to point to your root partition
  38     root=       needs to point to the ramdisk (should stay at /dev/ram0)
  39     init=       needs to point to the linuxrc file to execute on the ramdisk
  40     vga=        should be the resolution you want your screen. 0x317 is
  41                 1024x768 - 16bpp and you'll get a pretty bootsplash if
  42                 configured properly
  43
  44   GRUB EXAMPLE ENTRY:
  45     title=2.6.0 [ Genkernel ]
  46     root (hd0,0)
  47     kernel (hd0,0)/boot/kernel-2.6.0-gentoo root=/dev/ram0 init=/linuxrc real_root=/dev/hda3 vga=0x317
  48     initrd (hd0,0)/boot/initrd-2.6.0-gentoo