.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RPM" "8" "2026\-10\-04" "RPM 6.1.0"
.PP
.SH NAME
rpm \- RPM Package Manager
.PP
.SH SYNOPSIS
.SS Querying and verifying packages
\fBrpm\fR {\fB\-q\fR|\fB\-\-query\fR} [select\-options] [query\-options] [\fIPACKAGE_FILE\fR .\&.\&.\&] [\fIPACKAGE_NAME\fR .\&.\&.\&]
.PP
\fBrpm\fR {\fB\-V\fR|\fB\-\-verify\fR} [select\-options] [verify\-options] [\fIPACKAGE_NAME\fR .\&.\&.\&]
.PP
.SS Installing, upgrading and removing packages
\fBrpm\fR {\fB\-i\fR|\fB\-\-install\fR} [transaction\-options] [install\-options] \fIPACKAGE_FILE\fR .\&.\&.\&
.PP
\fBrpm\fR {\fB\-U\fR|\fB\-\-upgrade\fR} [transaction\-options] [install\-options] \fIPACKAGE_FILE\fR .\&.\&.\&
.PP
\fBrpm\fR {\fB\-F\fR|\fB\-\-freshen\fR} [transaction\-options] [install\-options] \fIPACKAGE_FILE\fR .\&.\&.\&
.PP
\fBrpm\fR \fB\-\-reinstall\fR [transaction\-options] [install\-options] \fIPACKAGE_FILE\fR .\&.\&.\&
.PP
\fBrpm\fR \fB\-\-restore\fR [transaction\-options] [select\-options] \fIPACKAGE_NAME\fR .\&.\&.\&
.PP
\fBrpm\fR {\fB\-e\fR|\fB\-\-erase\fR} [transaction\-options] [erase\-options] \fIPACKAGE_NAME\fR .\&.\&.\&
.PP
.SS Misc operations
\fBrpm\fR \fB\-\-querytags\fR
.PP
See \fBrpm\-common\fR(8) for operations common to all rpm executables.\&
.PP
.SH DESCRIPTION
\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
.SH OPERATIONS
.SS Querying and verifying packages
\fB\-V\fR,
\fB\-\-verify\fR
.RS 4
Verify package(s), comparing information about the installed files in
the package with information about the files taken from the package
metadata stored in the \fBrpm\fR database.\& Among other things, verifying
compares the size, digest, permissions, type, owner and group of each
file.\& Any discrepancies are displayed.\&
.RE
\fB\-q\fR,
\fB\-\-query\fR
.RS 4
Query package files or installed package(s).\&
.PP
.RE
.SS Installing, upgrading and removing packages
\fB\-i\fR,
\fB\-\-install\fR
.RS 4
Install new package(s) without considering upgrade scenarios.\&
This is considered special usage, normally installations should
be done with \fB\-\-upgrade\fR.\&
.PP
.RE
\fB\-U\fR,
\fB\-\-upgrade\fR
.RS 4
Install or upgrade package(s) to a newer version.\& Old and/or
obsoleted package(s) are removed after the new package is installed.\&
.PP
.RE
\fB\-F\fR,
\fB\-\-freshen\fR
.RS 4
Upgrade package(s), but only ones for which an earlier version
is installed.\&
.PP
.RE
\fB\-\-reinstall\fR
.RS 4
Reinstall previously installed package(s).\&
.PP
.RE
\fB\-\-restore\fR
.RS 4
Restore file metadata such as timestamp, owner, group,
permissions and capabilities of files of installed package(s).\&
.PP
.RE
\fB\-e\fR,
\fB\-\-erase\fR
.RS 4
Erase installed packages.\&
.PP
.RE
.SS Misc operations
\fB\-\-querytags\fR
.RS 4
Dump known querytags.\& Useful with the \fB\-\-queryformat\fR option.\&
.PP
.RE
.SS Obsolete compatibility aliases
These are obsolete \fBpopt\fR(3) aliases for backwards compatibility only,
and their use is discouraged.\&
.PP
\fB\-\-initdb\fR,
\fB\-\-rebuilddb\fR,
\fB\-\-verifydb\fR
.RS 4
See \fBrpmdb\fR(8).\&
.PP
.RE
\fB\-\-addsign\fR,
\fB\-\-delsign\fR,
\fB\-\-resign\fR
.RS 4
See \fBrpmsign\fR(1).\&
.PP
.RE
\fB\-K\fR,
\fB\-\-checksig\fR,
\fB\-\-import\fR
.RS 4
See \fBrpmkeys\fR(8).\&
.PP
.RE
\fB\-\-specfile\fR
.RS 4
See \fBrpmspec\fR(1).\&
.PP
.RE
See \fBrpm\-common\fR(8) for the operations common to all rpm executables.\&
.PP
.SH ARGUMENTS
\fIPACKAGE_FILE\fR
.RS 4
Either an \fBrpm\fR package or an \fBrpm\-manifest\fR(5) file.\& May also 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 \fBftp\fR and \fBhttp\fR client support.\&
.PP
.RE
\fIPACKAGE_NAME\fR
.RS 4
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\fR \fIPACKAGE_FILE\fR as an example.\&
.PP
.RE
.SH OPTIONS
See \fBrpm\-common\fR(8) for the options common to all operations.\&
.PP
.SH INSTALL AND UPGRADE OPTIONS
\fB\-\-allfiles\fR
.RS 4
Installs or upgrades all the \fBmissingok\fR files in the package,
regardless if they exist.\&
.PP
.RE
\fB\-\-badreloc\fR
.RS 4
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).\&
.PP
.RE
\fB\-\-excludepath\fR \fIOLDPATH\fR
.RS 4
Don'\&t install files whose name begins with \fIOLDPATH\fR.\&
.PP
.RE
\fB\-\-excludeartifacts\fR
.RS 4
Don'\&t install any files which are marked as artifacts, such as
build\-id links.\&
.PP
.RE
\fB\-\-excludeconfigs\fR, \fB\-\-noconfigs\fR
.RS 4
Do not install configuration files.\&
.PP
.RE
\fB\-\-excludedocs\fR
.RS 4
Don'\&t install any files which are marked as documentation (which
includes man pages and texinfo documents).\&
.PP
.RE
\fB\-\-force\fR
.RS 4
Same as using \fB\-\-replacepkgs\fR, \fB\-\-replacefiles\fR, and
\fB\-\-oldpackage\fR.\&
.PP
.RE
\fB\-\-ignoresize\fR
.RS 4
Don'\&t check mount filesystems for sufficient disk space before
installing this package.\&
.PP
.RE
\fB\-\-ignorearch\fR
.RS 4
Allow installation or upgrading even if the architectures of the
binary package and host don'\&t match.\&
.PP
.RE
\fB\-\-ignoreos\fR
.RS 4
Allow installation or upgrading even if the operating systems of the
binary package and host don'\&t match.\&
.PP
.RE
\fB\-\-includedocs\fR
.RS 4
Install documentation files.\& This is the default behavior.\&
.PP
.RE
\fB\-\-nocontexts\fR
.RS 4
Don'\&t set SELinux contexts for files and scriptlets.\&
Only effective if \fBrpm\-plugin\-selinux\fR(8) is installed
and active.\&
.PP
.RE
\fB\-\-nocaps\fR
.RS 4
Don'\&t set file capabilities.\&
.PP
.RE
\fB\-\-noverify\fR
.RS 4
Don'\&t perform verify package files prior to installation.\&
.PP
.RE
\fB\-\-nosysusers\fR
.RS 4
Don'\&t create \fBrpm\-sysusers\fR(7) from packages
.PP
.RE
\fB\-\-oldpackage\fR
.RS 4
Allow an upgrade to replace a newer package with an older one.\&
.PP
.RE
\fB\-\-prefix\fR \fINEWPATH\fR
.RS 4
For relocatable binary packages, translate all file paths that start
with the installation prefix in the package relocation hint(s) to
\fINEWPATH\fR.\&
.PP
.RE
\fB\-\-relocate\fR \fIOLDPATH\fR=\fINEWPATH\fR
.RS 4
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.\&
.PP
.RE
\fB\-\-replacefiles\fR
.RS 4
Install the packages even if they replace files from other, already
installed, packages.\&
.PP
.RE
\fB\-\-replacepkgs\fR
.RS 4
Install the packages even if some of them are already installed on
this system.\&
.PP
.RE
.SH ERASE OPTIONS
\fB\-\-allmatches\fR
.RS 4
Remove all versions of the package which match \fIPACKAGE_NAME\fR.\&
Normally an error is issued if \fIPACKAGE_NAME\fR matches multiple
packages.\&
.PP
.RE
.SH TRANSACTION OPTIONS
The transaction options are common to \fB\-\-install\fR, \fB\-\-upgrade\fR,
\fB\-\-reinstall\fR and \fB\-\-erase\fR operations.\&
.PP
\fB\-\-deploops\fR
.RS 4
Print dependency loops as warnings.\&
.PP
.RE
\fB\-h\fR, \fB\-\-hash\fR
.RS 4
Print 50 hash marks as the package archive is unpacked.\& Use with
\fB\-v\fR|\fB\-\-verbose\fR for a nicer display.\&
.PP
.RE
\fB\-\-justdb\fR
.RS 4
Update only the database, not the filesystem.\&
.PP
.RE
\fB\-\-nodb\fR
.RS 4
Update only the filesystem, not the database.\&
.PP
.RE
\fB\-\-nodeps\fR
.RS 4
Don'\&t check dependencies before uninstalling the packages.\&
.PP
.RE
\fB\-\-noorder\fR
.RS 4
Don'\&t reorder the packages for an install.\& The list of packages
would normally be reordered to satisfy dependencies.\&
.PP
.RE
\fB\-\-noplugins\fR
.RS 4
Do not load and execute plugins.\&
.PP
.RE
\fB\-\-noscripts\fR
.RS 4
Disables execution of package scriptlets.\& Equivalent to
.PP
\fB\-\-nopre\fR \fB\-\-nopost\fR \fB\-\-nopreun\fR \fB\-\-nopostun\fR
\fB\-\-nopretrans\fR \fB\-\-noposttrans\fR \fB\-\-nopreuntrans\fR \fB\-\-nopostuntrans\fR
.PP
.RE
\fB\-\-nopre\fR
\fB\-\-nopost\fR
\fB\-\-nopreun\fR
\fB\-\-nopostun\fR
\fB\-\-nopretrans\fR
\fB\-\-noposttrans\fR
\fB\-\-nopreuntrans\fR
\fB\-\-nopostuntrans\fR
.RS 4
Don'\&t execute the scriptlets of the named type.\&
.PP
.RE
\fB\-\-notriggers\fR
.RS 4
Disable execution of package triggers.\& Equivalent to
.PP
\fB\-\-notriggerprein\fR \fB\-\-notriggerin\fR \fB\-\-notriggerun\fR
\fB\-\-notriggerpostun\fR
.PP
.RE
\fB\-\-notriggerin\fR
\fB\-\-notriggerun\fR
\fB\-\-notriggerprein\fR
\fB\-\-notriggerpostun\fR
.RS 4
Disable execution of the trigger scriptlets of the named type.\&
.PP
.RE
\fB\-\-percent\fR
.RS 4
Print percentages as files are unpacked from the package archive.\&
This is intended to make \fBrpm\fR easy to run from other tools.\&
.PP
.RE
\fB\-\-test\fR
.RS 4
Don'\&t really execute anything, just go through the motions.\&
Useful in conjunction with the \fB\-vv\fR option for debugging.\&
.PP
.RE
.SH QUERY OPTIONS
\fB\-\-qf\fR \fIQUERYFMT\fR,
\fB\-\-queryformat\fR \fIQUERYFMT\fR
.RS 4
Output format of each queried package, as described by
\fBrpm\-queryformat\fR(7).\& If omitted, uses the format defined by
\fB%_query_all_fmt\fR in \fBrpm\-config\fR(5).\&
.PP
.RE
There are three subsets of options for querying: package selection, file
selection and information selection.\&
.PP
.SH PACKAGE SELECTION OPTIONS
\fB\-a\fR, \fB\-\-all\fR [\fISELECTOR\fR .\&.\&.\&]
.RS 4
Query all installed packages.\&
.PP
Optional \fISELECTOR\fR'\&s 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".\&
.PP
.RE
\fB\-\-dupes\fR
.RS 4
List duplicated packages.\&
.PP
.RE
\fB\-f\fR, \fB\-\-file\fR \fIFILE\fR
.RS 4
Query package owning installed \fIFILE\fR.\&
.PP
.RE
\fB\-\-filecaps\fR
.RS 4
List filenames with POSIX1.\&e capabilities.\&
.PP
.RE
\fB\-\-fileclass\fR
.RS 4
List filenames with their classes (libmagic classification).\&
.PP
.RE
\fB\-\-filecolor\fR
.RS 4
List filenames with their colors (0 for noarch, 1 for 32bit, 2 for
64 bit).\&
.PP
.RE
\fB\-\-fileprovide\fR
.RS 4
List filenames with their provides.\&
.PP
.RE
\fB\-\-filerequire\fR
.RS 4
List filenames with their requires.\&
.PP
.RE
\fB\-g\fR, \fB\-\-group\fR \fIGROUP\fR
.RS 4
Query packages with the group of \fIGROUP\fR.\&
.PP
.RE
\fB\-\-noglob\fR
.RS 4
Do not glob arguments when installing package files.\&
.PP
.RE
\fB\-\-nomanifest\fR
.RS 4
Don'\&t process non\-package files as \fBrpm\-manifest\fR(5) files.\&
.PP
.RE
\fB\-p\fR, \fB\-\-package\fR \fIPACKAGE_FILE\fR
.RS 4
Query an (uninstalled) package \fIPACKAGE_FILE\fR.\&
.PP
.RE
\fB\-\-path\fR \fIPATH\fR
.RS 4
Query package(s) owning \fIPATH\fR, whether the file is installed or not.\&
Multiple packages may own a \fIPATH\fR, but the file is only owned by the
package installed last.\&
.PP
.RE
\fB\-\-querybynumber\fR \fIHDRNUM\fR
.RS 4
Query the \fIHDRNUM\fR database entry directly; this is useful only
for debugging.\&
.PP
.RE
\fB\-\-specfile\fR \fISPECFILE\fR
.RS 4
Obsolete, use \fBrpmspec\fR(1) instead.\&
.PP
.RE
\fB\-\-tid\fR \fITID\fR
.RS 4
Query package(s) that have a given \fITID\fR transaction identifier.\& A
UNIX timestamp is currently used as a transaction identifier.\& All
package(s) installed or erased within a single transaction have a
common identifier.\&
.PP
.RE
\fB\-\-triggeredby\fR \fIPACKAGE_NAME\fR
.RS 4
Query packages that are triggered by package(s) \fIPACKAGE_NAME\fR.\&
.PP
.RE
\fB\-\-whatobsoletes\fR \fICAPABILITY\fR
.RS 4
Query all packages that obsolete \fICAPABILITY\fR for proper
functioning.\&
.PP
.RE
\fB\-\-whatprovides\fR \fICAPABILITY\fR
.RS 4
Query all packages that provide the \fICAPABILITY\fR capability.\&
.PP
.RE
\fB\-\-whatrequires\fR \fICAPABILITY\fR
.RS 4
Query all packages that require \fICAPABILITY\fR for proper functioning.\&
.PP
.RE
\fB\-\-whatconflicts\fR \fICAPABILITY\fR
.RS 4
Query all packages that conflict with \fICAPABILITY\fR.\&
.PP
.RE
\fB\-\-whatrecommends\fR \fICAPABILITY\fR
.RS 4
Query all packages that recommend \fICAPABILITY\fR.\&
.PP
.RE
\fB\-\-whatsuggests\fR \fICAPABILITY\fR
.RS 4
Query all packages that suggest \fICAPABILITY\fR.\&
.PP
.RE
\fB\-\-whatsupplements\fR \fICAPABILITY\fR
.RS 4
Query all packages that supplement \fICAPABILITY\fR.\&
.PP
.RE
\fB\-\-whatenhances\fR \fICAPABILITY\fR
.RS 4
Query all packages that enhance \fICAPABILITY\fR.\&
.PP
.RE
.SH PACKAGE QUERY OPTIONS
.PP
\fB\-\-changelog\fR
.RS 4
Display change information for the package.\&
.PP
.RE
\fB\-\-changes\fR
.RS 4
Display change information for the package with full timestamps.\&
.PP
.RE
\fB\-\-conflicts\fR
.RS 4
List capabilities this package conflicts with.\&
.PP
.RE
\fB\-\-dump\fR
.RS 4
Dump file information as follows (implies \fB\-l\fR):
.PP
path size mtime digest mode owner group isconfig isdoc rdev symlink
.PP
.RE
\fB\-\-enhances\fR
.RS 4
List capabilities enhanced by package(s).\&
.PP
.RE
\fB\-\-filesbypkg\fR
.RS 4
List all the files in each selected package.\&
.PP
.RE
\fB\-\-filetriggers\fR
.RS 4
List filetrigger scriptlets from package(s).\&
.PP
.RE
\fB\-i\fR, \fB\-\-info\fR
.RS 4
Display package information, including name, version, and
description.\& This uses the \fB\-\-queryformat\fR if one was specified.\&
.PP
.RE
\fB\-\-last\fR
.RS 4
Orders the package listing by install time such that the latest
packages are at the top.\&
.PP
.RE
\fB\-l\fR, \fB\-\-list\fR
.RS 4
List files in package.\&
.PP
.RE
\fB\-\-obsoletes\fR
.RS 4
List packages this package obsoletes.\&
.PP
.RE
\fB\-\-provides\fR
.RS 4
List capabilities this package provides.\&
.PP
.RE
\fB\-\-recommends\fR
.RS 4
List capabilities recommended by package(s).\&
.PP
.RE
\fB\-R\fR, \fB\-\-requires\fR
.RS 4
List capabilities on which this package depends.\&
.PP
.RE
\fB\-\-suggests\fR
.RS 4
List capabilities suggested by package(s).\&
.PP
.RE
\fB\-\-supplements\fR
.RS 4
List capabilities supplemented by package(s).\&
.PP
.RE
\fB\-\-scripts\fR
.RS 4
List the package specific scriptlet(s) that are used as part of the
installation and uninstallation processes.\&
.PP
.RE
\fB\-s\fR, \fB\-\-state\fR
.RS 4
Display the \fBstates\fR of files in the package (implies \fB\-l\fR).\& The
state of each file is one of \fBnormal\fR, \fBnot installed\fR, or
\fBreplaced\fR.\&
.PP
.RE
\fB\-\-triggers\fR, \fB\-\-triggerscripts\fR
.RS 4
Display the trigger scripts, if any, which are contained in the
package.\&
.PP
.RE
\fB\-\-xml\fR
.RS 4
Format package headers as XML.\&
.PP
.RE
.SH FILE SELECTION OPTIONS
\fB\-A\fR, \fB\-\-artifactfiles\fR
.RS 4
Only include artifact files (implies \fB\-l\fR).\&
.PP
.RE
\fB\-c\fR, \fB\-\-configfiles\fR
.RS 4
Only include configuration files (implies \fB\-l\fR).\&
.PP
.RE
\fB\-d\fR, \fB\-\-docfiles\fR
.RS 4
Only include documentation files (implies \fB\-l\fR).\&
.PP
.RE
\fB\-L\fR, \fB\-\-licensefiles\fR
.RS 4
Only include license files (implies \fB\-l\fR).\&
.PP
.RE
\fB\-\-noartifact\fR
.RS 4
Exclude artifact files.\&
.PP
.RE
\fB\-\-noconfig\fR
.RS 4
Exclude config files.\&
.PP
.RE
\fB\-\-noghost\fR
.RS 4
Exclude ghost files.\&
.PP
.RE
.SH VERIFY OPTIONS
.PP
The package and file selection options are the same as for package
querying (including \fBrpm\-manifest\fR(5) files as arguments).\&
Other options unique to verify mode are:
.PP
\fB\-\-nodeps\fR
.RS 4
Don'\&t verify dependencies of packages.\&
.PP
.RE
\fB\-\-nodigest\fR
.RS 4
Don'\&t verify package or header digests when reading.\&
.PP
.RE
\fB\-\-nofiles\fR
.RS 4
Don'\&t verify any attributes of package files.\&
.PP
.RE
\fB\-\-noscripts\fR
.RS 4
Don'\&t execute the \fB%verifyscript\fR scriptlet (if any).\&
.PP
.RE
\fB\-\-nosignature\fR
.RS 4
Don'\&t verify package or header signatures when reading.\&
.PP
.RE
\fB\-\-nolinkto\fR
\fB\-\-nofiledigest\fR (formerly \fB\-\-nomd5\fR)
\fB\-\-nosize\fR
\fB\-\-nomtime\fR
\fB\-\-nomode\fR
\fB\-\-nordev\fR
.RS 4
Don'\&t verify the corresponding file attribute.\&
.PP
.RE
\fB\-\-nouser\fR
\fB\-\-nogroup\fR
.RS 4
Don'\&t verify file user/group ownership.\& Note that only local
\fBpasswd\fR(5) and \fBgroup\fR(5) databases are consulted.\&
.PP
.RE
\fB\-\-nocaps\fR
.RS 4
Don'\&t verify file capabilities.\&
.PP
.RE
.SH OUTPUT
\fB\-\-verify\fR
.RS 4
The format of the output is a string of 9 \fIresult\fR characters
a possible \fIattribute\fR from the package, followed by the filename.\&
.PP
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.\&
.PP
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:
.PP
.RE
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBResult\fR
T}	T{
\fBDescription\fR
T}
T{
\fBS\fR
T}	T{
file \fBS\fRize differs
T}
T{
\fBM\fR
T}	T{
\fBM\fRode differs (includes permissions and file type)
T}
T{
\fB5\fR
T}	T{
digest (formerly MD\fB5\fR sum) differs
T}
T{
\fBD\fR
T}	T{
\fBD\fRevice major/minor number mismatch
T}
T{
\fBL\fR
T}	T{
read\fBL\fRink(2) path mismatch
T}
T{
\fBU\fR
T}	T{
\fBU\fRser ownership differs
T}
T{
\fBG\fR
T}	T{
\fBG\fRroup ownership differs
T}
T{
\fBT\fR
T}	T{
m\fBT\fRime differs
T}
T{
\fBP\fR
T}	T{
ca\fBP\fRabilities differ
T}
.TE
.sp 1
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBAttribute\fR
T}	T{
\fBDescription\fR
T}
T{
\fBa\fR
T}	T{
\fB%artifact\fR \- an implicit side\-effect file (eg.\& build\-id links)
T}
T{
\fBc\fR
T}	T{
\fB%config\fRuration file
T}
T{
\fBd\fR
T}	T{
\fB%doc\fRumentation file
T}
T{
\fBg\fR
T}	T{
\fB%ghost\fR file
T}
T{
\fBl\fR
T}	T{
\fB%license\fR file
T}
T{
\fBm\fR
T}	T{
\fB%missingok\fR \- file missing is not a verify failure
T}
T{
\fBn\fR
T}	T{
%config(\fBnoreplace\fR) \- do not replace (a %config file)
T}
T{
\fBr\fR
T}	T{
\fB%readme\fR file
T}
T{
\fBs\fR
T}	T{
\fBrpm\-spec\fR(5) file in a source package
T}
.TE
.sp 1
.PP
.SH EXIT STATUS
On success, 0 is returned, a nonzero failure code otherwise.\&
.PP
.SH EXAMPLES
\fBrpm \-Uvh hello\-2.\&0\-1.\&noarch.\&rpm\fR
.RS 4
Install or upgrade \fIhello\-2.\&0\-1.\&noarch.\&rpm\fR package with verbose output
and progress meters.\& \fB\-Uvh\fR is probably the most common of all
the \fBrpm\fR operations.\&
.PP
.RE
\fBrpm \-Uvh \-\-excludedocs \-\-root /srv/test mydist\-23.\&mft\fR
.RS 4
Install packages described by the \fImydist\-23.\&mft\fR \fBrpm\-manifest\fR(5)
file into the alternative system root at \fI/srv/test\fR, excluding
all documentation files.\&
.PP
.RE
\fBrpm \-Fvh *.\&rpm\fR
.RS 4
Freshen installed packages from a local directory, with verbose
output and progress meters.\&
.PP
.RE
\fBrpm \-i kernel\-6.\&15.\&4\-200.\&x86_64.\&rpm\fR
.RS 4
Install \fIkernel\-6.\&15.\&4\-200.\&x86_64.\&rpm\fR package quietly.\& On some
Linux distributions, different kernel versions are intended to be
installed in parallel like this, \fIwithout\fR erasing older ones to
ensure there'\&s a bootable kernel in case of problems.\& It'\&s one
of the few cases where \fB\-i\fR is the right thing to use.\&
.PP
.RE
\fBrpm \-evh \-\-allmatches libhello\fR
.RS 4
Erase all versions of package \fBlibhello\fR on the system, with
verbose output and progress meters.\& Typically there is only one
version of a package installed at a time, but in some cases it'\&s
possible to have different versions or different architectures
of a package installed in parallel, in which case \fB\-\-allmatches\fR
can be handy.\&
.PP
.RE
\fBrpm \-vh \-\-reinstall hello\-2.\&0\-1.\&noarch.\&rpm\fR
.RS 4
Reinstall previously installed \fIhello\-2.\&0\-1.\&noarch.\&rpm\fR package,
with verbose output and progress labels.\&
Useful if eg.\& the files of a package get corrupted or
erased accidentally.\&
.PP
.RE
\fBrpm \-v \-\-restore \-\-all\fR
.RS 4
Restore permissions of files in all installed packages to their
packaged specifications, with verbose output.\&
.PP
.RE
\fBrpm \-\-verify \-\-noconfig openssh\-server\fR
.RS 4
Verify the integrity of the installed \fBopenssh\-server\fR package,
ignoring changes in configuration.\&
.PP
.RE
\fBrpm \-qa\fR
.RS 4
List all installed packages, using the default formatting.\&
.PP
.RE
\fBrpm \-qlv \-\-noartifact glibc\fR
.RS 4
List the files of the \fBglibc\fR package in style similar to
\fBls\fR(1) command output with \fBls \-l\fR, omitting "artifact" files
such as build\-id'\&s which are not usually the main interest.\&
.PP
.RE
\fBrpm \-q \-\-qf "[%{filenames} %{filedigests}\en]" openssh\-server\fR
.RS 4
List filenames and their corresponding digests of installed
\fBopenssh\-server\fR package.\&
.PP
.RE
\fBrpm \-qp \-\-scripts \-\-triggers \-\-filetriggers myserver\-1.\&0\-1.\&x86_64.\&rpm\fR
.RS 4
Show all scriptlets and triggers from the \fImyserver\-1.\&0\-1.\&x86_64.\&rpm\fR
package file.\& Before installing unknown packages, at least do this!\&
.PP
.RE
\fBrpm \-\-target ppc64le \-\-eval "%optflags"\fR
.RS 4
Print the expansion of the \fB%optflags\fR macro for the \fBppc64le\fR
architecture.\&
.PP
.RE
.SH FILES
See \fBrpm\-common\fR(8), \fBrpm\-config\fR(5) and \fBrpm\-rpmrc\fR(5).\&
.PP
.SH SEE ALSO
\fBrpm\-common\fR(8), \fBpopt\fR(3), \fBrpm2cpio\fR(1), \fBrpmbuild\fR(1), \fBrpmdb\fR(8),
\fBrpmkeys\fR(8), \fBrpmsign\fR(1), \fBrpmspec\fR(1), \fBrpm\-queryformat\fR(7)
\fBrpm\-manifest\fR(5) \fBrpm\-version\fR(7) \fBrpm\-plugins\fR(8)
.PP
\fBrpm \-\-help\fR \- as \fBrpm\fR supports customizing the options via popt
aliases it'\&s impossible to guarantee that what'\&s described in the
manual matches what'\&s available.\&
.PP
\fBhttp://www.\&rpm.\&org/\fR