GFXBOOT(1)

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.

--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.

  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, pxelinux) for preview.

-m, --vm VM
    Use virtual machine VM (bochs, qemu, qemu32, qemu64, vbox, vbox64, 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 /).

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

--password PASSWORD
    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-image FILE
    Copy preview image to FILE.

--test-add-files FILE1 FILE2 ...
    Add files to test directory.

--test-rm-files FILE1 FILE2 ...
    Delete files from test directory.

  Adding/removing files from gfxboot archive

--ls, --list-files
    List gfxboot archive files.

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

--rm-files FILE1 FILE2 ...
    Delete files from 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, syslinux, or pxelinux.

--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.