diff options
Diffstat (limited to 'doc/rpm.8')
| -rw-r--r-- | doc/rpm.8 | 214 |
1 files changed, 157 insertions, 57 deletions
@@ -13,15 +13,10 @@ rpm \- RPM Package Manager \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] - - -\fBrpm\fR [\fB--nosignature\fR] [\fB--nodigest\fR] - \fB\fIPACKAGE_FILE\fB\fR\fI ...\fR - .SS "INSTALLING, UPGRADING, AND REMOVING PACKAGES:" .PP @@ -38,38 +33,51 @@ rpm \- RPM Package Manager -\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--nodeps\fR] [\fB--noscripts\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--querytags|--showrc\fR} - - +\fBrpm\fR \fB--setperms\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR -\fBrpm\fR {\fB--setperms|--setugids\fR} \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR +\fBrpm\fR \fB--setugids\fR \fB\fIPACKAGE_NAME\fB\fR\fI ...\fR .SS "select-options" .PP - [\fB\fIPACKAGE_NAME\fB\fR] [\fB-a,--all\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] .SS "query-options" .PP - - - [\fB--changelog\fR] [\fB-c,--configfiles\fR] [\fB--conflicts\fR] - [\fB-d,--docfiles\fR] [\fB--dump\fR] [\fB--filesbypkg\fR] [\fB-i,--info\fR] - [\fB--last\fR] [\fB-l,--list\fR] [\fB--obsoletes\fR] [\fB--provides\fR] - [\fB--qf,--queryformat \fIQUERYFMT\fB\fR] [\fB-R,--requires\fR] - [\fB--scripts\fR] [\fB-s,--state\fR] [\fB--triggers,--triggerscripts\fR] +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 @@ -88,9 +96,10 @@ rpm \- RPM Package Manager [\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--nocollections\fR] - [\fB--nodeps\fR] [\fB--nodigest\fR] [\fB--nosignature\fR] - [\fB--noorder\fR] [\fB--noscripts\fR] [\fB--notriggers\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] @@ -113,7 +122,7 @@ packages. One of the following basic modes must be selected: \fBQuery\fR, \fBVerify\fR, -\fBInstall/Upgrade/Freshen\fR, +\fBInstall/Upgrade/Freshen/Reinstall\fR, \fBUninstall\fR, \fBSet Owners/Groups\fR, \fBShow Querytags\fR, and @@ -133,7 +142,7 @@ being used. Print as little as possible - normally only error messages will be displayed. .TP -\fB-v\fR +\fB-v, --verbose\fR Print verbose information - normally routine progress messages will be displayed. .TP @@ -141,14 +150,25 @@ displayed. Print lots of ugly debugging information. .TP \fB--rcfile \fIFILELIST\fB\fR -Each of the files in the colon separated +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. +\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. @@ -175,6 +195,9 @@ 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 @@ -209,6 +232,13 @@ new package is installed. 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, @@ -268,19 +298,17 @@ Don't verify package or header signatures when reading. 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--noscripts\fR -.TP -\fB--nopre\fR +\fB--noplugins\fR +Do not load and execute plugins. .TP -\fB--nopost\fR -.TP -\fB--nopreun\fR -.TP -\fB--nopostun\fR +\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 @@ -288,23 +316,20 @@ The \fB--noscripts\fR option is equivalent to \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, and +\fB%preun\fR, \fB%postun\fR +\fB%pretrans\fR, and +\fB%posttrans\fR scriptlet(s). + .TP -\fB--notriggers\fR -.TP -\fB--notriggerin\fR -.TP -\fB--notriggerun\fR -.TP -\fB--notriggerprein\fR -.TP -\fB--notriggerpostun\fR +\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 @@ -357,7 +382,7 @@ potential conflicts. The general form of an rpm erase command is .PP -\fBrpm\fR {\fB-e|--erase\fR} [\fB--allmatches\fR] [\fB--nodeps\fR] [\fB--noscripts\fR] [\fB--notriggers\fR] [\fB--test\fR] \fB\fIPACKAGE_NAME\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 .PP The following options may also be used: @@ -368,14 +393,13 @@ Remove all versions of the package which match 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 -.TP -\fB--nopreun\fR -.TP -\fB--nopostun\fR +\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 @@ -388,11 +412,7 @@ and turns off the execution of the corresponding \fB%postun\fR scriptlet(s). .TP -\fB--notriggers\fR -.TP -\fB--notriggerun\fR -.TP -\fB--notriggerpostun\fR +\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 @@ -508,14 +528,34 @@ and information selection. .PP .TP \fB\fIPACKAGE_NAME\fB\fR -Query installed package named \fIPACKAGE_NAME\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\fR Query all installed packages. .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 @@ -573,12 +613,30 @@ 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. +.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 @@ -599,9 +657,15 @@ 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. @@ -622,9 +686,18 @@ List packages this package obsoletes. \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. @@ -639,6 +712,18 @@ Display the \fIstates\fR of files in the package \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 @@ -670,6 +755,12 @@ Don't verify package or header digests when reading. \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 @@ -692,6 +783,9 @@ Don't verify package or header signatures when reading. .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: @@ -742,7 +836,12 @@ configuration file(s). sets permissions of files in the given package. .TP \fBrpm\fR \fB--setugids\fR \fIPACKAGE_NAME\fR -sets user/group ownership of files in the given package. +sets user/group ownership of files in the given package. This command can +change permissions of files in that package. It is caused by calling command +\fBchmod\fR that can clear SUID and SGID bits in some situations. So it is +safer to call also \fB--setperms\fR after calling \fB--setugids\fR. +.TP +Options \fB--setperms\fR and \fB--setugids\fR are mutually exclusive. .SS "FTP/HTTP OPTIONS" .PP @@ -838,6 +937,7 @@ Install the package containing \fBrpmbuild\fR (usually \fBrpm-build\fR) and see .SH "SEE ALSO" .nf +\fBrpm-misc(8)\fR(3), \fBpopt\fR(3), \fBrpm2cpio\fR(8), \fBrpmbuild\fR(8), |