Section: System configuration (1)Updated: July 2008Local indexUp
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, --archiveFILE|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.
--version
Show gfxboot version.
--help
Print usage.
Switching themes
--new-theme THEME
Activate THEME. Theme files are stored in /etc/bootsplash/themes/THEME/bootloader.
--update-theme THEME
Activate THEME but keep language settings from current gfxboot archive.
Delete gfxboot config options. If sections are omitted, section "base" is used.
--rm-section SECTION1SECTION2 ...
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 LANG1LANG2 ...
Add translation files.
--rm-languages LANG1LANG2 ...
Remove translation files.
--config-fileFILE
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, --bootloaderBOOTLOADER
Use BOOTLOADER (grub, lilo, isolinux, syslinux, pxelinux) for preview.
-m, --vmVM
Use virtual machine VM (bochs, qemu, qemu32, qemu64, vbox, vbox64, vmplayer, vmware) for preview.
--grubDIRECTORY|RPM
Use grub from DIRECTORY or RPM (default is /).
--liloDIRECTORY|RPM
Use lilo from DIRECTORY or RPM (default is /).
--syslinuxDIRECTORY|RPM
Use syslinux from DIRECTORY or RPM (default is /).
--isolinuxDIRECTORY|RPM
Use isolinux from DIRECTORY or RPM (default is /).
--pxelinuxDIRECTORY|RPM
Use pxelinux from DIRECTORY or RPM (default is /).
--passwordPASSWORD
Create test config with PASSWORD for preview.
--32
Create 32 bit test image.
--64
Create 64 bit test image.
--biarch
Create biarch test image (same as using --32 and --64).
--cdrom, --dvd
Create iso image for preview.
--disk
Create harddisk image for preview.
--floppy
Create floppy image for preview.
--net
Create tftp directory for preview.
--save-imageFILE
Copy preview image to FILE.
--test-add-filesFILE1FILE2 ...
Add files to test directory.
--test-rm-filesFILE1FILE2 ...
Delete files from test directory.
Adding/removing files from gfxboot archive
--ls, --list-files
List gfxboot archive files.
--add-filesFILE1FILE2 ...
Add files to gfxboot archive.
--rm-filesFILE1FILE2 ...
Delete files from gfxboot archive.
--extract-filesFILE1FILE2 ...
Copy files from gfxboot archive to current working directory.
--show-fileFILE
Print FILE.
--expand-archiveDIRECTORY
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, syslinux, or pxelinux.
--pack-archiveFILE
Pack all gfxboot files into cpio archive FILE.
Modifying help files
--help-showFILE
Print FILE (internal help file format) as HTML.
--help-createFILE
Convert HTML files passed as ARGS to FILE (internal format).
--used-pagesLINK1LINK2 ...
Mark pages as referenced.
--naviFILE
Use FILE as template for navigation links.
--defineENTITY1=VALUE1ENTITY2=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.