head 1.1; branch 1.1.1; access ; symbols MAXIMUM_RPM_1_0:1.1.1.1 VENDOR:1.1.1; locks ; strict; comment @# @; 1.1 date 2001.08.28.12.07.09; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2001.08.28.12.07.09; author rse; state Exp; branches ; next ; desc @@ 1.1 log @Initial revision @ text @ Concise RPM Command Reference RPM command reference Global Options RPM command reference global options The following options can be used in any of RPM's modes: --quiet — Print as little output as possible. -v — Be a little more verbose. -vv — Be incredibly verbose (for debugging). --root <dir> — Use <dir> as the top level directory. --dbpath <dir> — Use <dir> as the directory for the database. --rcfile <file> — Use <file> instead of /etc/rpmrc and $HOME/.rpmrc. Informational Options RPM command reference informational options The following options are used to display information about RPM: Format: rpm <option> --version — Print the version of rpm being used. --help — Print a help message. --showrc — Show rcfile information. --querytags — List the tags that can be used with --queryformat. Query Mode RPM command reference query mode RPM's query mode is used to display information about packages: Format: rpm --query <options> or Format: rpm -q <options> Package Specification Options To Query Mode No more than one of the following options may be present in every query command. They are used to select the source of the information to be displayed. <packagename> — Query the named package. -a — Query all packages. -f <file>+ — Query package owning <file>. -g <group>+ — Query packages with group <group>. -p <packagefile>+ — Query (uninstalled) package <packagefile>. --whatprovides <i> — Query packages that provide <i> capability. --whatrequires <i> — Query packages that require <i> capability. Information Selection Options To Query Mode One or more of the following options may be added to any query command. They are used to select what information RPM will display. If no information selection option is present on the command line, RPM will simply display the applicable package label(s): -i — Display package information. -l — Display package file list. -s — Show file states (implies -l). -d — List only documentation files (implies -l). -c — List only configuration files (implies -l). --dump — Show all available information for each file (must be used with -l, -c, or -d). --provides — List capabilities that the package provides. --requires, -R — List capabilities that the package requires. --scripts — Print the various [un]install, verification scripts. --queryformat <s> — Use <s> as the header format (implies -i). --qf <s> — Shorthand for --queryformat. Verify Mode RPM command reference verify mode RPM's verification mode is used to ensure that a package is still installed properly: Format: rpm --verify <options> or Format: rpm -V <options> or Format: rpm -y <options> Options To Verify Mode The following options can be used on any verify command: --nodeps — Do not verify package dependencies. --nofiles — Do not verify file attributes. --noscripts — Do not execute the package's verification script. Install Mode RPM command reference install mode RPM's installation mode is used to install packages: Format: rpm --install <packagefile> or Format: rpm -i <packagefile> Options To Install Mode The following options can be used on any install command: -h, --hash — Print hash marks as package installs (good with -v). --prefix <dir> — Relocate the package to <dir>, if relocatable. --excludedocs — Do not install documentation. --force — Shorthand for --replacepkgs and --replacefiles. --ignorearch — Do not verify package architecture. --ignoreos — Do not verify package operating system. --includedocs — Install documentation. --nodeps — Do not check package dependencies. --noscripts — Do not execute any installation scripts. --percent — Print percentages as package installs. --replacefiles — Install even if the package replaces installed files. --replacepkgs — Reinstall if the package is already present. --test — Do not install, but tell if it would work or not. Upgrade Mode RPM command reference upgrade mode RPM's upgrade mode is used to upgrade packages: Format: rpm --upgrade <packagefile> or Format: rpm -U <packagefile> Options To Upgrade Mode The following options can be used on any upgrade command: -h, --hash — Print hash marks as package installs (good with -v). --prefix <dir> — Relocate the package to <dir>, if relocatable. --excludedocs — Do not install documentation. --force — Shorthand for --replacepkgs, --replacefiles, and --oldpackage. --ignorearch — Do not verify package architecture. --ignoreos — Do not verify package operating system. --includedocs — Install documentation. --nodeps — Do not verify package dependencies. --noscripts — Do not execute any installation scripts. --percent — Print percentages as package installs. --replacefiles — Install even if the package replaces installed files. --replacepkgs — Reinstall if the package is already present. --test — Do not install, but tell if it would work or not. --oldpackage — Upgrade to an old version of the package (--force on upgrades does this automatically). Erase Mode RPM command reference erase mode RPM's erase mode is used to erase previously installed packages: Format: rpm --erase <package> or Format: rpm -e <package> Options To Erase Mode The following options can be used on any erase command: --nodeps — Do not verify package dependencies. --noscripts — Do not execute any installation scripts. Build Mode RPM command reference build mode RPM's build mode is used to build packages: Format: rpm -b<stage> <options> <specfile> (Note that -vv is the default for all build mode commands.) Build Mode Stages One of the following stages must follow the -b option: p — Prep (unpack sources and apply patches). l — List check (do some cursory checks on %files). c — Compile (prep and compile). i — Install (prep, compile, install). b — Binary package (prep, compile, install, package). a — Binary/source package (prep, compile, install, package). Options To Build Mode The following options can be used on any build command: --short-circuit — Skip straight to specified stage (only for c and i). --clean — Remove build tree when done. --sign — Generate PGP signature. --buildroot <s> — Use <s> as the build root. --buildarch <s> — Use <s> as the build architecture. --buildos <s> — Use <s> as the build operating system. --test — Do not execute any stages. --timecheck <s> — Set the time check to <s> seconds (0 disables it). Rebuild Mode RPM command reference rebuild mode RPM's rebuild mode is used to rebuild packages from a source package file. The source archives, patches, and icons that comprise the source package are removed after the binary package is built. Rebuild mode implies --clean. Format: rpm --rebuild <options> <source-package> (Note that -vv is the default for all rebuild mode commands.) Options To Rebuild Mode Only the global options may be used. Recompile Mode RPM command reference recompile mode RPM's recompile mode is used to recompile software from a source package file. Unlike --rebuild, no binary package is created. Format: rpm --recompile <options> <source-package> (Note that -vv is the default for all recompile mode commands.) Options To Recompile Mode Only the global options may be used. Resign Mode RPM command reference resign mode RPM's resign mode is used to replace a package's signature with a new one: Format: rpm --resign <options> <packagefile>+ Options To Resign Mode Only the global options may be used. Add Signature Mode RPM command reference add signature mode RPM's add signature mode is used to add a signature to a package: Format: rpm --addsign <options> <packagefile>+ Options To Add Signature Mode Only the global options may be used. Check Signature Mode RPM command reference check signature mode RPM's check signature mode is used to verify a package's signature: Format: rpm --checksig <options> <packagefile>+ or Format: rpm -K <options> <packagefile>+ Options To Check Signature Mode The following option can be used on any check signature command: --nopgp — Skip any PGP signatures (size and MD5 only). Initalize Database Mode RPM command reference initialize database mode RPM's initalize database mode is used to create a new RPM database: Format: rpm --initdb <options> Options to Initalize database Mode Only the global options may be used. Rebuild Database Mode RPM command reference rebuild database mode RPM's rebuild database mode is used to rebuild an RPM database: Format: rpm --rebuilddb <options> Options to Rebuild Database Mode Only the global options may be used. @ 1.1.1.1 log @Import book 'Maximum RPM' by Ed Bailey, version 1.0 @ text @@