| 1 |
.\" Generated by scdoc 1.11.4 |
| 2 |
.\" Complete documentation for this program is not available as a GNU info page |
| 3 |
.ie \n(.g .ds Aq \(aq |
| 4 |
.el .ds Aq ' |
| 5 |
.nh |
| 6 |
.ad l |
| 7 |
.\" Begin generated content: |
| 8 |
.TH "RPM" "8" "2026-04-10" "RPM 6.0.1" |
| 9 |
.PP |
| 10 |
.SH NAME |
| 11 |
rpm - RPM Package Manager |
| 12 |
.PP |
| 13 |
.SH SYNOPSIS |
| 14 |
.SS Querying and verifying packages |
| 15 |
\fBrpm\fR {\fB-q\fR|\fB--query\fR} [select-options] [query-options] [\fIPACKAGE_FILE\fR .\&.\&.\&] [\fIPACKAGE_NAME\fR .\&.\&.\&] |
| 16 |
.PP |
| 17 |
\fBrpm\fR {\fB-V\fR|\fB--verify\fR} [select-options] [verify-options] [\fIPACKAGE_NAME\fR .\&.\&.\&] |
| 18 |
.PP |
| 19 |
.SS Installing, upgrading and removing packages |
| 20 |
\fBrpm\fR {\fB-i\fR|\fB--install\fR} [transaction-options] [install-options] \fIPACKAGE_FILE\fR .\&.\&.\& |
| 21 |
.PP |
| 22 |
\fBrpm\fR {\fB-U\fR|\fB--upgrade\fR} [transaction-options] [install-options] \fIPACKAGE_FILE\fR .\&.\&.\& |
| 23 |
.PP |
| 24 |
\fBrpm\fR {\fB-F\fR|\fB--freshen\fR} [transaction-options] [install-options] \fIPACKAGE_FILE\fR .\&.\&.\& |
| 25 |
.PP |
| 26 |
\fBrpm\fR \fB--reinstall\fR [transaction-options] [install-options] \fIPACKAGE_FILE\fR .\&.\&.\& |
| 27 |
.PP |
| 28 |
\fBrpm\fR \fB--restore\fR [transaction-options] [select-options] \fIPACKAGE_NAME\fR .\&.\&.\& |
| 29 |
.PP |
| 30 |
\fBrpm\fR {\fB-e\fR|\fB--erase\fR} [transaction-options] [erase-options] \fIPACKAGE_NAME\fR .\&.\&.\& |
| 31 |
.PP |
| 32 |
.SS Misc operations |
| 33 |
\fBrpm\fR \fB--querytags\fR |
| 34 |
.PP |
| 35 |
See \fBrpm-common\fR(8) for operations common to all rpm executables.\& |
| 36 |
.PP |
| 37 |
.SH DESCRIPTION |
| 38 |
\fBrpm\fR is a powerful \fBPackage Manager\fR, which can be used to build, |
| 39 |
install, query, verify, update, and erase individual software packages.\& |
| 40 |
A \fBpackage\fR consists of an archive of files and meta-data used to |
| 41 |
install and erase the archive files.\& The meta-data includes helper |
| 42 |
scripts, file attributes, and descriptive information about the package.\& |
| 43 |
\fBPackages\fR come in two varieties: binary packages, used to encapsulate |
| 44 |
software to be installed, and source packages, containing the source |
| 45 |
code and recipe necessary to produce binary packages.\& |
| 46 |
.PP |
| 47 |
.SH OPERATIONS |
| 48 |
.SS Querying and verifying packages |
| 49 |
\fB-V\fR, |
| 50 |
\fB--verify\fR |
| 51 |
.RS 4 |
| 52 |
Verify package(s), comparing information about the installed files in |
| 53 |
the package with information about the files taken from the package |
| 54 |
metadata stored in the \fBrpm\fR database.\& Among other things, verifying |
| 55 |
compares the size, digest, permissions, type, owner and group of each |
| 56 |
file.\& Any discrepancies are displayed.\& |
| 57 |
.RE |
| 58 |
\fB-q\fR, |
| 59 |
\fB--query\fR |
| 60 |
.RS 4 |
| 61 |
Query package files or installed package(s).\& |
| 62 |
.PP |
| 63 |
.RE |
| 64 |
.SS Installing, upgrading and removing packages |
| 65 |
\fB-i\fR, |
| 66 |
\fB--install\fR |
| 67 |
.RS 4 |
| 68 |
Install new package(s) without considering upgrade scenarios.\& |
| 69 |
This is considered special usage, normally installations should |
| 70 |
be done with \fB--upgrade\fR.\& |
| 71 |
.PP |
| 72 |
.RE |
| 73 |
\fB-U\fR, |
| 74 |
\fB--upgrade\fR |
| 75 |
.RS 4 |
| 76 |
Install or upgrade package(s) to a newer version.\& Old and/or |
| 77 |
obsoleted package(s) are removed after the new package is installed.\& |
| 78 |
.PP |
| 79 |
.RE |
| 80 |
\fB-F\fR, |
| 81 |
\fB--freshen\fR |
| 82 |
.RS 4 |
| 83 |
Upgrade package(s), but only ones for which an earlier version |
| 84 |
is installed.\& |
| 85 |
.PP |
| 86 |
.RE |
| 87 |
\fB--reinstall\fR |
| 88 |
.RS 4 |
| 89 |
Reinstall previously installed package(s).\& |
| 90 |
.PP |
| 91 |
.RE |
| 92 |
\fB--restore\fR |
| 93 |
.RS 4 |
| 94 |
Restore file metadata such as timestamp, owner, group, |
| 95 |
permissions and capabilities of files of installed package(s).\& |
| 96 |
.PP |
| 97 |
.RE |
| 98 |
\fB-e\fR, |
| 99 |
\fB--erase\fR |
| 100 |
.RS 4 |
| 101 |
Erase installed packages.\& |
| 102 |
.PP |
| 103 |
.RE |
| 104 |
.SS Misc operations |
| 105 |
\fB--querytags\fR |
| 106 |
.RS 4 |
| 107 |
Dump known querytags.\& Useful with the \fB--queryformat\fR option.\& |
| 108 |
.PP |
| 109 |
.RE |
| 110 |
.SS Obsolete compatibility aliases |
| 111 |
These are obsolete \fBpopt\fR(3) aliases for backwards compatibility only, |
| 112 |
and their use is discouraged.\& |
| 113 |
.PP |
| 114 |
\fB--initdb\fR, |
| 115 |
\fB--rebuilddb\fR, |
| 116 |
\fB--verifydb\fR |
| 117 |
.RS 4 |
| 118 |
See \fBrpmdb\fR(8).\& |
| 119 |
.PP |
| 120 |
.RE |
| 121 |
\fB--addsign\fR, |
| 122 |
\fB--delsign\fR, |
| 123 |
\fB--resign\fR |
| 124 |
.RS 4 |
| 125 |
See \fBrpmsign\fR(1).\& |
| 126 |
.PP |
| 127 |
.RE |
| 128 |
\fB-K\fR, |
| 129 |
\fB--checksig\fR, |
| 130 |
\fB--import\fR |
| 131 |
.RS 4 |
| 132 |
See \fBrpmkeys\fR(8).\& |
| 133 |
.PP |
| 134 |
.RE |
| 135 |
\fB--specfile\fR |
| 136 |
.RS 4 |
| 137 |
See \fBrpmspec\fR(1).\& |
| 138 |
.PP |
| 139 |
.RE |
| 140 |
See \fBrpm-common\fR(8) for the operations common to all rpm executables.\& |
| 141 |
.PP |
| 142 |
.SH ARGUMENTS |
| 143 |
\fIPACKAGE_FILE\fR |
| 144 |
.RS 4 |
| 145 |
Either an \fBrpm\fR package or an \fBrpm-manifest\fR(5) file.\& May also be |
| 146 |
specified as an \fBftp\fR or \fBhttp\fR URL, in which case the package will |
| 147 |
be downloaded before being installed.\& See \fBFTP/HTTP OPTIONS\fR for |
| 148 |
information on \fBrpm\fR'\&s \fBftp\fR and \fBhttp\fR client support.\& |
| 149 |
.PP |
| 150 |
.RE |
| 151 |
\fIPACKAGE_NAME\fR |
| 152 |
.RS 4 |
| 153 |
Installed package named \fIPACKAGE_NAME\fR.\& To specify the |
| 154 |
package more precisely the package name may be followed by the |
| 155 |
version or version and release both separated by a dash or an |
| 156 |
architecture name separated by a dot.\& See the output of \fBrpm -qa\fR |
| 157 |
or \fBrpm -qp\fR \fIPACKAGE_FILE\fR as an example.\& |
| 158 |
.PP |
| 159 |
.RE |
| 160 |
.SH OPTIONS |
| 161 |
See \fBrpm-common\fR(8) for the options common to all operations.\& |
| 162 |
.PP |
| 163 |
.SH INSTALL AND UPGRADE OPTIONS |
| 164 |
\fB--allfiles\fR |
| 165 |
.RS 4 |
| 166 |
Installs or upgrades all the \fBmissingok\fR files in the package, |
| 167 |
regardless if they exist.\& |
| 168 |
.PP |
| 169 |
.RE |
| 170 |
\fB--badreloc\fR |
| 171 |
.RS 4 |
| 172 |
Used with \fB--relocate\fR, permit relocations on all file paths, not |
| 173 |
just those \fIOLDPATH\fR'\&s included in the binary package relocation |
| 174 |
hint(s).\& |
| 175 |
.PP |
| 176 |
.RE |
| 177 |
\fB--excludepath\fR \fIOLDPATH\fR |
| 178 |
.RS 4 |
| 179 |
Don'\&t install files whose name begins with \fIOLDPATH\fR.\& |
| 180 |
.PP |
| 181 |
.RE |
| 182 |
\fB--excludeartifacts\fR |
| 183 |
.RS 4 |
| 184 |
Don'\&t install any files which are marked as artifacts, such as |
| 185 |
build-id links.\& |
| 186 |
.PP |
| 187 |
.RE |
| 188 |
\fB--excludeconfigs\fR, \fB--noconfigs\fR |
| 189 |
.RS 4 |
| 190 |
Do not install configuration files.\& |
| 191 |
.PP |
| 192 |
.RE |
| 193 |
\fB--excludedocs\fR |
| 194 |
.RS 4 |
| 195 |
Don'\&t install any files which are marked as documentation (which |
| 196 |
includes man pages and texinfo documents).\& |
| 197 |
.PP |
| 198 |
.RE |
| 199 |
\fB--force\fR |
| 200 |
.RS 4 |
| 201 |
Same as using \fB--replacepkgs\fR, \fB--replacefiles\fR, and |
| 202 |
\fB--oldpackage\fR.\& |
| 203 |
.PP |
| 204 |
.RE |
| 205 |
\fB--ignoresize\fR |
| 206 |
.RS 4 |
| 207 |
Don'\&t check mount filesystems for sufficient disk space before |
| 208 |
installing this package.\& |
| 209 |
.PP |
| 210 |
.RE |
| 211 |
\fB--ignorearch\fR |
| 212 |
.RS 4 |
| 213 |
Allow installation or upgrading even if the architectures of the |
| 214 |
binary package and host don'\&t match.\& |
| 215 |
.PP |
| 216 |
.RE |
| 217 |
\fB--ignoreos\fR |
| 218 |
.RS 4 |
| 219 |
Allow installation or upgrading even if the operating systems of the |
| 220 |
binary package and host don'\&t match.\& |
| 221 |
.PP |
| 222 |
.RE |
| 223 |
\fB--includedocs\fR |
| 224 |
.RS 4 |
| 225 |
Install documentation files.\& This is the default behavior.\& |
| 226 |
.PP |
| 227 |
.RE |
| 228 |
\fB--nocontexts\fR |
| 229 |
.RS 4 |
| 230 |
Don'\&t set SELinux contexts for files and scriptlets.\& |
| 231 |
Only effective if \fBrpm-plugin-selinux\fR(8) is installed |
| 232 |
and active.\& |
| 233 |
.PP |
| 234 |
.RE |
| 235 |
\fB--nocaps\fR |
| 236 |
.RS 4 |
| 237 |
Don'\&t set file capabilities.\& |
| 238 |
.PP |
| 239 |
.RE |
| 240 |
\fB--noverify\fR |
| 241 |
.RS 4 |
| 242 |
Don'\&t perform verify package files prior to installation.\& |
| 243 |
.PP |
| 244 |
.RE |
| 245 |
\fB--nosysusers\fR |
| 246 |
.RS 4 |
| 247 |
Don'\&t create sysusers from packages |
| 248 |
.PP |
| 249 |
.RE |
| 250 |
\fB--oldpackage\fR |
| 251 |
.RS 4 |
| 252 |
Allow an upgrade to replace a newer package with an older one.\& |
| 253 |
.PP |
| 254 |
.RE |
| 255 |
\fB--prefix\fR \fINEWPATH\fR |
| 256 |
.RS 4 |
| 257 |
For relocatable binary packages, translate all file paths that start |
| 258 |
with the installation prefix in the package relocation hint(s) to |
| 259 |
\fINEWPATH\fR.\& |
| 260 |
.PP |
| 261 |
.RE |
| 262 |
\fB--relocate\fR \fIOLDPATH\fR=\fINEWPATH\fR |
| 263 |
.RS 4 |
| 264 |
For relocatable binary packages, translate all file paths that start |
| 265 |
with \fIOLDPATH\fR in the package relocation hint(s) to \fINEWPATH\fR.\& This |
| 266 |
option can be used repeatedly if several \fIOLDPATH\fR'\&s in the package |
| 267 |
are to be relocated.\& |
| 268 |
.PP |
| 269 |
.RE |
| 270 |
\fB--replacefiles\fR |
| 271 |
.RS 4 |
| 272 |
Install the packages even if they replace files from other, already |
| 273 |
installed, packages.\& |
| 274 |
.PP |
| 275 |
.RE |
| 276 |
\fB--replacepkgs\fR |
| 277 |
.RS 4 |
| 278 |
Install the packages even if some of them are already installed on |
| 279 |
this system.\& |
| 280 |
.PP |
| 281 |
.RE |
| 282 |
.SH ERASE OPTIONS |
| 283 |
\fB--allmatches\fR |
| 284 |
.RS 4 |
| 285 |
Remove all versions of the package which match \fIPACKAGE_NAME\fR.\& |
| 286 |
Normally an error is issued if \fIPACKAGE_NAME\fR matches multiple |
| 287 |
packages.\& |
| 288 |
.PP |
| 289 |
.RE |
| 290 |
.SH TRANSACTION OPTIONS |
| 291 |
The transaction options are common to \fB--install\fR, \fB--upgrade\fR, |
| 292 |
\fB--reinstall\fR and \fB--erase\fR operations.\& |
| 293 |
.PP |
| 294 |
\fB--deploops\fR |
| 295 |
.RS 4 |
| 296 |
Print dependency loops as warnings.\& |
| 297 |
.PP |
| 298 |
.RE |
| 299 |
\fB-h\fR, \fB--hash\fR |
| 300 |
.RS 4 |
| 301 |
Print 50 hash marks as the package archive is unpacked.\& Use with |
| 302 |
\fB-v\fR|\fB--verbose\fR for a nicer display.\& |
| 303 |
.PP |
| 304 |
.RE |
| 305 |
\fB--justdb\fR |
| 306 |
.RS 4 |
| 307 |
Update only the database, not the filesystem.\& |
| 308 |
.PP |
| 309 |
.RE |
| 310 |
\fB--nodb\fR |
| 311 |
.RS 4 |
| 312 |
Update only the filesystem, not the database.\& |
| 313 |
.PP |
| 314 |
.RE |
| 315 |
\fB--nodeps\fR |
| 316 |
.RS 4 |
| 317 |
Don'\&t check dependencies before uninstalling the packages.\& |
| 318 |
.PP |
| 319 |
.RE |
| 320 |
\fB--noorder\fR |
| 321 |
.RS 4 |
| 322 |
Don'\&t reorder the packages for an install.\& The list of packages |
| 323 |
would normally be reordered to satisfy dependencies.\& |
| 324 |
.PP |
| 325 |
.RE |
| 326 |
\fB--noplugins\fR |
| 327 |
.RS 4 |
| 328 |
Do not load and execute plugins.\& |
| 329 |
.PP |
| 330 |
.RE |
| 331 |
\fB--noscripts\fR |
| 332 |
.RS 4 |
| 333 |
Disables execution of package scriptlets.\& Equivalent to |
| 334 |
.PP |
| 335 |
\fB--nopre\fR \fB--nopost\fR \fB--nopreun\fR \fB--nopostun\fR |
| 336 |
\fB--nopretrans\fR \fB--noposttrans\fR \fB--nopreuntrans\fR \fB--nopostuntrans\fR |
| 337 |
.PP |
| 338 |
.RE |
| 339 |
\fB--nopre\fR |
| 340 |
\fB--nopost\fR |
| 341 |
\fB--nopreun\fR |
| 342 |
\fB--nopostun\fR |
| 343 |
\fB--nopretrans\fR |
| 344 |
\fB--noposttrans\fR |
| 345 |
\fB--nopreuntrans\fR |
| 346 |
\fB--nopostuntrans\fR |
| 347 |
.RS 4 |
| 348 |
Don'\&t execute the scriptlets of the named type.\& |
| 349 |
.PP |
| 350 |
.RE |
| 351 |
\fB--notriggers\fR |
| 352 |
.RS 4 |
| 353 |
Disable execution of package triggers.\& Equivalent to |
| 354 |
.PP |
| 355 |
\fB--notriggerprein\fR \fB--notriggerin\fR \fB--notriggerun\fR |
| 356 |
\fB--notriggerpostun\fR |
| 357 |
.PP |
| 358 |
.RE |
| 359 |
\fB--notriggerin\fR |
| 360 |
\fB--notriggerun\fR |
| 361 |
\fB--notriggerprein\fR |
| 362 |
\fB--notriggerpostun\fR |
| 363 |
.RS 4 |
| 364 |
Disable execution of the trigger scriptlets of the named type.\& |
| 365 |
.PP |
| 366 |
.RE |
| 367 |
\fB--percent\fR |
| 368 |
.RS 4 |
| 369 |
Print percentages as files are unpacked from the package archive.\& |
| 370 |
This is intended to make \fBrpm\fR easy to run from other tools.\& |
| 371 |
.PP |
| 372 |
.RE |
| 373 |
\fB--test\fR |
| 374 |
.RS 4 |
| 375 |
Don'\&t really execute anything, just go through the motions.\& |
| 376 |
Useful in conjunction with the \fB-vv\fR option for debugging.\& |
| 377 |
.PP |
| 378 |
.RE |
| 379 |
.SH QUERY OPTIONS |
| 380 |
\fB--qf\fR \fIQUERYFMT\fR, |
| 381 |
\fB--queryformat\fR \fIQUERYFMT\fR |
| 382 |
.RS 4 |
| 383 |
Output format of each queried package, as described by |
| 384 |
\fBrpm-queryformat\fR(7).\& If omitted, uses the format defined by |
| 385 |
\fB%_query_all_fmt\fR in \fBrpm-config\fR(5).\& |
| 386 |
.PP |
| 387 |
.RE |
| 388 |
There are three subsets of options for querying: package selection, file |
| 389 |
selection and information selection.\& |
| 390 |
.PP |
| 391 |
.SH PACKAGE SELECTION OPTIONS |
| 392 |
\fB-a\fR, \fB--all\fR [\fISELECTOR\fR .\&.\&.\&] |
| 393 |
.RS 4 |
| 394 |
Query all installed packages.\& |
| 395 |
.PP |
| 396 |
Optional \fISELECTOR\fR'\&s in the form of tag=pattern can be provided to |
| 397 |
narrow the selection, for example name="b*" to query packages whose |
| 398 |
name starts with "b".\& |
| 399 |
.PP |
| 400 |
.RE |
| 401 |
\fB--dupes\fR |
| 402 |
.RS 4 |
| 403 |
List duplicated packages.\& |
| 404 |
.PP |
| 405 |
.RE |
| 406 |
\fB-f\fR, \fB--file\fR \fIFILE\fR |
| 407 |
.RS 4 |
| 408 |
Query package owning installed \fIFILE\fR.\& |
| 409 |
.PP |
| 410 |
.RE |
| 411 |
\fB--filecaps\fR |
| 412 |
.RS 4 |
| 413 |
List filenames with POSIX1.\&e capabilities.\& |
| 414 |
.PP |
| 415 |
.RE |
| 416 |
\fB--fileclass\fR |
| 417 |
.RS 4 |
| 418 |
List filenames with their classes (libmagic classification).\& |
| 419 |
.PP |
| 420 |
.RE |
| 421 |
\fB--filecolor\fR |
| 422 |
.RS 4 |
| 423 |
List filenames with their colors (0 for noarch, 1 for 32bit, 2 for |
| 424 |
64 bit).\& |
| 425 |
.PP |
| 426 |
.RE |
| 427 |
\fB--fileprovide\fR |
| 428 |
.RS 4 |
| 429 |
List filenames with their provides.\& |
| 430 |
.PP |
| 431 |
.RE |
| 432 |
\fB--filerequire\fR |
| 433 |
.RS 4 |
| 434 |
List filenames with their requires.\& |
| 435 |
.PP |
| 436 |
.RE |
| 437 |
\fB-g\fR, \fB--group\fR \fIGROUP\fR |
| 438 |
.RS 4 |
| 439 |
Query packages with the group of \fIGROUP\fR.\& |
| 440 |
.PP |
| 441 |
.RE |
| 442 |
\fB--noglob\fR |
| 443 |
.RS 4 |
| 444 |
Do not glob arguments when installing package files.\& |
| 445 |
.PP |
| 446 |
.RE |
| 447 |
\fB--nomanifest\fR |
| 448 |
.RS 4 |
| 449 |
Don'\&t process non-package files as \fBrpm-manifest\fR(5) files.\& |
| 450 |
.PP |
| 451 |
.RE |
| 452 |
\fB-p\fR, \fB--package\fR \fIPACKAGE_FILE\fR |
| 453 |
.RS 4 |
| 454 |
Query an (uninstalled) package \fIPACKAGE_FILE\fR.\& |
| 455 |
.PP |
| 456 |
.RE |
| 457 |
\fB--path\fR \fIPATH\fR |
| 458 |
.RS 4 |
| 459 |
Query package(s) owning \fIPATH\fR, whether the file is installed or not.\& |
| 460 |
Multiple packages may own a \fIPATH\fR, but the file is only owned by the |
| 461 |
package installed last.\& |
| 462 |
.PP |
| 463 |
.RE |
| 464 |
\fB--querybynumber\fR \fIHDRNUM\fR |
| 465 |
.RS 4 |
| 466 |
Query the \fIHDRNUM\fR database entry directly; this is useful only |
| 467 |
for debugging.\& |
| 468 |
.PP |
| 469 |
.RE |
| 470 |
\fB--specfile\fR \fISPECFILE\fR |
| 471 |
.RS 4 |
| 472 |
Obsolete, use \fBrpmspec\fR(1) instead.\& |
| 473 |
.PP |
| 474 |
.RE |
| 475 |
\fB--tid\fR \fITID\fR |
| 476 |
.RS 4 |
| 477 |
Query package(s) that have a given \fITID\fR transaction identifier.\& A |
| 478 |
UNIX timestamp is currently used as a transaction identifier.\& All |
| 479 |
package(s) installed or erased within a single transaction have a |
| 480 |
common identifier.\& |
| 481 |
.PP |
| 482 |
.RE |
| 483 |
\fB--triggeredby\fR \fIPACKAGE_NAME\fR |
| 484 |
.RS 4 |
| 485 |
Query packages that are triggered by package(s) \fIPACKAGE_NAME\fR.\& |
| 486 |
.PP |
| 487 |
.RE |
| 488 |
\fB--whatobsoletes\fR \fICAPABILITY\fR |
| 489 |
.RS 4 |
| 490 |
Query all packages that obsolete \fICAPABILITY\fR for proper |
| 491 |
functioning.\& |
| 492 |
.PP |
| 493 |
.RE |
| 494 |
\fB--whatprovides\fR \fICAPABILITY\fR |
| 495 |
.RS 4 |
| 496 |
Query all packages that provide the \fICAPABILITY\fR capability.\& |
| 497 |
.PP |
| 498 |
.RE |
| 499 |
\fB--whatrequires\fR \fICAPABILITY\fR |
| 500 |
.RS 4 |
| 501 |
Query all packages that require \fICAPABILITY\fR for proper functioning.\& |
| 502 |
.PP |
| 503 |
.RE |
| 504 |
\fB--whatconflicts\fR \fICAPABILITY\fR |
| 505 |
.RS 4 |
| 506 |
Query all packages that conflict with \fICAPABILITY\fR.\& |
| 507 |
.PP |
| 508 |
.RE |
| 509 |
\fB--whatrecommends\fR \fICAPABILITY\fR |
| 510 |
.RS 4 |
| 511 |
Query all packages that recommend \fICAPABILITY\fR.\& |
| 512 |
.PP |
| 513 |
.RE |
| 514 |
\fB--whatsuggests\fR \fICAPABILITY\fR |
| 515 |
.RS 4 |
| 516 |
Query all packages that suggest \fICAPABILITY\fR.\& |
| 517 |
.PP |
| 518 |
.RE |
| 519 |
\fB--whatsupplements\fR \fICAPABILITY\fR |
| 520 |
.RS 4 |
| 521 |
Query all packages that supplement \fICAPABILITY\fR.\& |
| 522 |
.PP |
| 523 |
.RE |
| 524 |
\fB--whatenhances\fR \fICAPABILITY\fR |
| 525 |
.RS 4 |
| 526 |
Query all packages that enhance \fICAPABILITY\fR.\& |
| 527 |
.PP |
| 528 |
.RE |
| 529 |
.SH PACKAGE QUERY OPTIONS |
| 530 |
.PP |
| 531 |
\fB--changelog\fR |
| 532 |
.RS 4 |
| 533 |
Display change information for the package.\& |
| 534 |
.PP |
| 535 |
.RE |
| 536 |
\fB--changes\fR |
| 537 |
.RS 4 |
| 538 |
Display change information for the package with full timestamps.\& |
| 539 |
.PP |
| 540 |
.RE |
| 541 |
\fB--conflicts\fR |
| 542 |
.RS 4 |
| 543 |
List capabilities this package conflicts with.\& |
| 544 |
.PP |
| 545 |
.RE |
| 546 |
\fB--dump\fR |
| 547 |
.RS 4 |
| 548 |
Dump file information as follows (implies \fB-l\fR): |
| 549 |
.PP |
| 550 |
path size mtime digest mode owner group isconfig isdoc rdev symlink |
| 551 |
.PP |
| 552 |
.RE |
| 553 |
\fB--enhances\fR |
| 554 |
.RS 4 |
| 555 |
List capabilities enhanced by package(s).\& |
| 556 |
.PP |
| 557 |
.RE |
| 558 |
\fB--filesbypkg\fR |
| 559 |
.RS 4 |
| 560 |
List all the files in each selected package.\& |
| 561 |
.PP |
| 562 |
.RE |
| 563 |
\fB--filetriggers\fR |
| 564 |
.RS 4 |
| 565 |
List filetrigger scriptlets from package(s).\& |
| 566 |
.PP |
| 567 |
.RE |
| 568 |
\fB-i\fR, \fB--info\fR |
| 569 |
.RS 4 |
| 570 |
Display package information, including name, version, and |
| 571 |
description.\& This uses the \fB--queryformat\fR if one was specified.\& |
| 572 |
.PP |
| 573 |
.RE |
| 574 |
\fB--last\fR |
| 575 |
.RS 4 |
| 576 |
Orders the package listing by install time such that the latest |
| 577 |
packages are at the top.\& |
| 578 |
.PP |
| 579 |
.RE |
| 580 |
\fB-l\fR, \fB--list\fR |
| 581 |
.RS 4 |
| 582 |
List files in package.\& |
| 583 |
.PP |
| 584 |
.RE |
| 585 |
\fB--obsoletes\fR |
| 586 |
.RS 4 |
| 587 |
List packages this package obsoletes.\& |
| 588 |
.PP |
| 589 |
.RE |
| 590 |
\fB--provides\fR |
| 591 |
.RS 4 |
| 592 |
List capabilities this package provides.\& |
| 593 |
.PP |
| 594 |
.RE |
| 595 |
\fB--recommends\fR |
| 596 |
.RS 4 |
| 597 |
List capabilities recommended by package(s).\& |
| 598 |
.PP |
| 599 |
.RE |
| 600 |
\fB-R\fR, \fB--requires\fR |
| 601 |
.RS 4 |
| 602 |
List capabilities on which this package depends.\& |
| 603 |
.PP |
| 604 |
.RE |
| 605 |
\fB--suggests\fR |
| 606 |
.RS 4 |
| 607 |
List capabilities suggested by package(s).\& |
| 608 |
.PP |
| 609 |
.RE |
| 610 |
\fB--supplements\fR |
| 611 |
.RS 4 |
| 612 |
List capabilities supplemented by package(s).\& |
| 613 |
.PP |
| 614 |
.RE |
| 615 |
\fB--scripts\fR |
| 616 |
.RS 4 |
| 617 |
List the package specific scriptlet(s) that are used as part of the |
| 618 |
installation and uninstallation processes.\& |
| 619 |
.PP |
| 620 |
.RE |
| 621 |
\fB-s\fR, \fB--state\fR |
| 622 |
.RS 4 |
| 623 |
Display the \fBstates\fR of files in the package (implies \fB-l\fR).\& The |
| 624 |
state of each file is one of \fBnormal\fR, \fBnot installed\fR, or |
| 625 |
\fBreplaced\fR.\& |
| 626 |
.PP |
| 627 |
.RE |
| 628 |
\fB--triggers\fR, \fB--triggerscripts\fR |
| 629 |
.RS 4 |
| 630 |
Display the trigger scripts, if any, which are contained in the |
| 631 |
package.\& |
| 632 |
.PP |
| 633 |
.RE |
| 634 |
\fB--xml\fR |
| 635 |
.RS 4 |
| 636 |
Format package headers as XML.\& |
| 637 |
.PP |
| 638 |
.RE |
| 639 |
.SH FILE SELECTION OPTIONS |
| 640 |
\fB-A\fR, \fB--artifactfiles\fR |
| 641 |
.RS 4 |
| 642 |
Only include artifact files (implies \fB-l\fR).\& |
| 643 |
.PP |
| 644 |
.RE |
| 645 |
\fB-c\fR, \fB--configfiles\fR |
| 646 |
.RS 4 |
| 647 |
Only include configuration files (implies \fB-l\fR).\& |
| 648 |
.PP |
| 649 |
.RE |
| 650 |
\fB-d\fR, \fB--docfiles\fR |
| 651 |
.RS 4 |
| 652 |
Only include documentation files (implies \fB-l\fR).\& |
| 653 |
.PP |
| 654 |
.RE |
| 655 |
\fB-L\fR, \fB--licensefiles\fR |
| 656 |
.RS 4 |
| 657 |
Only include license files (implies \fB-l\fR).\& |
| 658 |
.PP |
| 659 |
.RE |
| 660 |
\fB--noartifact\fR |
| 661 |
.RS 4 |
| 662 |
Exclude artifact files.\& |
| 663 |
.PP |
| 664 |
.RE |
| 665 |
\fB--noconfig\fR |
| 666 |
.RS 4 |
| 667 |
Exclude config files.\& |
| 668 |
.PP |
| 669 |
.RE |
| 670 |
\fB--noghost\fR |
| 671 |
.RS 4 |
| 672 |
Exclude ghost files.\& |
| 673 |
.PP |
| 674 |
.RE |
| 675 |
.SH VERIFY OPTIONS |
| 676 |
.PP |
| 677 |
The package and file selection options are the same as for package |
| 678 |
querying (including \fBrpm-manifest\fR(5) files as arguments).\& |
| 679 |
Other options unique to verify mode are: |
| 680 |
.PP |
| 681 |
\fB--nodeps\fR |
| 682 |
.RS 4 |
| 683 |
Don'\&t verify dependencies of packages.\& |
| 684 |
.PP |
| 685 |
.RE |
| 686 |
\fB--nodigest\fR |
| 687 |
.RS 4 |
| 688 |
Don'\&t verify package or header digests when reading.\& |
| 689 |
.PP |
| 690 |
.RE |
| 691 |
\fB--nofiles\fR |
| 692 |
.RS 4 |
| 693 |
Don'\&t verify any attributes of package files.\& |
| 694 |
.PP |
| 695 |
.RE |
| 696 |
\fB--noscripts\fR |
| 697 |
.RS 4 |
| 698 |
Don'\&t execute the \fB%verifyscript\fR scriptlet (if any).\& |
| 699 |
.PP |
| 700 |
.RE |
| 701 |
\fB--nosignature\fR |
| 702 |
.RS 4 |
| 703 |
Don'\&t verify package or header signatures when reading.\& |
| 704 |
.PP |
| 705 |
.RE |
| 706 |
\fB--nolinkto\fR |
| 707 |
\fB--nofiledigest\fR (formerly \fB--nomd5\fR) |
| 708 |
\fB--nosize\fR |
| 709 |
\fB--nomtime\fR |
| 710 |
\fB--nomode\fR |
| 711 |
\fB--nordev\fR |
| 712 |
.RS 4 |
| 713 |
Don'\&t verify the corresponding file attribute.\& |
| 714 |
.PP |
| 715 |
.RE |
| 716 |
\fB--nouser\fR |
| 717 |
\fB--nogroup\fR |
| 718 |
.RS 4 |
| 719 |
Don'\&t verify file user/group ownership.\& Note that only local |
| 720 |
\fBpasswd\fR(5) and \fBgroup\fR(5) databases are consulted.\& |
| 721 |
.PP |
| 722 |
.RE |
| 723 |
\fB--nocaps\fR |
| 724 |
.RS 4 |
| 725 |
Don'\&t verify file capabilities.\& |
| 726 |
.PP |
| 727 |
.RE |
| 728 |
.SH OUTPUT |
| 729 |
\fB--verify\fR |
| 730 |
.RS 4 |
| 731 |
The format of the output is a string of 9 \fIresult\fR characters |
| 732 |
a possible \fIattribute\fR from the package, followed by the filename.\& |
| 733 |
.PP |
| 734 |
Each of the 9 characters denotes the result of a comparison of |
| 735 |
attribute(s) of the file to the value of those attribute(s) |
| 736 |
recorded in the database.\& |
| 737 |
.PP |
| 738 |
A single "\fB.\&\fR" (period) means the test passed, while a single |
| 739 |
"\fB?\&\fR" (question mark) indicates the test could not be performed |
| 740 |
(e.\&g.\& file permissions prevent reading).\& Otherwise, the (mnemonically |
| 741 |
em\fBB\fRoldened) character denotes failure of the corresponding |
| 742 |
\fB--verify\fR test: |
| 743 |
.PP |
| 744 |
.RE |
| 745 |
.TS |
| 746 |
l lx |
| 747 |
l lx |
| 748 |
l lx |
| 749 |
l lx |
| 750 |
l lx |
| 751 |
l lx |
| 752 |
l lx |
| 753 |
l lx |
| 754 |
l lx |
| 755 |
l lx. |
| 756 |
T{ |
| 757 |
\fBResult\fR |
| 758 |
T} T{ |
| 759 |
\fBDescription\fR |
| 760 |
T} |
| 761 |
T{ |
| 762 |
\fBS\fR |
| 763 |
T} T{ |
| 764 |
file \fBS\fRize differs |
| 765 |
T} |
| 766 |
T{ |
| 767 |
\fBM\fR |
| 768 |
T} T{ |
| 769 |
\fBM\fRode differs (includes permissions and file type) |
| 770 |
T} |
| 771 |
T{ |
| 772 |
\fB5\fR |
| 773 |
T} T{ |
| 774 |
digest (formerly MD\fB5\fR sum) differs |
| 775 |
T} |
| 776 |
T{ |
| 777 |
\fBD\fR |
| 778 |
T} T{ |
| 779 |
\fBD\fRevice major/minor number mismatch |
| 780 |
T} |
| 781 |
T{ |
| 782 |
\fBL\fR |
| 783 |
T} T{ |
| 784 |
read\fBL\fRink(2) path mismatch |
| 785 |
T} |
| 786 |
T{ |
| 787 |
\fBU\fR |
| 788 |
T} T{ |
| 789 |
\fBU\fRser ownership differs |
| 790 |
T} |
| 791 |
T{ |
| 792 |
\fBG\fR |
| 793 |
T} T{ |
| 794 |
\fBG\fRroup ownership differs |
| 795 |
T} |
| 796 |
T{ |
| 797 |
\fBT\fR |
| 798 |
T} T{ |
| 799 |
m\fBT\fRime differs |
| 800 |
T} |
| 801 |
T{ |
| 802 |
\fBP\fR |
| 803 |
T} T{ |
| 804 |
ca\fBP\fRabilities differ |
| 805 |
T} |
| 806 |
.TE |
| 807 |
.sp 1 |
| 808 |
.TS |
| 809 |
l lx |
| 810 |
l lx |
| 811 |
l lx |
| 812 |
l lx |
| 813 |
l lx |
| 814 |
l lx |
| 815 |
l lx |
| 816 |
l lx |
| 817 |
l lx |
| 818 |
l lx. |
| 819 |
T{ |
| 820 |
\fBAttribute\fR |
| 821 |
T} T{ |
| 822 |
\fBDescription\fR |
| 823 |
T} |
| 824 |
T{ |
| 825 |
\fBa\fR |
| 826 |
T} T{ |
| 827 |
\fB%artifact\fR - an implicit side-effect file (eg.\& build-id links) |
| 828 |
T} |
| 829 |
T{ |
| 830 |
\fBc\fR |
| 831 |
T} T{ |
| 832 |
\fB%config\fRuration file |
| 833 |
T} |
| 834 |
T{ |
| 835 |
\fBd\fR |
| 836 |
T} T{ |
| 837 |
\fB%doc\fRumentation file |
| 838 |
T} |
| 839 |
T{ |
| 840 |
\fBg\fR |
| 841 |
T} T{ |
| 842 |
\fB%ghost\fR file |
| 843 |
T} |
| 844 |
T{ |
| 845 |
\fBl\fR |
| 846 |
T} T{ |
| 847 |
\fB%license\fR file |
| 848 |
T} |
| 849 |
T{ |
| 850 |
\fBm\fR |
| 851 |
T} T{ |
| 852 |
\fB%missingok\fR - file missing is not a verify failure |
| 853 |
T} |
| 854 |
T{ |
| 855 |
\fBn\fR |
| 856 |
T} T{ |
| 857 |
%config(\fBnoreplace\fR) - do not replace (a %config file) |
| 858 |
T} |
| 859 |
T{ |
| 860 |
\fBr\fR |
| 861 |
T} T{ |
| 862 |
\fB%readme\fR file |
| 863 |
T} |
| 864 |
T{ |
| 865 |
\fBs\fR |
| 866 |
T} T{ |
| 867 |
\fBrpm-spec\fR(5) file in a source package |
| 868 |
T} |
| 869 |
.TE |
| 870 |
.sp 1 |
| 871 |
.PP |
| 872 |
.SH EXIT STATUS |
| 873 |
On success, 0 is returned, a nonzero failure code otherwise.\& |
| 874 |
.PP |
| 875 |
.SH EXAMPLES |
| 876 |
\fBrpm -Uvh hello-2.\&0-1.\&noarch.\&rpm\fR |
| 877 |
.RS 4 |
| 878 |
Install or upgrade \fIhello-2.\&0-1.\&noarch.\&rpm\fR package with verbose output |
| 879 |
and progress meters.\& \fB-Uvh\fR is probably the most common of all |
| 880 |
the \fBrpm\fR operations.\& |
| 881 |
.PP |
| 882 |
.RE |
| 883 |
\fBrpm -Uvh --excludedocs --root /srv/test mydist-23.\&mft\fR |
| 884 |
.RS 4 |
| 885 |
Install packages described by the \fImydist-23.\&mft\fR \fBrpm-manifest\fR(5) |
| 886 |
file into the alternative system root at \fI/srv/test\fR, excluding |
| 887 |
all documentation files.\& |
| 888 |
.PP |
| 889 |
.RE |
| 890 |
\fBrpm -Fvh *.\&rpm\fR |
| 891 |
.RS 4 |
| 892 |
Freshen installed packages from a local directory, with verbose |
| 893 |
output and progress meters.\& |
| 894 |
.PP |
| 895 |
.RE |
| 896 |
\fBrpm -i kernel-6.\&15.\&4-200.\&x86_64.\&rpm\fR |
| 897 |
.RS 4 |
| 898 |
Install \fIkernel-6.\&15.\&4-200.\&x86_64.\&rpm\fR package quietly.\& On some |
| 899 |
Linux distributions, different kernel versions are intended to be |
| 900 |
installed in parallel like this, \fIwithout\fR erasing older ones to |
| 901 |
ensure there'\&s a bootable kernel in case of problems.\& It'\&s one |
| 902 |
of the few cases where \fB-i\fR is the right thing to use.\& |
| 903 |
.PP |
| 904 |
.RE |
| 905 |
\fBrpm -evh --allmatches libhello\fR |
| 906 |
.RS 4 |
| 907 |
Erase all versions of package \fBlibhello\fR on the system, with |
| 908 |
verbose output and progress meters.\& Typically there is only one |
| 909 |
version of a package installed at a time, but in some cases it'\&s |
| 910 |
possible to have different versions or different architectures |
| 911 |
of a package installed in parallel, in which case \fB--allmatches\fR |
| 912 |
can be handy.\& |
| 913 |
.PP |
| 914 |
.RE |
| 915 |
\fBrpm -vh --reinstall hello-2.\&0-1.\&noarch.\&rpm\fR |
| 916 |
.RS 4 |
| 917 |
Reinstall previously installed \fIhello-2.\&0-1.\&noarch.\&rpm\fR package, |
| 918 |
with verbose output and progress labels.\& |
| 919 |
Useful if eg.\& the files of a package get corrupted or |
| 920 |
erased accidentally.\& |
| 921 |
.PP |
| 922 |
.RE |
| 923 |
\fBrpm -v --restore --all\fR |
| 924 |
.RS 4 |
| 925 |
Restore permissions of files in all installed packages to their |
| 926 |
packaged specifications, with verbose output.\& |
| 927 |
.PP |
| 928 |
.RE |
| 929 |
\fBrpm --verify --noconfig openssh-server\fR |
| 930 |
.RS 4 |
| 931 |
Verify the integrity of the installed \fBopenssh-server\fR package, |
| 932 |
ignoring changes in configuration.\& |
| 933 |
.PP |
| 934 |
.RE |
| 935 |
\fBrpm -qa\fR |
| 936 |
.RS 4 |
| 937 |
List all installed packages, using the default formatting.\& |
| 938 |
.PP |
| 939 |
.RE |
| 940 |
\fBrpm -qlv --noartifact glibc\fR |
| 941 |
.RS 4 |
| 942 |
List the files of the \fBglibc\fR package in style similar to |
| 943 |
\fBls\fR(1) command output with \fBls -l\fR, omitting "artifact" files |
| 944 |
such as build-id'\&s which are not usually the main interest.\& |
| 945 |
.PP |
| 946 |
.RE |
| 947 |
\fBrpm -q --qf "[%{filenames} %{filedigests}\en]" openssh-server\fR |
| 948 |
.RS 4 |
| 949 |
List filenames and their corresponding digests of installed |
| 950 |
\fBopenssh-server\fR package.\& |
| 951 |
.PP |
| 952 |
.RE |
| 953 |
\fBrpm -qp --scripts --triggers --filetriggers myserver-1.\&0-1.\&x86_64.\&rpm\fR |
| 954 |
.RS 4 |
| 955 |
Show all scriptlets and triggers from the \fImyserver-1.\&0-1.\&x86_64.\&rpm\fR |
| 956 |
package file.\& Before installing unknown packages, at least do this!\& |
| 957 |
.PP |
| 958 |
.RE |
| 959 |
\fBrpm --target ppc64le --eval "%optflags"\fR |
| 960 |
.RS 4 |
| 961 |
Print the expansion of the \fB%optflags\fR macro for the \fBppc64le\fR |
| 962 |
architecture.\& |
| 963 |
.PP |
| 964 |
.RE |
| 965 |
.SH FILES |
| 966 |
See \fBrpm-common\fR(8), \fBrpm-config\fR(5) and \fBrpm-rpmrc\fR(5).\& |
| 967 |
.PP |
| 968 |
.SH SEE ALSO |
| 969 |
\fBrpm-common\fR(8), \fBpopt\fR(3), \fBrpm2cpio\fR(1), \fBrpmbuild\fR(1), \fBrpmdb\fR(8), |
| 970 |
\fBrpmkeys\fR(8), \fBrpmsign\fR(1), \fBrpmspec\fR(1), \fBrpm-queryformat\fR(7) |
| 971 |
\fBrpm-manifest\fR(5) \fBrpm-version\fR(7) \fBrpm-plugins\fR(8) |
| 972 |
.PP |
| 973 |
\fBrpm --help\fR - as \fBrpm\fR supports customizing the options via popt |
| 974 |
aliases it'\&s impossible to guarantee that what'\&s described in the |
| 975 |
manual matches what'\&s available.\& |
| 976 |
.PP |
| 977 |
\fBhttp://www.\&rpm.\&org/\fR |