revisor

Langue: en

Version: Fedora Unity Project (fedora - 06/07/09)

Section: 8 (Commandes administrateur)

NAME

revisor - Fedora compose and customize tool

SYNOPSIS

revisor [options]

DESCRIPTION

Revisor is a customization program for Fedora, CentOS and other Red Hat-based distribution deriatives.

OPTIONS

The options below, if specified on the CLI, will override any global and model options specified in the configuration file(s) loaded.

-h, --help show a help message and exit

Runtime Options:

--cli
    Force Revisor to run in CLI mode. (see also 'Running in CLI or in GUI mode')

--gui
    Force Revisor to run in GUI mode. Does not fallback to CLI and thus shows GUI related errors. (see also 'Running in CLI or in GUI mode')

--list-models
    List available models. This lists the available models from a Revisor configuration file. See also revisor.conf(5).

--debug [level]
    Enable debugging level. The level runs from 0 (high-level messages) to 9 (very, very low-level messages).

--yes
    Answer 'yes' to all questions.

Configuration Options:

--kickstart=[kickstart file]
    Use kickstart file

--kickstart-save=[file name]
    Save options to given file (as a kickstart)

--config=[config file]
    Revisor configuration file to use

--source
    Get the sources to go with the binaries

--destination-directory=[directory]
    Destination directory for products

--working-directory=[directory]
    Working directory

--model=[model]
    Model to use for composing. Use --list-models to get a list of models.

--respin
    Mode to use for composing updated spins

Installation Media Options:

--install-cd
    Create Installation Media CDs

--install-dvd
    Create Installation Media DVDs

--install-unified
    Create Unified ISO from install tree

--install-dvd-dl
    Create Installation Media Dual-Layered DVDs

--install-raw
    Build raw HDD install image.

--install-tree
    Build install tree.

--kickstart-include
    Include kickstart file on media

--kickstart-default
    Set kickstart to boot by default

--revisor-comps
    Use Revisor's comps file instead of the repositories.

--updates-img=[updates image]
    Include specified updates.img on installation media.

Live Media Options:

--live-optical
    Create Live Media CD/DVD

--live-usb-thumb
    Create Live Media Thumb Drive Image

--live-usb-hd
    Create Live Media Hard Disk Image

--live-raw
    Create Live Media Raw Hard Disk Image

--live-shell
    Interactively work in the live image before building the ISO image.

--skip-compression
    Skip file system compression.

--skip-prelink
    Skip prelinking the contents of the filesystem.

--ignore-deleted
    Ignore filesystem overhead. Useless blocks will not be removed from the filesystem.

--preferred-kernel
    Set the preferred kernel. One of normal, PAE, xen or debug.

Virtualization Media Options (Available with revisor-modvirt):

--virt-xen=[guest name]
    Build Xen virtual machine. (not implemented yet)

--virt-xen-size=[drive size in MB]
    Xen virtual machine drive size, in MB. (Default: 3000MB) (not implemented yet)

--virt-kvm=[guest name]
    Build KVM virtual machine. (not implemented yet)

--virt-kvm-size=[drive size in MB]
    KVM virtual machine drive size, in MB. (Default: 3000MB) (not implemented yet)

--virt-fstype=[filesystem type]
    Virtual machine file system type. (Default: ext3) (not implemented yet)

--virt-sparse
    Make virtual machine drive a sparse filesystem. (not implemented yet)

--virt-stateless
    Make virtual machine stateless (changes do not persist.) (not implemented yet)

--virt-appliance
    Build virtual machine as an appliance using a simple raw drive image and yum. (Doesn't require virt. tech. to be running locally.) (not implemented yet)

Cobbler Options (Available with revisor-modcobbler):

--cobbler-add=[name]
    Add compose to a Cobbler server as both a Distribution and Profile.

--cobbler-add-profile=[profile-name]
    Add compose options as a Profile to a Cobbler server. Requires --cobbler-use-distro to be specified as well.

--cobbler-use-distro=[distro-name]
    Use a Cobbler distro as source for packages.

--cobbler-use-profile=[profile-name]
    Use a Cobbler profile as source for kickstart data.

--cobbler-list
    List options provided by cobbler.

--cobbler-server=[server-address]
    Use remote cobbler server.

Delta Options (Available with revisor-moddelta):

--delta=[old-iso-image]
    Generate a delta ISO image. Currently only valid for a single disc or directory holding Installation Media ISOs named exactly the same as the product.

Jigdo Options (Available with revisor-modjigdo):

--mirror-directory=[directory]
    Use this directory as the base.

Running in CLI or in GUI mode

The --cli and --gui options are particularly useful when debugging. When running Revisor on a server with X11Forwarding enabled, you might want to force CLI mode with --cli while if you are troubleshooting the GUI you force Revisor to run in GUI mode by specifying --gui.

Revisor will (always) first attempt to start in GUI mode. If that fails because of some reason, Revisor falls back to running in CLI mode unless of course --gui had been specified on the command line. Possible reasons to fail starting in GUI mode include:


    - Display environment variable not set.
    - Connection to display refused.
    - Package revisor-modgui not installed.
    - Cannot open display (Also known as 'Cannot import gtk')

Modules in Revisor

Revisor by has a number of modules available:


    - revisor-cobbler
        Some detailed plugin description here


    - revisor-delta
        Some detailed plugin description here


    - revisor-gui
        Some detailed plugin description here


    - revisor-jigdo
        Some detailed plugin description here


    - revisor-virt
        Some detailed plugin description here

SEE ALSO

pungi(8), livecd-creator(8), cobbler(8), jigdo(1)