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.