.\" rpm - Red Hat Package Manager .TH rpm 8 "23 October 1995" "Red Hat Software" "Red Hat Commercial Linux" .SH NAME rpm \- Red Hat Package Manager .SH SYNOPSIS \fBrpm\fP [options] .br \fBrpmq\fP [options] .SH DESCRIPTION \fBrpm\fP is a powerful \fIpackage manager\fP, which can be used to build, install, query, verify, update, and uninstall individual software packages. A \fIpackage\fP consists of an archive of files, and package information, including name, version, and description. \fBrpmq\fP is a work\-in\-progress rewrite of rpm in the C language. It currently handles most querying options well, and installs are partially implemented. It is however, much faster then the standard \fBrpm\fP. There are five basic modes of operation, and each takes a different set of options. They are \fIbuild\fP, \fIinstall\fP, \fIquery\fP, \fIverify\fP, and \fIuninstall\fP. .I "\fBrpm \-i [install\-options] +\fP" .br .I "\fBrpm \-q [query\-options]\fP" .br .I "\fBrpm \-V|\-y|\-\-verify [verify\-options]\fP" .br .I "\fBrpm \-u +\fP" .br .I "\fBrpm \-b\fIO\fB [build\-options] +\fP" .SH INSTALL OPTIONS .IP "\fB\-U, \-\-upgrade\fP" Upgrade the package currently installed to the version in the new RPM. This is the same as install, except all other version of the package are removed from the system. .IP "\fB\-S, \-\-search\fP" Search the locations listed in /etc/rpmrc for the rpm. .IP "\fB\-h, \-\-hash\fP" Print 50 hash marks as the package archive is unpacked. Use with \fB\-v\fP for a nice display. .IP "\fB\-\-percent\fP" Print percentages as files are unpacked from the package archive. .IP "\fB\-\-force\fP" Install despite any potential conflicts. .IP "\fB\-\-test\fP" Do not install the package, simply check for and report potential conflicts. .IP "\fB\-\-root \fI\fP" Do the installation on the system rooted at \fI\fP. Note that this means the database will be updated under \fI\fP and any \fIpre\fP or \fIpost\fP scripts are run after a chroot() to \fI\fP. .SH UNINSTALL OPTIONS .IP "\fB\-\-test\fP" Don't really uninstall anything, just go through the motions. This is designed primarily for testing and should normally be used with the \fB\-vv\fP option. .SH BUILD OPTIONS The general form of a rpm build command is .PP \fBrpm \-b\fIO\fB [build\-options] +\fP .PP where \fB\-b\fIO\fP specifies the stages of building and packaging to be done and is one of: .IP "\fB\-bp\fP" Executes the "%prep" stage from the spec file. Normally this involves unpacking the sources and applying any patches. .IP "\fB\-bl\fP" Do a "list check". The "%files" section from the spec file is macro expanded, and checks are made to insure the files exist. .IP "\fB\-bc\fP" Do the "%build" stage from the spec file (after doing the prep stage). This generally involves the equivalent of a "make". .IP "\fB\-bi\fP" Do the "%install" stage from the spec file (after doing the prep and build stages). This generally involves the equivalent of a "make install". .IP "\fB\-bb\fP" Build a binary package (after doing the prep, build, and install stages). .IP "\fB\-ba\fP" Build binary and source packages (after doing the prep, build, and install stages). .PP The following options may also be used: .IP "\fB\-\-short\-circuit\fP" Skip straight to specified stage (ie, skip all stages leading up to the specified stage). Only valid for \fB\-bc\fP and \fB\-bi\fP. .IP "\fB\-\-clean\fP" Remove the build tree after the packages are made. .IP "\fB\-\-test\fP" Do not execute any build stages. Implies \fB\-\-keep\-temps\fP. Useful for testing out spec files. .SH QUERY OPTIONS There are two sets of options for querying: package selection, and information selection. Package selection options: .br .IP "\fB\fI\fP" Query pacakge named \fB\fI\fP. .IP "\fB\-a\fP" Query all packages .IP "\fB\-f \fI\fP" Query package owning \fI\fP. .IP "\fB\-F\fP" Like \fB\-f\fP but read file names from stdin. .IP "\fB\-p \fI\fP" Query an (uninstalled) package \fI\fP. .IP "\fB\-P\fP" Like \fB\-p\fP but read package file names from stdin. .br Information selection options: .br .IP "\fB\-i\fP" Display package information, including name, version, and description. .IP "\fB\-l\fP" List files in package. .IP "\fB\-s\fP" Display \fIstates\fP of file in package (implies \fB\-l\fP). The state of each package is either \fInormal\fP or \fIoverwritten\fP. .IP "\fB\-d\fP" List only documentation files (implies \fB\-l\fP). .IP "\fB\-c\fP" List only configuration files (implies \fB\-l\fP). .SH VERIFY OPTIONS Verifying a package compares information about the installed files in the package with information about the files taken from the original package and stored in the rpm database. Among other things, verifying compares the size, MD5 sum, permissions, type, owner and group of each file. Any discrepencies are displayed. The package specification options are the same as for package querying. .SH REBUILD OPTION There is another way to invoke rpm: .I "\fBrpm \-\-rebuild +\fP" When invoked this way, rpm installs the named source package, and builds a binary package from it as if it were invoked as: .SH WHERE OPTION There is one more option that can be used to invoke rpm: .IP "\fB\-w, \-\-where\fP" This causes rpm to search the locations listed in /etc/rpmrc for any rpm matching those listed as arguments on the command line. .SH GENERAL OPTIONS These options can be used in all the different modes. .IP "\fB\-vv\fP" Print lots of ugly debugging information. .IP "\fB\-\-keep\-temps\fP" Do not remove temporary files (/tmp/rpm\-*). Primarily only useful for debugging rpm. .IP "\fB\-\-quiet\fP" Print as little as possible \- normally only error messages will be displayed. .IP "\fB\-\-help\fP" Print a longer usage message then normal. .IP "\fB\-\-version\fP" Print a single line containing the version number of rpm being used. .IP "\fB\-\-root \fP" Use the directory given as top level directory for all operations. .SH FILES .nf /etc/rpmrc /var/lib/rpm/packages /var/lib/rpm/pathidx /var/lib/rpm/nameidx /tmp/rpm-* .fi .El .SH SEE ALSO .IR glint (8) , .IR rpm2cpio (8) , .B http://www.redhat.com/RPM-HOWTO .nf .SH AUTHORS .nf Marc Ewing Erik Troan .fi