Debian Codegraph @

upstream/debian-unstable/man8/rpm.8

raw
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