- fix: lclint fiddles broke uCache initialization (#43139).
- always use db cursors.
- permit duplicates for btree indices.
+ - document build modes in rpmbuild.8, rpmbuild is born.
4.0 -> 4.0.[12]
- add doxygen and lclint annotations most everywhere.
SUBDIRS = manual ja pl ru sk
-man_MANS = gendiff.1 rpm.8 rpm2cpio.8
+man_MANS = gendiff.1 rpm.8 rpmbuild.8 rpm2cpio.8
EXTRA_DIST = $(man_MANS)
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "RPM" "8" "21 April 2001" "Red Hat, Inc." "Red Hat Linux"
+.TH "RPM" "8" "06 June 2001" "Red Hat, Inc." "Red Hat Linux"
.SH NAME
rpm \- RPM Package Manager
.SH SYNOPSIS
\fBrpm\fR {\fB-F|--freshen\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR
-\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--nodeps\fR] [\fB--noscripts\fR]
-[\fB--notriggers\fR] [\fB--repackage\fR] [\fB--test\fR] \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR
+\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--nodeps\fR] [\fB--noscripts\fR] [\fB--notriggers\fR] [\fB--repackage\fR] [\fB--test\fR] \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR
.SS "BUILDING PACKAGES:"
.PP
.SS "SELECT-OPTIONS"
.PP
-\fB\fR\fB[\fIPACKAGE_NAME\fB] [-a,--all]
+\fB[\fIPACKAGE_NAME\fB] [-a,--all]
[-f,--file\ \fIFILE\fB] [-g,--group\ \fIGROUP\fB] [-p,--package\ \fIPACKAGE_FILE\fB]
[--querybynumber\ \fINUMBER\fB] [--triggeredby\ \fIPACKAGE_NAME\fB]
[--whatprovides\ \fICAPABILITY\fB] [--whatrequires\ \fICAPABILITY\fB]\fR
.SS "QUERY-OPTIONS"
.PP
-\fB\fR\fB[--changelog] [-c,--configfiles] [-d,--docfiles] [--dump] [--filesbypkg]
+\fB[--changelog] [-c,--configfiles] [-d,--docfiles] [--dump] [--filesbypkg]
[-i,--info] [--last] [-l,--list] [--provides] [--qf,--queryformat\ \fIQUERYFMT\fB] [-R,--requires]
[--scripts] [-s,--state] [--triggers,--triggerscripts]\fR
.SS "INSTALL-OPTIONS"
.PP
-\fB\fR\fB[--allfiles] [--badreloc] [--excludepath\ \fIOLDPATH\fB] [--excludedocs] [--force] [-h,--hash]
+\fB[--allfiles] [--badreloc] [--excludepath\ \fIOLDPATH\fB] [--excludedocs] [--force] [-h,--hash]
[--ignoresize] [--ignorearch] [--ignoreos] [--includedocs] [--justdb]
[--nodeps] [--noorder] [--noscripts] [--notriggers]
-[--oldpackage] [--percent] [--prefix\ \fINEWPATH\fB] [--relocate\ \fIOLDPATH\fB=\fINEWPATH\fB]
+[--oldpackage] [--percent] [--prefix \fINEWPATH\fB] [--relocate\ \fIOLDPATH\fB=\fINEWPATH\fB]
[--repackage] [--replacefiles] [--replacepkgs] [--test]\fR
.SS "BUILD-OPTIONS"
.PP
-\fB\fR\fB[--buildroot\ \fIDIRECTORY\fB] [--clean] [--rmsource] [--rmspec]
-[--short-circuit] [--sign] [--target=\fIPLATFORM\fB] [--test]\fR
+\fB[--buildroot \fIDIRECTORY\fB] [--clean] [--nobuild] [--rmsource] [--rmspec]
+[--short-circuit] [--sign] [--target\ \fIPLATFORM\fB]\fR
.SH "DESCRIPTION"
.PP
\fBrpm\fR is a powerful \fBPackage Manager\fR,
which can be used to build, install, query, verify, update, and
-erase individual software packages. A \fBPackage\fR consists
-of an archive of files, and package information, including name,
-version, and description.
+erase individual 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:
\fBQuery\fR,
.PP
These options can be used in all the different modes.
.TP
-\fB--dbpath \fIDIRECTORY\fB\fR
-Use the database in \fIDIRECTORY\fR rathen
-than the default path \fI/var/lib/rpm\fR
-.TP
\fB-?, --help\fR
Print a longer usage message then normal.
.TP
-\fB--pipe \fICMD\fB\fR
-Pipes the output of \fBrpm\fR to the command \fICMD\fR.
+\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
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
\fB%post\fR
scriptlet(s) are run after a chroot(2) to
\fIDIRECTORY\fR.
-.TP
-\fB--version\fR
-Print a single line containing the version number of \fBrpm\fR
-being used.
-.TP
-\fB-vv\fR
-Print lots of ugly debugging information.
.SS "INSTALL AND UPGRADE OPTIONS"
.PP
The general form of an rpm install command is
Install the packages even if some of them are already installed
on this system.
.TP
-\fB--test\fR
+\fB--nobuild\fR
Do not install the package, simply check for and report
potential conflicts.
.SS "QUERY OPTIONS"
\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. "\fBrpm\fR \fB--rmsource foo.spec\fR").
\fB%_target_arch\fR, and
\fB%_target_os\fR
accordingly.
-.TP
-\fB--nobuild\fR
-Do not execute any build stages. Useful for testing out spec files.
.SS "REBUILD AND RECOMPILE OPTIONS"
.PP
There are two other ways to invoke building with rpm:
.PP
The general form of an rpm rebuild database command is
.PP
-\fBrpm\fR {\fB--initdb|--rebuilddb\fR} [\fB-v\fR] [\fB--dbpath \fIDIRECTORY\fB\fR] [\fB--root \fIDIRECTORY\fB\fR]
+\fBrpm\fR {\fB--initdb|--rebuilddb\fR} [\fB-v\fR] [\fB--dbpath\ \fIDIRECTORY\fB\fR] [\fB--root\ \fIDIRECTORY\fB\fR]
.PP
Use \fB--initdb\fR to create a new database, use
\fB--rebuilddb\fR to rebuild the database indices from
the macro \fB%_httpport\fR.
.SH "FILES"
.PP
-
\fI/usr/lib/rpm/rpmrc\fR
\fI/etc/rpmrc\fR
\fBrpm2cpio\fR(8),
-\fB http://www.rpm.org/ <URL:http://www.rpm.org/>
-\fR
+\fBrpmbuild\fR(8),
+
+\fBhttp://www.rpm.org/\fR
.SH "AUTHORS"
Marc Ewing <marc@redhat.com>
%lang(sv) %{__prefix}/*/locale/sv/LC_MESSAGES/rpm.mo
%lang(tr) %{__prefix}/*/locale/tr/LC_MESSAGES/rpm.mo
-%{__prefix}%{__share}/man/man[18]/*.[18]*
+%{__prefix}%{__share}/man/man1/gendiff.1*
+%{__prefix}%{__share}/man/man8/rpm.8*
+%{__prefix}%{__share}/man/man8/rpm2cpio.8*
%lang(pl) %{__prefix}%{__share}/man/pl/man[18]/*.[18]*
%lang(ru) %{__prefix}%{__share}/man/ru/man[18]/*.[18]*
%lang(sk) %{__prefix}%{__share}/man/sk/man[18]/*.[18]*
%attr(0755, @RPMUSER@, @RPMGROUP@) %{__prefix}/lib/rpm/vpkg-provides.sh
%attr(0755, @RPMUSER@, @RPMGROUP@) %{__prefix}/lib/rpm/vpkg-provides2.sh
+%{__prefix}%{__share}/man/man8/rpmbuild.8*
+
%if %{with_python_subpackage}
%files python
%defattr(-,root,root)
# Popt glue to preserve legacy CLI behavior.
#
# XXX popt exec parsing doesn't honor POPT_ARGFLAG_ONEDASH
-rpm exec --bp rpmb -bp
-rpm exec --bc rpmb -bc
-rpm exec --bi rpmb -bi
-rpm exec --bl rpmb -bl
-rpm exec --ba rpmb -ba
-rpm exec --bb rpmb -bb
-rpm exec --bs rpmb -bs
-rpm exec --tp rpmb -tp
-rpm exec --tc rpmb -tc
-rpm exec --ti rpmb -ti
-rpm exec --tl rpmb -tl
-rpm exec --ta rpmb -ta
-rpm exec --tb rpmb -tb
-rpm exec --ts rpmb -ts
-rpm exec --rebuild rpmb --rebuild
-rpm exec --recompile rpmb --recompile
-rpm exec --clean rpmb --clean
-rpm exec --rmsource rpmb --rmsource
-rpm exec --rmspec rpmb --rmspec
-rpm exec --target rpmb --target
-rpm exec --short-circuit rpmb --short-circuit
+#rpm exec --bp rpmb -bp
+#rpm exec --bc rpmb -bc
+#rpm exec --bi rpmb -bi
+#rpm exec --bl rpmb -bl
+#rpm exec --ba rpmb -ba
+#rpm exec --bb rpmb -bb
+#rpm exec --bs rpmb -bs
+#rpm exec --tp rpmb -tp
+#rpm exec --tc rpmb -tc
+#rpm exec --ti rpmb -ti
+#rpm exec --tl rpmb -tl
+#rpm exec --ta rpmb -ta
+#rpm exec --tb rpmb -tb
+#rpm exec --ts rpmb -ts
+#rpm exec --rebuild rpmb --rebuild
+#rpm exec --recompile rpmb --recompile
+#rpm exec --clean rpmb --clean
+#rpm exec --rmsource rpmb --rmsource
+#rpm exec --rmspec rpmb --rmspec
+#rpm exec --target rpmb --target
+#rpm exec --short-circuit rpmb --short-circuit
rpm exec --initdb rpmd --initdb
rpm exec --rebuilddb rpmd --rebuilddb
rpm exec -y rpmv -y
rpm exec --verify rpmv --verify
-rpm alias --with --define "_with_!#:+ --with-!#:+"
-rpm alias --without --define "_without_!#:+ --without-!#:+"
+#rpm alias --with --define "_with_!#:+ --with-!#:+"
+#rpm alias --without --define "_without_!#:+ --without-!#:+"
#==============================================================================
-rpmb alias --dbpath --define '_dbpath !#:+'
-rpmb alias --ftpport --define '_ftpport !#:+'
-rpmb alias --ftpproxy --define '_ftpproxy !#:+'
-rpmb alias --httpport --define '_httpport !#:+'
-rpmb alias --httpproxy --define '_httpproxy !#:+'
-rpmb alias --timecheck --define '_timecheck !#:+'
-rpmb alias --with --define "_with_!#:+ --with-!#:+"
-rpmb alias --without --define "_without_!#:+ --without-!#:+"
+#rpmb alias --dbpath --define '_dbpath !#:+'
+#rpmb alias --ftpport --define '_ftpport !#:+'
+#rpmb alias --ftpproxy --define '_ftpproxy !#:+'
+#rpmb alias --httpport --define '_httpport !#:+'
+#rpmb alias --httpproxy --define '_httpproxy !#:+'
+#rpmb alias --timecheck --define '_timecheck !#:+'
+#rpmb alias --with --define "_with_!#:+ --with-!#:+"
+#rpmb alias --without --define "_without_!#:+ --without-!#:+"
#==============================================================================
rpmbuild alias --dbpath --define '_dbpath !#:+'
rpmbuild alias --ftpport --define '_ftpport !#:+'
rpmbuild alias --timecheck --define '_timecheck !#:+'
rpmbuild alias --with --define "_with_!#:+ --with-!#:+"
rpmbuild alias --without --define "_without_!#:+ --without-!#:+"
-==============================================================================
+#==============================================================================
rpmd alias --dbpath --define '_dbpath !#:+'
rpmd alias --ftpport --define '_ftpport !#:+'
rpmd alias --ftpproxy --define '_ftpproxy !#:+'
rpmd alias --httpport --define '_httpport !#:+'
rpmd alias --httpproxy --define '_httpproxy !#:+'
#==============================================================================
+rpmdb alias --dbpath --define '_dbpath !#:+'
+rpmdb alias --ftpport --define '_ftpport !#:+'
+rpmdb alias --ftpproxy --define '_ftpproxy !#:+'
+rpmdb alias --httpport --define '_httpport !#:+'
+rpmdb alias --httpproxy --define '_httpproxy !#:+'
+#==============================================================================
rpme alias --dbpath --define '_dbpath !#:+'
rpme alias --ftpport --define '_ftpport !#:+'
rpme alias --ftpproxy --define '_ftpproxy !#:+'
rpmi alias --httpport --define '_httpport !#:+'
rpmi alias --httpproxy --define '_httpproxy !#:+'
#==============================================================================
+rpmk alias --dbpath --define '_dbpath !#:+'
+rpmk alias --ftpport --define '_ftpport !#:+'
+rpmk alias --ftpproxy --define '_ftpproxy !#:+'
+rpmk alias --httpport --define '_httpport !#:+'
+rpmk alias --httpproxy --define '_httpproxy !#:+'
+#==============================================================================
rpmq alias --dbpath --define '_dbpath !#:+'
rpmq alias --ftpport --define '_ftpport !#:+'
rpmq alias --ftpproxy --define '_ftpproxy !#:+'
rpmq alias --filesbypkg --qf '[%-25{=NAME} %{FILENAMES}\n]'
#==============================================================================
-rpmt alias --dbpath --define '_dbpath !#:+'
-rpmt alias --ftpport --define '_ftpport !#:+'
-rpmt alias --ftpproxy --define '_ftpproxy !#:+'
-rpmt alias --httpport --define '_httpport !#:+'
-rpmt alias --httpproxy --define '_httpproxy !#:+'
-rpmt alias --timecheck --define '_timecheck !#:+'
-#==============================================================================
rpmu alias --dbpath --define '_dbpath !#:+'
rpmu alias --ftpport --define '_ftpport !#:+'
rpmu alias --ftpproxy --define '_ftpproxy !#:+'