diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/rpm.8')
| -rw-r--r-- | upstream/opensuse-leap-15-6/man8/rpm.8 | 999 |
1 files changed, 999 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/rpm.8 b/upstream/opensuse-leap-15-6/man8/rpm.8 new file mode 100644 index 00000000..4287bc38 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man8/rpm.8 @@ -0,0 +1,999 @@ +.\" 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 "RPM" "8" "09 June 2002" "Red Hat, Inc." +.SH NAME +rpm \- RPM Package Manager +.SH SYNOPSIS +.SS "QUERYING AND VERIFYING PACKAGES:" +.PP + + +\fBrpm\fR {\fB-q|--query\fR} [\fBselect-options\fR] [\fBquery-options\fR] + +\fBrpm\fR \fB--querytags\fR + +\fBrpm\fR {\fB-V|--verify\fR} [\fBselect-options\fR] [\fBverify-options\fR] + +.SS "INSTALLING, UPGRADING, AND REMOVING PACKAGES:" +.PP + + +\fBrpm\fR {\fB-i|--install\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR + + + +\fBrpm\fR {\fB-U|--upgrade\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR + + + +\fBrpm\fR {\fB-F|--freshen\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR + + + +\fBrpm\fR {\fB--reinstall\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR + + + +\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--justdb] [\fB--nodeps\fR] [\fB--noscripts\fR] + [\fB--notriggers\fR] [\fB--test\fR] \fB\fIPACKAGE_NAME\fB\fR\fI\ ...\fR + +.SS "MISCELLANEOUS:" +.PP + +\fBrpm\fR \fB--showrc\fR + +\fBrpm\fR \fB--setperms\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR + +\fBrpm\fR \fB--setugids\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR + +\fBrpm\fR \fB--setcaps\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR + +\fBrpm\fR \fB--restore\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR + +.SS "select-options" +.PP + + [\fB\fIPACKAGE_NAME\fB\fR] + [\fB-a,--all [\fISELECTOR\fR]\fR] [\fB-f,--file \fIFILE\fB\fR] + [\fB-g,--group \fIGROUP\fB\fR] {\fB-p,--package \fIPACKAGE_FILE\fB\fR] + [\fB--hdrid \fISHA1\fB\fR] [\fB--pkgid \fIMD5\fB\fR] [\fB--tid \fITID\fB\fR] + [\fB--querybynumber \fIHDRNUM\fB\fR] [\fB--triggeredby \fIPACKAGE_NAME\fB\fR] + [\fB--whatprovides \fICAPABILITY\fB\fR] [\fB--whatrequires \fICAPABILITY\fB\fR] + [\fB--whatrecommends \fICAPABILITY\fB\fR] [\fB--whatsuggests \fICAPABILITY\fB\fR] + [\fB--whatsupplements \fICAPABILITY\fB\fR] [\fB--whatenhances \fICAPABILITY\fB\fR] + [\fB--whatobsoletes \fICAPABILITY\fB\fR] [\fB--whatconflicts \fICAPABILITY\fB\fR] + +.SS "query-options" +.PP +General: + [\fB--changelog\fR] [\fB--changes\fR] [\fB--dupes\fR] [\fB-i,--info\fR] + [\fB--last\fR] [\fB--qf,--queryformat \fIQUERYFMT\fB\fR] [\fB--xml\fR] +.PP +Dependencies: + [\fB--conflicts\fR] [\fB--enhances\fR] [\fB--obsoletes\fR] [\fB--provides\fR] + [\fB--recommends\fR] [\fB-R,--requires\fR] [\fB--suggests\fR] [\fB--supplements\fR] +.PP +Files: + [\fB-c,--configfiles\fR] [\fB-d,--docfiles\fR] [\fB--dump\fR] [\fB--fileclass\fR] + [\fB--filecolor\fR] [\fB--fileprovide\fR][\fB--filerequire\fR] [\fB--filecaps\fR] + [\fB--filesbypkg\fR] [\fB-l,--list\fR] [\fB-s,--state\fR] + [\fB--noartifact\fR] [\fB--noghost\fR] [\fB--noconfig\fR +.PP +Scripts and triggers: + [\fB--filetriggers\fR] [\fB--scripts\fR] [\fB--triggers,--triggerscripts\fR] + +.SS "verify-options" +.PP + + + [\fB--nodeps\fR] [\fB--nofiles\fR] [\fB--noscripts\fR] + [\fB--nodigest\fR] [\fB--nosignature\fR] + [\fB--nolinkto\fR] [\fB--nofiledigest\fR] [\fB--nosize\fR] [\fB--nouser\fR] + [\fB--nogroup\fR] [\fB--nomtime\fR] [\fB--nomode\fR] [\fB--nordev\fR] + [\fB--nocaps\fR] + +.SS "install-options" +.PP + + + [\fB--allfiles\fR] [\fB--badreloc\fR] [\fB--excludepath \fIOLDPATH\fB\fR] + [\fB--excludedocs\fR] [\fB--force\fR] [\fB-h,--hash\fR] + [\fB--ignoresize\fR] [\fB--ignorearch\fR] [\fB--ignoreos\fR] + [\fB--includedocs\fR] [\fB--justdb\fR] + [\fB--nodeps\fR] [\fB--nodigest\fR] [\fB--noplugins\fR] + [\fB--nocaps\fR] [\fB--noorder\fR] + [\fB--nosignature\fR] [\fB--noscripts\fR] [\fB--notriggers\fR] + [\fB--oldpackage\fR] [\fB--percent\fR] [\fB--prefix \fINEWPATH\fB\fR] + [\fB--relocate \fIOLDPATH\fB=\fINEWPATH\fB\fR] + [\fB--replacefiles\fR] [\fB--replacepkgs\fR] + [\fB--test\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 +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, +\fBVerify\fR, +\fBInstall/Upgrade/Freshen/Reinstall\fR, +\fBUninstall\fR, +\fBSet Owners/Groups\fR, +\fBShow Querytags\fR, and +\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, --verbose\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 +Replace the list of configuration files to be read. 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/usr/\:lib/\:rpm/\:redhat/\:rpmrc\fR:\:\fI/etc/\:rpmrc\fR:\:\fI~/.rpmrc\fR. + +.TP +\fB--macros \fIFILELIST\fB\fR +Replace the list of macro files to be loaded. Each of the files in the colon separated +\fIFILELIST\fR +is read sequentially by \fBrpm\fR for macro definitions. +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/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\:macros.d/\:macros.*\fR:\:\fI/usr/\:lib/\:rpm/\:platform/\:%{_target}/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\:fileattrs/\:*.attr\fR:\:\fI/usr/\:lib/\:rpm/\:redhat/\:macros\fR:\:\fI/etc/\:rpm/\:macros.*\fR:\:\fI/etc/\:rpm/\:macros\fR:\:\fI/etc/\:rpm/\:%{_target}/\:macros\fR:\:\fI~/.rpmmacros + +.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 rather +than the default path \fI/var/lib/rpm\fR +.TP +\fB--root \fIDIRECTORY\fB\fR +Use the file system tree rooted at \fIDIRECTORY\fR for all operations. +Note that this means the database within +\fIDIRECTORY\fR +will be used for dependency checks and any scriptlet(s) (e.g. +\fB%post\fR if installing, or +\fB%prep\fR if building, a package) +will be run after a chroot(2) to +\fIDIRECTORY\fR. +.TP +\fB-D, --define='\fIMACRO EXPR\fB'\fR +Defines \fIMACRO\fR with value \fIEXPR\fR. +.TP +\fB--undefine='\fIMACRO\fB'\fR +Undefines \fIMACRO\fR. +.TP +\fB-E, --eval='\fIEXPR\fB'\fR +Prints macro expansion of \fIEXPR\fR. + +.PP +More - less often needed - options can be found on the \fBrpm-misc(8)\fR man page. +.SS "INSTALL AND UPGRADE OPTIONS" +.PP +In these options, \fIPACKAGE_FILE\fR can be either \fBrpm\fR binary +file or ASCII package manifest (see \fBPACKAGE SELECTION OPTIONS\fR), and +may be specified as an +\fBftp\fR or +\fBhttp\fR URL, +in which case the package will be downloaded before being +installed. See \fBFTP/HTTP OPTIONS\fR +for information on \fBrpm\fR's internal +\fBftp\fR and +\fBhttp\fR +client support. +.PP +The general form of an rpm install command is +.PP +\fBrpm\fR {\fB-i|--install\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR +.PP +This installs a new package. +.PP +The general form of an rpm upgrade command is +.PP +\fBrpm\fR {\fB-U|--upgrade\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR +.PP +This upgrades or installs the package currently installed +to a newer version. This is the same as install, except +all other version(s) of the package are removed after the +new package is installed. +.PP +\fBrpm\fR {\fB-F|--freshen\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR +.PP +This will upgrade packages, but only ones for which an earlier version is +installed. +.PP +The general form of an rpm reinstall command is +.PP +\fBrpm\fR {\fB--reinstall\fR} [\fBinstall-options\fR] \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR +.PP +This reinstalls a previously installed package. +.PP +.PP +.TP +\fB--allfiles\fR +Installs or upgrades all the missingok files in the package, +regardless if they exist. +.TP +\fB--badreloc\fR +Used with \fB--relocate\fR, permit relocations on +all file paths, not just those \fIOLDPATH\fR's +included in the binary package relocation hint(s). +.TP +\fB--excludepath \fIOLDPATH\fB\fR +Don't install files whose name begins with +\fIOLDPATH\fR. +.TP +\fB--excludedocs\fR +Don't install any files which are marked as documentation +(which includes man pages and texinfo documents). +.TP +\fB--force\fR +Same as using +\fB--replacepkgs\fR, +\fB--replacefiles\fR, and +\fB--oldpackage\fR. +.TP +\fB-h, --hash\fR +Print 50 hash marks as the package archive is unpacked. +Use with \fB-v|--verbose\fR for a nicer display. +.TP +\fB--ignoresize\fR +Don't check mount file systems for sufficient disk space before +installing this package. +.TP +\fB--ignorearch\fR +Allow installation or upgrading even if the architectures +of the binary package and host don't match. +.TP +\fB--ignoreos\fR +Allow installation or upgrading even if the operating +systems of the binary package and host don't match. +.TP +\fB--includedocs\fR +Install documentation files. This is the default behavior. +.TP +\fB--justdb\fR +Update only the database, not the filesystem. +.TP +\fB--nodigest\fR +Don't verify package or header digests when reading. +.TP +\fB--nomanifest\fR +Don't process non-package files as manifests. +.TP +\fB--nosignature\fR +Don't verify package or header signatures when reading. +.TP +\fB--nodeps\fR +Don't do a dependency check before installing or upgrading +a package. +.TP +\fB--nocaps\fR +Don't set file capabilities. +.TP +\fB--noorder\fR +Don't reorder the packages for an install. The list of +packages would normally be reordered to satisfy dependencies. +.TP +\fB--noplugins\fR +Do not load and execute plugins. +.TP +\fB--noscripts\fR, \fB--nopre\fR, \fB--nopost\fR, \fB--nopreun\fR, \fB--nopostun\fR, \fB--nopretrans\fR, \fB--noposttrans\fR +Don't execute the scriptlet of the same name. +The \fB--noscripts\fR option is equivalent to + +\fB--nopre\fR +\fB--nopost\fR +\fB--nopreun\fR +\fB--nopostun\fR +\fB--nopretrans\fR +\fB--noposttrans\fR + +and turns off the execution of the corresponding +\fB%pre\fR, +\fB%post\fR, +\fB%preun\fR, +\fB%postun\fR +\fB%pretrans\fR, and +\fB%posttrans\fR +scriptlet(s). + +.TP +\fB--notriggers\fR, \fB--notriggerin\fR, \fB--notriggerun\fR, \fB--notriggerprein\fR, \fB--notriggerpostun\fR +Don't execute any trigger scriptlet of the named type. +The \fB--notriggers\fR option is equivalent to + +\fB--notriggerprein\fR +\fB--notriggerin\fR +\fB--notriggerun\fR +\fB--notriggerpostun\fR + +and turns off execution of the corresponding +\fB%triggerprein\fR, +\fB%triggerin\fR, +\fB%triggerun\fR, and +\fB%triggerpostun\fR +scriptlet(s). +.TP +\fB--oldpackage\fR +Allow an upgrade to replace a newer package with an older one. +.TP +\fB--percent\fR +Print percentages as files are unpacked from the package archive. +This is intended to make \fBrpm\fR easy to run from +other tools. +.TP +\fB--prefix \fINEWPATH\fB\fR +For relocatable binary packages, translate all file paths that +start with the installation prefix in the package relocation hint(s) +to \fINEWPATH\fR. +.TP +\fB--relocate \fIOLDPATH\fB=\fINEWPATH\fB\fR +For relocatable binary packages, translate all file paths +that start with \fIOLDPATH\fR in the +package relocation hint(s) to \fINEWPATH\fR. +This option can be used repeatedly if several +\fIOLDPATH\fR's in the package are to +be relocated. +.TP +\fB--replacefiles\fR +Install the packages even if they replace files from other, +already installed, packages. +.TP +\fB--replacepkgs\fR +Install the packages even if some of them are already installed +on this system. +.TP +\fB--test\fR +Do not install the package, simply check for and report +potential conflicts. +.SS "ERASE OPTIONS" +.PP +The general form of an rpm erase command is +.PP + +\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--justdb] [\fB--nodeps\fR] [\fB--noscripts\fR] [\fB--notriggers\fR] [\fB--test\fR] \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR + +.PP +The following options may also be used: +.TP +\fB--allmatches\fR +Remove all versions of the package which match +\fIPACKAGE_NAME\fR. Normally an +error is issued if \fIPACKAGE_NAME\fR +matches multiple packages. +.TP +\fB--justdb\fR +Update only the database, not the filesystem. +.TP +\fB--nodeps\fR +Don't check dependencies before uninstalling the packages. +.TP +\fB--noscripts\fR, \fB--nopreun\fR, \fB--nopostun\fR +Don't execute the scriptlet of the same name. +The \fB--noscripts\fR option during package erase is +equivalent to + +\fB--nopreun\fR +\fB--nopostun\fR + +and turns off the execution of the corresponding +\fB%preun\fR, and +\fB%postun\fR +scriptlet(s). +.TP +\fB--notriggers\fR, \fB--notriggerun\fR, \fB--notriggerpostun\fR +Don't execute any trigger scriptlet of the named type. +The \fB--notriggers\fR option is equivalent to + +\fB--notriggerun\fR +\fB--notriggerpostun\fR + +and turns off execution of the corresponding +\fB%triggerun\fR, and +\fB%triggerpostun\fR +scriptlet(s). +.TP +\fB--test\fR +Don't really uninstall anything, just go through the motions. +Useful in conjunction with the \fB-vv\fR option +for debugging. +.SS "QUERY OPTIONS" +.PP +The general form of an rpm query command is +.PP + +\fBrpm\fR {\fB-q|--query\fR} [\fBselect-options\fR] [\fBquery-options\fR] + +.PP +You may specify the format that package information should be +printed in. To do this, you use the + + \fB--qf|--queryformat\fR \fB\fIQUERYFMT\fB\fR + +option, followed by the \fIQUERYFMT\fR +format string. Query formats are modified versions of the +standard \fBprintf(3)\fR formatting. The format +is made up of static strings (which may include standard C +character escapes for newlines, tabs, and other special +characters) and \fBprintf(3)\fR type formatters. +As \fBrpm\fR already knows the type to print, the +type specifier must be omitted however, and replaced by the name +of the header tag to be printed, enclosed by \fB{}\fR +characters. Tag names are case insensitive, and the leading +\fBRPMTAG_\fR portion of the tag name may be omitted +as well. +.PP +Alternate output formats may be requested by following +the tag with \fB:\fItypetag\fB\fR. +Currently, the following types are supported: +.TP +\fB:armor\fR +Wrap a public key in ASCII armor. +.TP +\fB:arraysize\fR +Display number of elements in array tags. +.TP +\fB:base64\fR +Encode binary data using base64. +.TP +\fB:date\fR +Use strftime(3) "%c" format. +.TP +\fB:day\fR +Use strftime(3) "%a %b %d %Y" format. +.TP +\fB:depflags\fR +Format dependency comparison operator. +.TP +\fB:deptype\fR +Format dependency type. +.TP +\fB:expand\fR +Perform macro expansion. +.TP +\fB:fflags\fR +Format file flags. +.TP +\fB:fstate\fR +Format file state. +.TP +\fB:fstatus\fR +Format file verify status. +.TP +\fB:hex\fR +Format in hexadecimal. +.TP +\fB:octal\fR +Format in octal. +.TP +\fB:humaniec\fR +Human readable number (in IEC 80000). The suffix K = 1024, M = 1048576, ... +.TP +\fB:humansi\fR +Human readable number (in SI). The suffix K = 1000, M = 1000000, ... +.TP +\fB:perms\fR +Format file permissions. +.TP +\fB:pgpsig\fR +Display signature fingerprint and time. +.TP +\fB:shescape\fR +Escape single quotes for use in a script. +.TP +\fB:triggertype\fR +Display trigger suffix. +.TP +\fB:vflags\fR +File verification flags. +.TP +\fB:xml\fR +Wrap data in simple xml markup. +.PP +For example, to print only the names of the packages queried, +you could use \fB%{NAME}\fR as the format string. +To print the packages name and distribution information in +two columns, you could use \fB%-30{NAME}%{DISTRIBUTION}\fR. +\fBrpm\fR will print a list of all of the tags it knows about when it +is invoked with the \fB--querytags\fR argument. +.PP +There are two subsets of options for querying: package selection, +and information selection. +.SS "PACKAGE SELECTION OPTIONS:" +.PP +.TP +\fB\fIPACKAGE_NAME\fB\fR +Query installed package named \fIPACKAGE_NAME\fR. To specify the package more precisely the package name may be followed by the version or version and release +both separated by a dash or an architecture name separated by a dot. See the output of \fBrpm -qa\fR or \fBrpm -qp \fIPACKAGE_FILE\fB\fR as an example. + +.TP +\fB-a, --all [\fISELECTOR\fR]\fR +Query all installed packages. + +An optional \fISELECTOR\fR in the form of tag=pattern can be provided to +narrow the selection, for example name="b*" to query packages whose name +starts with "b". +.TP +\fB--dupes\fB +List duplicated packages. +.TP +\fB-f, --file \fIFILE\fB\fR +Query package owning \fIFILE\fR. +.TP +\fB--filecaps\fR +List file names with POSIX1.e capabilities. +.TP +\fB--fileclass\fR +List file names with their classes (libmagic classification). +.TP +\fB--filecolor\fR +List file names with their colors (0 for noarch, 1 for 32bit, 2 for 64 bit). +.TP +\fB--fileprovide\fR +List file names with their provides. +.TP +\fB--filerequire\fR +List file names with their requires. +.TP +\fB-g, --group \fIGROUP\fB\fR +Query packages with the group of \fIGROUP\fR. +.TP +\fB--hdrid \fISHA1\fB\fR +Query package that contains a given header identifier, i.e. the +\fISHA1\fR digest of the immutable header region. +.TP +\fB-p, --package \fIPACKAGE_FILE\fB\fR +Query an (uninstalled) package \fIPACKAGE_FILE\fR. +The \fIPACKAGE_FILE\fR may be specified +as an \fBftp\fR or \fBhttp\fR style URL, in +which case the package header will be downloaded and queried. +See \fBFTP/HTTP OPTIONS\fR for information on +\fBrpm\fR's internal +\fBftp\fR and +\fBhttp\fR +client support. The \fIPACKAGE_FILE\fR argument(s), +if not a binary package, will be interpreted as an ASCII package +manifest unless \fB--nomanifest\fR option is used. +In manifests, comments are permitted, starting with a '#', and each +line of a package manifest file may include white space separated +glob expressions, including URL's, +that will be expanded to paths that are substituted in place of +the package manifest as additional \fIPACKAGE_FILE\fR +arguments to the query. +.TP +\fB--pkgid \fIMD5\fB\fR +Query package that contains a given package identifier, i.e. the +\fIMD5\fR digest of the combined header and +payload contents. +.TP +\fB--querybynumber \fIHDRNUM\fB\fR +Query the \fIHDRNUM\fRth database entry +directly; this is useful only for debugging. +.TP +\fB--specfile \fISPECFILE\fB\fR +Parse and query \fISPECFILE\fR as if +it were a package. Although not all the information (e.g. file lists) +is available, this type of query permits rpm to be used to extract +information from spec files without having to write a specfile +parser. +.TP +\fB--tid \fITID\fB\fR +Query package(s) that have a given \fITID\fR +transaction identifier. A unix time stamp is currently used as a +transaction identifier. All package(s) installed or erased within +a single transaction have a common identifier. +.TP +\fB--triggeredby \fIPACKAGE_NAME\fB\fR +Query packages that are triggered by package(s) +\fIPACKAGE_NAME\fR. +.TP +\fB--whatobsoletes \fICAPABILITY\fB\fR +Query all packages that obsolete \fICAPABILITY\fR for proper functioning. +.TP +\fB--whatprovides \fICAPABILITY\fB\fR +Query all packages that provide the \fICAPABILITY\fR capability. +.TP +\fB--whatrequires \fICAPABILITY\fB\fR +Query all packages that require \fICAPABILITY\fR for proper functioning. +.br +Note that this does not return what requires a given package. +A package usually provides multiple capabilities and file-names on which +other packages may depend. To see the complete dependencies +for a package, use \fB-e --test \fIPACKAGE_NAME\fB\fR +.TP +\fB--whatconflicts \fICAPABILITY\fB\fR +Query all packages that conflict with \fICAPABILITY\fR. +.TP +\fB--whatrecommends \fICAPABILITY\fB\fR +Query all packages that recommend \fICAPABILITY\fR. +.TP +\fB--whatsuggests \fICAPABILITY\fB\fR +Query all packages that suggest \fICAPABILITY\fR. +.TP +\fB--whatsupplements \fICAPABILITY\fB\fR +Query all packages that supplement \fICAPABILITY\fR. +.TP +\fB--whatenhances \fICAPABILITY\fB\fR +Query all packages that enhance \fICAPABILITY\fR. +.SS "PACKAGE QUERY OPTIONS:" +.PP +.TP +\fB-d, --artifactfiles\fR +List only artifact files (implies \fB-l\fR). +.TP +\fB--changelog\fR +Display change information for the package. +.TP +\fB--changes\fR +Display change information for the package with full time stamps. +.TP +\fB-c, --configfiles\fR +List only configuration files (implies \fB-l\fR). +.TP +\fB--conflicts\fR +List capabilities this package conflicts with. +.TP +\fB-d, --docfiles\fR +List only documentation files (implies \fB-l\fR). +.TP +\fB--dump\fR +Dump file information as follows (implies \fB-l\fR): +.sp +.RS + +.nf +path size mtime digest mode owner group isconfig isdoc rdev symlink + +.fi +.RE +.TP +\fB--enhances\fR +List capabilities enhanced by package(s) +.TP +\fB--filesbypkg\fR +List all the files in each selected package. +.TP +\fB--filetriggers\fR +List filetrigger scriptlets from package(s). +.TP +\fB-i, --info\fR +Display package information, including name, version, and description. +This uses the \fB--queryformat\fR if one was specified. +.TP +\fB--last\fR +Orders the package listing by install time such that the latest +packages are at the top. +.TP +\fB-L, --licensefiles\fR +List only license files (implies \fB-l\fR). +.TP +\fB-l, --list\fR +List files in package. +.TP +\fB--obsoletes\fR +List packages this package obsoletes. +.TP +\fB--provides\fR +List capabilities this package provides. +.TP +\fB--recommends\fR +List capabilities recommended by package(s) +.TP +\fB-R, --requires\fR +List capabilities on which this package depends. +.TP +\fB--suggests\fR +List capabilities suggested by package(s) +.TP +\fB--supplements\fR +List capabilities supplemented by package(s) +.TP +\fB--scripts\fR +List the package specific scriptlet(s) that are used as part +of the installation and uninstallation processes. +.TP +\fB-s, --state\fR +Display the \fIstates\fR of files in the package +(implies \fB-l\fR). The state of each file is one of +\fInormal\fR, +\fInot installed\fR, or +\fIreplaced\fR. +.TP +\fB--triggers, --triggerscripts\fR +Display the trigger scripts, if any, which are contained in +the package. +.TP +\fB--noartifact\fR +Don't display artifact files. +\fB--noghost\fR +Don't display ghost files. Useful in combination with option --list. +.TP +\fB--noconfig\fR +Don't display config files. +.TP +\fB--xml\fR +Format package headers as XML. + +.SS "VERIFY OPTIONS" +.PP +The general form of an rpm verify command is +.PP + +\fBrpm\fR {\fB-V|--verify\fR} [\fBselect-options\fR] [\fBverify-options\fR] + +.PP +Verifying a package compares information about the installed files in +the package with information about the files taken from the package +metadata stored in the rpm database. Among other things, verifying +compares the size, digest, permissions, type, owner and group of +each file. Any discrepancies are displayed. +Files that were not installed from the package, for example, +documentation files excluded on installation using the +"\fB--excludedocs\fR" option, +will be silently ignored. +.PP +The package selection options are the same as for package +querying (including package manifest files as arguments). +Other options unique to verify mode are: +.TP +\fB--nodeps\fR +Don't verify dependencies of packages. +.TP +\fB--nodigest\fR +Don't verify package or header digests when reading. +.TP +\fB--nofiles\fR +Don't verify any attributes of package files. +.TP +\fB--noghost\fR +Don't verify ghost files. +.TP +\fB--noconfig\fR +Don't verify config files. +.TP +\fB--noscripts\fR +Don't execute the \fB%verifyscript\fR scriptlet (if any). +.TP +\fB--nosignature\fR +Don't verify package or header signatures when reading. +.TP +\fB--nolinkto\fR +.TP +\fB--nofiledigest\fR (formerly \fB--nomd5\fR) +.TP +\fB--nosize\fR +.TP +\fB--nouser\fR +.TP +\fB--nogroup\fR +.TP +\fB--nomtime\fR +.TP +\fB--nomode\fR +.TP +\fB--nordev\fR +Don't verify the corresponding file attribute. +.TP +\fB--nocaps\fR +Don't verify file capabilities. +.PP +The format of the output is a string of 9 characters, a possible +attribute marker: + +.nf +\fBc\fR \fB%config\fR configuration file. +\fBd\fR \fB%doc\fR documentation file. +\fBg\fR \fB%ghost\fR file (i.e. the file contents are not included in the package payload). +\fBl\fR \fB%license\fR license file. +\fBr\fR \fB%readme\fR readme file. +.fi + +from the package header, followed by the file name. +Each of the 9 characters denotes the result of a comparison of +attribute(s) of the file to the value of those attribute(s) recorded +in the database. A single +"\fB.\fR" (period) +means the test passed, while a single +"\fB?\fR" (question mark) +indicates the test could not be performed (e.g. file permissions +prevent reading). Otherwise, the (mnemonically +em\fBB\fRoldened) character denotes failure of +the corresponding \fB--verify\fR test: + +.nf +\fBS\fR file \fBS\fRize differs +\fBM\fR \fBM\fRode differs (includes permissions and file type) +\fB5\fR digest (formerly MD\fB5\fR sum) differs +\fBD\fR \fBD\fRevice major/minor number mismatch +\fBL\fR read\fBL\fRink(2) path mismatch +\fBU\fR \fBU\fRser ownership differs +\fBG\fR \fBG\fRroup ownership differs +\fBT\fR m\fBT\fRime differs +\fBP\fR ca\fBP\fRabilities differ +.fi + +.SS "MISCELLANEOUS COMMANDS" +.PP +.TP +\fBrpm\fR \fB--showrc\fR +shows the values \fBrpm\fR will use for all of the +options are currently set in +\fIrpmrc\fR and +\fImacros\fR +configuration file(s). +.TP +\fBrpm\fR \fB--setperms\fR \fIPACKAGE_NAME\fR +sets permissions of files in the given package. Consider using +\fB--restore\fR instead. +.TP +\fBrpm\fR \fB--setugids\fR \fIPACKAGE_NAME\fR +sets user/group ownership of files in the given package. This command can +change permissions and capabilities of files in that package. In most +cases it is better to use \fB--restore\fR instead. +.TP +\fBrpm\fR \fB--setcaps\fR \fIPACKAGE_NAME\fR +sets capabilities of files in the given package. Consider using +\fB--restore\fR instead. +.TP +\fBrpm\fR \fB--restore\fR \fIPACKAGE_NAME\fR +The option restores owner, group, permissions and capabilities of files +in the given package. +.TP +Options \fB--setperms\fR, \fB--setugids\fR, \fB--setcaps\fR and +\fB--restore\fR are mutually exclusive. + +.SS "FTP/HTTP OPTIONS" +.PP +\fBrpm\fR can act as an FTP and/or HTTP client so +that packages can be queried or installed from the internet. +Package files for install, upgrade, and query operations may be +specified as an +\fBftp\fR or +\fBhttp\fR +style URL: +.PP +ftp://USER:PASSWORD@HOST:PORT/path/to/package.rpm +.PP +If the \fB:PASSWORD\fR portion is omitted, the password will be +prompted for (once per user/hostname pair). If both the user and +password are omitted, anonymous \fBftp\fR is used. +In all cases, passive (PASV) \fBftp\fR transfers are +performed. +.PP +\fBrpm\fR allows the following options to be used with +ftp URLs: +.TP +\fB--ftpproxy \fIHOST\fB\fR +The host \fIHOST\fR will be used as a proxy server +for all ftp transfers, which allows users to ftp through firewall +machines which use proxy systems. This option may also be specified +by configuring the macro \fB%_ftpproxy\fR. +.TP +\fB--ftpport \fIPORT\fB\fR +The TCP \fIPORT\fR number to use for +the ftp connection on the proxy ftp server instead of the default +port. This option may also be specified by configuring the macro +\fB%_ftpport\fR. +.PP +\fBrpm\fR allows the following options to be used with +\fBhttp\fR URLs: +.TP +\fB--httpproxy \fIHOST\fB\fR +The host \fIHOST\fR will be used as +a proxy server for all \fBhttp\fR transfers. This +option may also be specified by configuring the macro +\fB%_httpproxy\fR. +.TP +\fB--httpport \fIPORT\fB\fR +The TCP \fIPORT\fR number to use for the +\fBhttp\fR connection on the proxy http server instead +of the default port. This option may also be specified by configuring +the macro \fB%_httpport\fR. +.SH "LEGACY ISSUES" +.SS "Executing rpmbuild" +.PP +The build modes of rpm are now resident in the \fI/usr/bin/rpmbuild\fR +executable. +Install the package containing \fBrpmbuild\fR (usually \fBrpm-build\fR) and see +\fBrpmbuild\fR(8) for documentation of all the \fBrpm\fR build modes. +.SH "FILES" +.SS "rpmrc Configuration" +.PP +.nf +\fI/usr/lib/rpm/rpmrc\fR +\fI/usr/lib/rpm/redhat/rpmrc\fR +\fI/etc/rpmrc\fR +\fI~/.rpmrc\fR +.fi +.SS "Macro Configuration" +.PP +.nf +\fI/usr/lib/rpm/macros\fR +\fI/usr/lib/rpm/redhat/macros\fR +\fI/etc/rpm/macros\fR +\fI~/.rpmmacros\fR +.fi +.SS "Database" +.PP +.nf +\fI/var/lib/rpm/Basenames\fR +\fI/var/lib/rpm/Conflictname\fR +\fI/var/lib/rpm/Dirnames\fR +\fI/var/lib/rpm/Group\fR +\fI/var/lib/rpm/Installtid\fR +\fI/var/lib/rpm/Name\fR +\fI/var/lib/rpm/Obsoletename\fR +\fI/var/lib/rpm/Packages\fR +\fI/var/lib/rpm/Providename\fR +\fI/var/lib/rpm/Requirename\fR +\fI/var/lib/rpm/Sha1header\fR +\fI/var/lib/rpm/Sigmd5\fR +\fI/var/lib/rpm/Triggername\fR +.fi +.SS "Temporary" +.PP +\fI/var/tmp/rpm*\fR +.SH "SEE ALSO" + +.nf +\fBrpm-misc(8), +\fBpopt\fR(3), +\fBrpm2cpio\fR(8), +\fBrpmbuild\fR(8), +\fBrpmdb\fR(8), +\fBrpmkeys\fR(8), +\fBrpmsign\fR(8), +\fBrpmspec\fR(8), +.fi + +\fBrpm --help\fR - as rpm supports customizing the options via popt aliases +it's impossible to guarantee that what's described in the manual matches +what's available. + + +\fBhttp://www.rpm.org/ <URL:http://www.rpm.org/> +\fR +.SH "AUTHORS" + +.nf +Marc Ewing <marc@redhat.com> +Jeff Johnson <jbj@redhat.com> +Erik Troan <ewt@redhat.com> +.fi |