diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/rpmbuild.8 | 245 |
1 files changed, 245 insertions, 0 deletions
diff --git a/doc/rpmbuild.8 b/doc/rpmbuild.8 new file mode 100644 index 000000000..555392910 --- /dev/null +++ b/doc/rpmbuild.8 @@ -0,0 +1,245 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "RPMBUILD" "8" "06 June 2001" "Red Hat, Inc." "Red Hat Linux" +.SH NAME +rpmbuild \- Build RPM Package(s) +.SH SYNOPSIS +.SS "BUILDING PACKAGES:" +.PP + +\fBrpmbuild\fR {\fB-ba|-bb|-bp|-bc|-bi|-bl|-bs\fR} [\fBrpmbuild-options\fR] \fB\fISPECFILE\fB\fR\fI ...\fR + +\fBrpmbuild\fR {\fB-ta|-tb|-tp|-tc|-ti|-tl|-ts\fR} [\fBrpmbuild-options\fR] \fB\fITARBALL\fB\fR\fI ...\fR + +\fBrpmbuild\fR {\fB--rebuild|--recompile\fR} \fB\fISOURCEPKG\fB\fR\fI ...\fR + +\fBrpmbuild\fR \fB--tarbuild\fR \fB\fITARBALL\fB\fR\fI ...\fR +.SS "MISCELLANEOUS:" +.PP + +\fBrpmbuild\fR {\fB--showrc\fR} +.SS "RPMBUILD-OPTIONS" +.PP + +\fB[--buildroot \fIDIRECTORY\fB] [--clean] [--nobuild] [--rmsource] [--rmspec] +[--short-circuit] [--sign] [--target \fIPLATFORM\fB]\fR +.SH "DESCRIPTION" +.PP +\fBrpmbuild\fR is used to build both binary and source software packages. +A \fBpackage\fR consists of an archive of files and +meta-data used to install and erase the archive files. The meta-data +includes helper scripts, file attributes, and descriptive information +about the package. +\fBPackages\fR come in two varieties: binary packages, +used to encapsulate software to be installed, and source packages, +containing the source code and recipe necessary to produce binary +packages. +.PP +One of the following basic modes must be selected: +\fBBuild Package\fR, +\fBBuild Package from Tarball\fR, +\fBRecompile Package\fR, +\fBShow Configuration\fR. +.SS "GENERAL OPTIONS" +.PP +These options can be used in all the different modes. +.TP +\fB-?, --help\fR +Print a longer usage message then normal. +.TP +\fB--version\fR +Print a single line containing the version number of \fBrpm\fR +being used. +.TP +\fB--quiet\fR +Print as little as possible - normally only error messages will +be displayed. +.TP +\fB-v\fR +Print verbose information - normally routine progress messages will be +displayed. +.TP +\fB-vv\fR +Print lots of ugly debugging information. +.TP +\fB--rcfile \fIFILELIST\fB\fR +Each of the files in the colon separated +\fIFILELIST\fR +is read sequentially by \fBrpm\fR for configuration +information. +Only the first file in the list must exist, and tildes will be +expanded to the value of \fB$HOME\fR. +The default \fIFILELIST\fR is +\fI/usr/lib/rpm/rpmrc\fR:\fI/etc/rpmrc\fR:\fI~/.rpmrc\fR. +.TP +\fB--pipe \fICMD\fB\fR +Pipes the output of \fBrpm\fR to the command \fICMD\fR. +.TP +\fB--dbpath \fIDIRECTORY\fB\fR +Use the database in \fIDIRECTORY\fR rathen +than the default path \fI/var/lib/rpm\fR +.TP +\fB--root \fIDIRECTORY\fB\fR +Use the system rooted at \fIDIRECTORY\fR for all operations. +Note that this means the database will be read or modified under +\fIDIRECTORY\fR and any +\fB%pre\fR or +\fB%post\fR +scriptlet(s) are run after a chroot(2) to +\fIDIRECTORY\fR. +.SS "BUILD OPTIONS" +.PP +The general form of an rpm build command is +.PP +\fBrpmbuild\fR {\fB-b\fISTAGE\fB|-t\fISTAGE\fB\fR} [\fBrpmbuild-options\fR] \fB\fIFILE\fB\fR\fI ...\fR +.PP +The argument used is \fB-b\fR if a spec file is being +used to build the package and \fB-t\fR if \fBrpmbuild\fR +should look inside of a (possibly compressed) tar file for +the spec file to use. After the first argument, the next +character (\fISTAGE\fR) specifies the stages +of building and packaging to be done and is one of: +.TP +\fB-ba\fR +Build binary and source packages (after doing the %prep, %build, and +%install stages). +.TP +\fB-bb\fR +Build a binary package (after doing the %prep, %build, and %install +stages). +.TP +\fB-bp\fR +Executes the "%prep" stage from the spec file. Normally this +involves unpacking the sources and applying any patches. +.TP +\fB-bc\fR +Do the "%build" stage from the spec file (after doing the %prep stage). +This generally involves the equivalent of a "make". +.TP +\fB-bi\fR +Do the "%install" stage from the spec file (after doing the %prep and +%build stages). This generally involves the equivalent of a +"make install". +.TP +\fB-bl\fR +Do a "list check". The "%files" section from the spec file is +macro expanded, and checks are made to verify that each file +exists. +.TP +\fB-bs\fR +Build just the source package. +.PP +The following options may also be used: +.TP +\fB--buildroot \fIDIRECTORY\fB\fR +When building a package, override the BuildRoot tag with directory +\fIDIRECTORY\fR. +.TP +\fB--clean\fR +Remove the build tree after the packages are made. +.TP +\fB--nobuild\fR +Do not execute any build stages. Useful for testing out spec files. +.TP +\fB--rmsource\fR +Remove the sources after the build (may also be +used standalone, e.g. "\fBrpmbuild\fR \fB--rmsource foo.spec\fR"). +.TP +\fB--rmspec\fR +Remove the spec file after the build (may also be +used standalone, eg. "\fBrpmbuild\fR \fB--rmspec foo.spec\fR"). +.TP +\fB--short-circuit\fR +Skip straight to specified stage (i.e., skip all stages leading +up to the specified stage). Only valid with \fB-bc\fR +and \fB-bi\fR. +.TP +\fB--sign\fR +Embed a GPG signature in the package. This signature can be used +to verify the integrity and the origin of the package. See the +section on GPG SIGNATURES for configuration details. +.TP +\fB--target \fIPLATFORM\fB\fR +When building the package, interpret \fIPLATFORM\fR +as \fBarch-vendor-os\fR and set the macros +\fB%_target\fR, +\fB%_target_arch\fR, and +\fB%_target_os\fR +accordingly. +.SS "REBUILD AND RECOMPILE OPTIONS" +.PP +There are two other ways to invoke building with rpm: +.PP +\fBrpmbuild\fR {\fB--rebuild|--recompile\fR} \fB\fISOURCEPKG\fB\fR\fI ...\fR +.PP +When invoked this way, \fBrpmbuild\fR installs the named source +package, and does a prep, compile and install. In addition, +\fB--rebuild\fR builds a new binary package. When the build +has completed, the build directory is removed (as in +\fB--clean\fR) and the the sources and spec file for +the package are removed. +.SS "SHOWRC" +.PP +The command +.PP +\fBrpmbuild\fR \fB--showrc\fR +.PP +shows the values \fBrpmbuild\fR will use for all of the +options are currently set in +\fIrpmrc\fR and +\fImacros\fR +configuration file(s). +.SH "FILES" +.PP + +\fI/usr/lib/rpm/rpmrc\fR + +\fI/etc/rpmrc\fR + +\fI~/.rpmrc\fR + +\fI/usr/lib/rpm/macros\fR + +\fI/etc/rpm/macros\fR + +\fI~/.rpmmacros\fR + +\fI/var/lib/rpm/Conflictname\fR + +\fI/var/lib/rpm/Basenames\fR + +\fI/var/lib/rpm/Group\fR + +\fI/var/lib/rpm/Name\fR + +\fI/var/lib/rpm/Packages\fR + +\fI/var/lib/rpm/Providename\fR + +\fI/var/lib/rpm/Requirename\fR + +\fI/var/lib/rpm/Triggername\fR + +\fI/var/tmp/rpm*\fR +.SH "SEE ALSO" + +\fBpopt\fR(3), + +\fBrpm2cpio\fR(8), + +\fBgendiff\fR(1), + +\fBrpm\fR(8), + +\fB http://www.rpm.org/ <URL:http://www.rpm.org/> +\fR +.SH "AUTHORS" + +Marc Ewing <marc@redhat.com> + +Jeff Johnson <jbj@redhat.com> + +Erik Troan <ewt@redhat.com> |