modules.d/50gensplash/README

   1 dracut gensplash module
   2 -----------------------
   3
   4 INDEX
   5
   6 0. Introduction
   7 1. Hostonly vs Generic
   8 2. Configuration and kernel parameters
   9
  10 ~
  11
  12 0. Introduction
  13
  14 gensplash is based on Genkernel code and that's why it's Gentoo-specific.  It
  15 requires splashutils to work.  To set up theme you may edit /etc/conf.d/splash
  16 or set DRACUT_GENSPLASH_THEME and DRACUT_GENSPLASH_RES variables.  Your theme
  17 has to exist in /etc/splash and for every given resolution has to exist config
  18 in theme's directory, e.g. there's 1024x768.cfg in /etc/splash/natural_gentoo.
  19 List of resolutions is comma-separated.
  20
  21 NOTE: The module will be rewritten to be distro-neutral. Its name will change
  22 to fbsplash.
  23
  24
  25 1. Hostonly vs Generic
  26
  27 All available themes are installed only if no --hostonly is specified and no
  28 DRACUT_GENSPLASH_THEME and DRACUT_GENSPLASH_RES are set.  Otherwise those vars
  29 are checked and if not set then config /etc/conf.d/splash is read.
  30
  31
  32 2. Configuration and kernel parameters
  33
  34 Example set up by environment variables:
  35     DRACUT_GENSPLASH_THEME=natural_gentoo
  36     DRACUT_GENSPLASH_RES=1024x768,1024x600
  37
  38 Example kernel arguments:
  39     splash=silent,theme:natural_gentoo console=tty1 quiet
  40
  41 You may easily set up the module using Genkernel with arguments:
  42     --gensplash=<theme>:<res1>,<res2>,...