NAME
    rpmbootstrap - creates a chrooted RPM based distribution a la debootstrap,
    aka Virtual Environment (VE)

DESCRIPTION
    rpmbootstrap creates a chroot environment (Virtual Environment or VE) with
    a minimal distribution in it, suited for building packages for example.
    It's very much like debootstrap but for RPM based distribution. It aims at
    supporting all distributions supported by project-builder.org (RHEL, RH,
    Fedora, OpeSUSE, SLES, Mandriva, ...)

    It is inspired by work done by Steve Kemp for rinse
    (http://www.steve.org.uk/), and similar to mock, but fully integrated with
    project-builder.org (which also supports rinse and mock).

SYNOPSIS
    rpmbootstrap [-vhmqpdk][-s script][-i iso][-a pkg1[,pkg2,...]]
    distribution-version-arch [target-dir] [mirror [script]]

    rpmbootstrap
    [--verbose][--help][--man][--quiet][--print-rpms][--download-only]
    [--keep][--script script][--iso iso][--add pkg1,[pkg2,...]]
    distribution-version-arch [target-dir] [mirror [script]]

OPTIONS
    -v|--verbose
        Print a brief help message and exits.

    -h|--help
        Print a brief help message and exits.

    --man
        Prints the manual page and exits.

    -q|--quiet
        Do not print any output.

    -p|--print-rpms
        Print the packages to be installed, and exit. Note that a target
        directory must be specified so rpmbootstrap can determine which
        packages should be installed, and to resolve dependencies. The target
        directory will be deleted.

    -d|--download-only
        Download packages, but don't perform installation.

    -k|--keep
        Keep packages in the cache dir for later reuse. By default remove
        them.

    -s|--script script
        Name of the script you want to execute on the related VEs after the
        installation. It is executed in host environment. You can use the
        chroot command to execute actions in the VE.

    -i|--iso iso_image
        Name of the ISO image of the distribution you want to install on the
        related VE.

    -a|--add pkg1[,pkg2,...]
        Additional packages to add from the distribution you want to install
        on the related VE at the end of the chroot build.

ARGUMENTS
    distribution-version-arch
        Full name of the distribution that needs to be installed in the VE.
        E.g. fedora-11-x86_64.

    target-dir
        This is the target directory under which the VE will be created.
        Created on the fly if needed. If none is given use the default
        directory hosting VE for project-builder.org (Cf: vepath parameter in
        $HOME/.pbrc)

EXAMPLE
    To setup a Fedora 12 distribution with an i386 architecture issue:

    rpmbootstrap fedora-12-i386 /tmp/fedora/12/i386

WEB SITES
    The main Web site of the project is available at
    <http://www.project-builder.org/>. Bug reports should be filled using the
    trac instance of the project at <http://trac.project-builder.org/>.

USER MAILING LIST
    Cf: <http://www.mondorescue.org/sympa/info/pb-announce> for announces and
    <http://www.mondorescue.org/sympa/info/pb-devel> for the development of
    the pb project.

CONFIGURATION FILE
    Uses Project-Builder.org configuration file (/etc/pb/pb.conf or
    /usr/local/etc/pb/pb.conf)

AUTHORS
    The Project-Builder.org team <http://trac.project-builder.org/> lead by
    Bruno Cornec <mailto:bruno@project-builder.org>.

COPYRIGHT
    Project-Builder.org is distributed under the GPL v2.0 license described in
    the file "COPYING" included with the distribution.