MAN page from OpenSuSE pbmkbm-0.15.2-1.opensuse15.1.noarch.rpm
Section: User Contributed Perl Documentation (1)
pbmkbm - a project-builder.org utility to make boot media
pbmkbm creates a bootable media (CD/DVD, USB
device, Network, tape, ...)with a minimal distribution in it, suited for building packages for example. It aims at supporting all distributions supported by project-builder.org (RHEL, RH,
Fedora, OpeSUSE, SLES,
It is inspired by work done by Jean-Marc André around the HP SSSTK and aim at replacing the mindi project (http://www.mondorescue.org), but fully integrated with project-builder.org
pbmkbm works in different phases. The first one is to check all
pbmkbm needs to gather a certain number of components that could come from various sources and could be put on a different target media.We need a kernel, an initrd/initramfs for additional modules and init script,a root filesystem and a boot configuration file.Kernel, modules could come either from the local installed system (typically for disaster recovery context) or from a kernel package of a given configuration or a referenced content.Utilities could come from busybox, local utilities or set of packages.The root filesystem is made with them. The initrd/initramfs could be made internaly or by calling dracut.The boot config file is generated from analysis content or provided externally.
pbmkbm [-vhq][-t boot-type [-d device]][-b boot-method][-m os-ver-arch][-s script][-a pkg1[,pkg2,...]] [target-dir]
pbmkbm [--verbose][--help][--man][--quiet][--type boot-type [--device device]][--machine os-ver-arch][--boot boot-method][--script script][--add pkg1,[pkg2,...]] [target-dir]
- Print a brief help message and exits.
- Print a brief help message and exits.
- Prints the manual page and exits.
- Do not print any output.
- -t|--type boot-type
- Type of the boot device to generate. A boot-type can be:
- Generate an ISO9660 image format (suitable to be burned later on or loopback mounted. Uses isolinux.
- Generate a USB image format (typically a key of external hard drive). Uses syslinux.
- Generate a PXE environement (suitable to be integrated in a PXElinux configuration). Uses pxelinux.
- -d|--device device-file
- Name of the device or file on which you want to create the boot media.
- -b|--boot boot-method
- This is the boot method to use to create the boot media. A boot-method can be:
- Use the tools of the native distribution to create the boot media. No other dependency.
- Use the project-builder.org virtual environment notion to create the boot media. No other dependency outside of the project.
- Use the busybox tool to create the boot media. Cf: <http://www.busybox.net>
- Use the dracut tool to create the boot media. Cf: <http://www.dracut.net>
- -s|--script script
- Name of the script you want to execute on the related boot media at the end of the build.
- -a|--add pkg1[,pkg2,...]
- Additional packages to add from the distribution you want to install on the related boot media at the end of the build.
- -m|--machine os-ver-arch
- This is the target tuple operating system-version-architecture for which you want to create the boot media.
target-dir is the directory under which the boot media will be build.
To setup a USB
busybox based boot media on the /dev/sdb device for a Fedora 12 distribution with an i386 architecture issue:
pbmkbm -t usb -d /dev/sdb -m fedora-12-i386 -b busybox
To setup an ISO image under /tmp for a RHEL 6 x86_64 distribution issue using the native environment:
pbmkbm -t iso -d /tmp -m rhel-6-x86_64 -b ve
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
> for announces and <http://www.mondorescue.org/sympa/info/pb-devel
> for the development of the pb project.
Uses Project-Builder.org configuration file (/etc/pb/pb.yml or /usr/local/etc/pb/pb.yml)
The Project-Builder.org team <http://trac.project-builder.org/
> lead by Bruno Cornec <mailto:brunoAATTproject-builder.org>.
Project-Builder.org is distributed under the GPL
v2.0 licensedescribed in the file "COPYING"
included with the distribution.
Hey! The above document had some coding errors, which are explained below:
- Around line 45:
- Non-ASCII character seen before =encoding in 'André'. Assuming UTF-8
- WEB SITES
- USER MAILING LIST
- CONFIGURATION FILE
- POD ERRORS
This document was created byman2html,using the manual pages.