Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14857 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GFXBOOT(8)		     System configuration		    GFXBOOT(8)

NAME
       gfxboot - graphical boot screen test and config tool

SYNOPSIS
       gfxboot [ OPTIONS ] ARGS

DESCRIPTION
       gfxboot modifies and tests graphical boot loader configuration.

OPTIONS
   General options
       -a, --archive FILE|DIRECTORY
	      Use  FILE	 as gfxboot archive (default is /boot/message).	 If it
	      points to a directory, assume it is  an  expanded	 archive  (see
	      --expand-archive option below).

       -v, --verbose
	      Increase verbosity.

       --save-temp
	      Keep temporary files.

       --help Print usage.

   Switching themes
       --new-theme THEME
	      Activate	 THEME.	  Theme	  files	  are	stored	in  /etc/boot‐
	      splash/themes/THEME/bootloader.

       --update-theme THEME
	      Activate THEME but keep language settings from  current  gfxboot
	      archive.

   Changing gfxboot config
       --show-config
	      Show gfxboot config file (gfxboot.cfg).

       --change-config [SECTION1::]OPTION1=FOO1 [SECTION2::]OPTION2=FOO2 ...
	      Change  gfxboot config options. If sections are omitted, section
	      "base" is used.

       --rm-config [SECTION1::]OPTION1 [SECTION2::]OPTION2 ...
	      Delete gfxboot config options. If sections are omitted,  section
	      "base" is used.

       --rm-section SECTION1 SECTION2 ...
	      Delete sections in gfxboot config file.

       --default-language LANG
	      Make  LANG  the  default language. LANG is a locale string (e.g.
	      en_US).

       --add-languages LANG1 LANG2 ...
	      Add translation files.

       --rm-languages LANG1 LANG2 ...
	      Remove translation files.

       --config-file FILE
	      Don't work on gfxboot.cfg from  gfxboot  archive	but  on	 FILE.
	      NOTE: FILE will be modified even with "--test".

   Preview/test gfxboot setup
       -p, --preview
	      Try current config (needs some virtual machine).

       -t, --test
	      Test only (don't actually change any files).

       -b, --bootloader BOOTLOADER
	      Use BOOTLOADER (grub, lilo, isolinux, syslinux) for preview.

       -m, --vm VM
	      Use  virtual  machine  VM	 (bochs, qemu, qemu-i386, qemu-x86_64,
	      vbox, vboxsdl, vmplayer, vmware) for preview.

       --grub DIRECTORY|RPM
	      Use grub from DIRECTORY or RPM (default is /).

       --lilo DIRECTORY|RPM
	      Use lilo from DIRECTORY or RPM (default is /).

       --syslinux DIRECTORY|RPM
	      Use syslinux from DIRECTORY or RPM (default is /).

       --isolinux DIRECTORY|RPM
	      Use isolinux from DIRECTORY or RPM (default is /).

       --password PASSWORD
	      Create test config with PASSWORD for preview.

       --biarch
	      Create biarch test image.

       --cdrom, --dvd
	      Create iso image for preview.

       --disk Create harddisk image for preview.

       --floppy
	      Create floppy image for preview.

       --save-image FILE
	      Copy preview image to FILE.

   Adding/removing files from gfxboot archive
       --ls, --list-files
	      List gfxboot archive files.

       --add-files FILE1 FILE2 ...
	      Add files to gfxboot archive.

       --extract-files FILE1 FILE2 ...
	      Copy files from gfxboot archive to current working directory.

       --show-file FILE
	      Print FILE.

       --expand-archive DIRECTORY
	      Create expanded gfxboot archive version in DIRECTORY.  That  is,
	      only  files  that	 cannot	 be read directly from file system are
	      kept in a cpio archive. All others are unpacked.	Use  only  for
	      isolinux and syslinux.

       --pack-archive FILE
	      Pack all gfxboot files into cpio archive FILE.

   Modifying help files
       --help-show FILE
	      Print FILE (internal help file format) as HTML.

       --help-create FILE
	      Convert HTML files passed as ARGS to FILE (internal format).

       --used-pages LINK1 LINK2 ...
	      Mark pages as referenced.

       --navi FILE
	      Use FILE as template for navigation links.

       --define ENTITY1=VALUE1 ENTITY2=VALUE2 ...
	      Define ENTITYx with VALUEx.

FILES
       /boot/message	 bootloader graphics archive (actually a cpio achive)

       /etc/bootsplash/themes
			 theme directory

       /etc/sysconfig/bootsplash
			 default theme

BUGS
       None.

AUTHOR
       Written by Steffen Winterfeldt.

SEE ALSO
       If you want to create your own theme look at the gfxboot-devel package.

gfxboot				   July 2008			    GFXBOOT(8)

Vote for polarhome