1RPM(8)                      System Manager's Manual                     RPM(8)
2
3
4

NAME

6       rpm - RPM Package Manager
7

SYNOPSIS

9   QUERYING AND VERIFYING PACKAGES:
10       rpm {-q|--query} [select-options] [query-options]
11
12       rpm --querytags
13
14       rpm {-V|--verify} [select-options] [verify-options]
15
16
17   INSTALLING, UPGRADING, AND REMOVING PACKAGES:
18       rpm {-i|--install} [install-options] PACKAGE_FILE ...
19
20
21
22       rpm {-U|--upgrade} [install-options] PACKAGE_FILE ...
23
24
25
26       rpm {-F|--freshen} [install-options] PACKAGE_FILE ...
27
28
29
30       rpm {--reinstall} [install-options] PACKAGE_FILE ...
31
32
33
34       rpm {-e|--erase} [--allmatches] [--justdb] [--nodeps] [--noscripts]
35           [--notriggers] [--test] PACKAGE_NAME ...
36
37
38   MISCELLANEOUS:
39       rpm --showrc
40
41       rpm --setperms PACKAGE_NAME ...
42
43       rpm --setugids PACKAGE_NAME ...
44
45       rpm --setcaps PACKAGE_NAME ...
46
47       rpm --restore PACKAGE_NAME ...
48
49
50   select-options
51        [PACKAGE_NAME]
52        [-a,--all [SELECTOR]] [-f,--file FILE]
53        [-g,--group GROUP] {-p,--package PACKAGE_FILE]
54        [--hdrid SHA1] [--pkgid MD5] [--tid TID]
55        [--querybynumber HDRNUM] [--triggeredby PACKAGE_NAME]
56        [--whatprovides CAPABILITY] [--whatrequires CAPABILITY]
57        [--whatrecommends CAPABILITY] [--whatsuggests CAPABILITY]
58        [--whatsupplements CAPABILITY] [--whatenhances CAPABILITY]
59        [--whatobsoletes CAPABILITY] [--whatconflicts CAPABILITY]
60
61
62   query-options
63       General:
64        [--changelog] [--changes]  [--dupes] [-i,--info]
65        [--last] [--qf,--queryformat QUERYFMT] [--xml]
66
67       Dependencies:
68        [--conflicts] [--enhances] [--obsoletes] [--provides]
69        [--recommends] [-R,--requires] [--suggests] [--supplements]
70
71       Files:
72        [-c,--configfiles] [-d,--docfiles] [--dump] [--fileclass]
73        [--filecolor] [--fileprovide][--filerequire] [--filecaps]
74        [--filesbypkg] [-l,--list] [-s,--state]
75        [--noartifact] [--noghost] [--noconfig
76
77       Scripts and triggers:
78        [--filetriggers] [--scripts] [--triggers,--triggerscripts]
79
80
81   verify-options
82        [--nodeps] [--nofiles] [--noscripts]
83        [--nodigest] [--nosignature]
84        [--nolinkto] [--nofiledigest] [--nosize] [--nouser]
85        [--nogroup] [--nomtime] [--nomode] [--nordev]
86        [--nocaps]
87
88
89   install-options
90        [--allfiles] [--badreloc] [--excludepath OLDPATH]
91        [--excludedocs] [--force] [-h,--hash]
92        [--ignoresize] [--ignorearch] [--ignoreos]
93        [--includedocs] [--justdb]
94        [--nodeps] [--nodigest] [--noplugins]
95        [--nocaps] [--noorder]
96        [--nosignature] [--noscripts] [--notriggers]
97        [--oldpackage] [--percent] [--prefix NEWPATH]
98        [--relocate OLDPATH=NEWPATH]
99        [--replacefiles] [--replacepkgs]
100        [--test]
101
102

DESCRIPTION

104       rpm is a powerful Package Manager, which can be used to build, install,
105       query, verify, update, and erase individual software packages.  A pack‐
106       age  consists  of an archive of files and meta-data used to install and
107       erase the archive files. The meta-data includes  helper  scripts,  file
108       attributes,  and  descriptive  information about the package.  Packages
109       come in two varieties: binary packages, used to encapsulate software to
110       be  installed,  and  source  packages,  containing  the source code and
111       recipe necessary to produce binary packages.
112
113       One of the following basic  modes  must  be  selected:  Query,  Verify,
114       Install/Upgrade/Freshen/Reinstall,  Uninstall,  Set Owners/Groups, Show
115       Querytags, and Show Configuration.
116
117   GENERAL OPTIONS
118       These options can be used in all the different modes.
119
120       -?, --help
121              Print a longer usage message then normal.
122
123       --version
124              Print a single line containing the version number of  rpm  being
125              used.
126
127       --quiet
128              Print  as little as possible - normally only error messages will
129              be displayed.
130
131       -v, --verbose
132              Print verbose information - normally routine  progress  messages
133              will be displayed.
134
135       -vv    Print lots of ugly debugging information.
136
137       --rcfile FILELIST
138              Replace  the list of configuration files to be read. Each of the
139              files in the colon separated FILELIST is  read  sequentially  by
140              rpm  for  configuration information.  Only the first file in the
141              list must exist, and tildes will be expanded  to  the  value  of
142              $HOME.  The default FILELIST is /usr/lib/rpm/rpmrc:/usr/lib/rpm/
143              redhat/rpmrc:/etc/rpmrc:~/.rpmrc.
144
145
146       --macros FILELIST
147              Replace the list of macro files to be loaded. Each of the  files
148              in  the colon separated FILELIST is read sequentially by rpm for
149              macro definitions.  Only the first file in the list must  exist,
150              and  tildes will be expanded to the value of $HOME.  The default
151              FILELIST is  /usr/lib/rpm/macros:/usr/lib/rpm/macros.d/macros.*:
152              /usr/lib/rpm/platform/%{_target}/macros:/usr/lib/rpm/fileattrs/
153              *.attr:/usr/lib/rpm/redhat/macros:/etc/rpm/macros.*:/etc/rpm/
154              macros:/etc/rpm/%{_target}/macros:~/.rpmmacros
155
156
157       --pipe CMD
158              Pipes the output of rpm to the command CMD.
159
160       --dbpath DIRECTORY
161              Use  the  database  in  DIRECTORY  rather  than the default path
162              /var/lib/rpm
163
164       --root DIRECTORY
165              Use the file system tree rooted at DIRECTORY for all operations.
166              Note  that this means the database within DIRECTORY will be used
167              for dependency checks  and  any  scriptlet(s)  (e.g.   %post  if
168              installing, or %prep if building, a package) will be run after a
169              chroot(2) to DIRECTORY.
170
171       -D, --define='MACRO EXPR'
172              Defines MACRO with value EXPR.
173
174       --undefine='MACRO'
175              Undefines MACRO.
176
177       -E, --eval='EXPR'
178              Prints macro expansion of EXPR.
179
180
181       More - less often needed - options can be found on the rpm-misc(8)  man
182       page.
183
184   INSTALL AND UPGRADE OPTIONS
185       In  these  options, PACKAGE_FILE can be either rpm binary file or ASCII
186       package manifest (see PACKAGE SELECTION OPTIONS), and may be  specified
187       as  an  ftp  or  http URL, in which case the package will be downloaded
188       before being installed. See FTP/HTTP OPTIONS for information  on  rpm's
189       internal ftp and http client support.
190
191       The general form of an rpm install command is
192
193       rpm {-i|--install} [install-options] PACKAGE_FILE ...
194
195       This installs a new package.
196
197       The general form of an rpm upgrade command is
198
199       rpm {-U|--upgrade} [install-options] PACKAGE_FILE ...
200
201       This  upgrades  or  installs the package currently installed to a newer
202       version.  This is the same as install, except all other  version(s)  of
203       the package are removed after the new package is installed.
204
205       rpm {-F|--freshen} [install-options] PACKAGE_FILE ...
206
207       This  will upgrade packages, but only ones for which an earlier version
208       is installed.
209
210       The general form of an rpm reinstall command is
211
212       rpm {--reinstall} [install-options] PACKAGE_FILE ...
213
214       This reinstalls a previously installed package.
215
216       --allfiles
217              Installs or upgrades all the missingok  files  in  the  package,
218              regardless if they exist.
219
220       --badreloc
221              Used  with --relocate, permit relocations on all file paths, not
222              just those OLDPATH's included in the binary  package  relocation
223              hint(s).
224
225       --excludepath OLDPATH
226              Don't install files whose name begins with OLDPATH.
227
228       --excludedocs
229              Don't install any files which are marked as documentation (which
230              includes man pages and texinfo documents).
231
232       --force
233              Same as using --replacepkgs, --replacefiles, and --oldpackage.
234
235       -h, --hash
236              Print 50 hash marks as the package  archive  is  unpacked.   Use
237              with -v|--verbose for a nicer display.
238
239       --ignoresize
240              Don't  check mount file systems for sufficient disk space before
241              installing this package.
242
243       --ignorearch
244              Allow installation or upgrading even if the architectures of the
245              binary package and host don't match.
246
247       --ignoreos
248              Allow installation or upgrading even if the operating systems of
249              the binary package and host don't match.
250
251       --includedocs
252              Install documentation files. This is the default behavior.
253
254       --justdb
255              Update only the database, not the filesystem.
256
257       --nodigest
258              Don't verify package or header digests when reading.
259
260       --nomanifest
261              Don't process non-package files as manifests.
262
263       --nosignature
264              Don't verify package or header signatures when reading.
265
266       --nodeps
267              Don't do a dependency check before  installing  or  upgrading  a
268              package.
269
270       --nocaps
271              Don't set file capabilities.
272
273       --noorder
274              Don't  reorder the packages for an install. The list of packages
275              would normally be reordered to satisfy dependencies.
276
277       --noplugins
278              Do not load and execute plugins.
279
280       --noscripts, --nopre, --nopost,  --nopreun,  --nopostun,  --nopretrans,
281       --noposttrans
282              Don't  execute  the scriptlet of the same name.  The --noscripts
283              option is equivalent to
284
285              --nopre --nopost --nopreun --nopostun --nopretrans --noposttrans
286
287              and turns off the execution of the  corresponding  %pre,  %post,
288              %preun, %postun %pretrans, and %posttrans scriptlet(s).
289
290
291       --notriggers, --notriggerin, --notriggerun, --notriggerprein, --notrig‐
292       gerpostun
293              Don't execute any trigger scriptlet  of  the  named  type.   The
294              --notriggers option is equivalent to
295
296              --notriggerprein --notriggerin --notriggerun --notriggerpostun
297
298              and  turns  off  execution  of  the corresponding %triggerprein,
299              %triggerin, %triggerun, and %triggerpostun scriptlet(s).
300
301       --oldpackage
302              Allow an upgrade to replace a newer package with an older one.
303
304       --percent
305              Print percentages as files are unpacked  from  the  package  ar‐
306              chive.   This  is  intended  to  make rpm easy to run from other
307              tools.
308
309       --prefix NEWPATH
310              For relocatable binary packages, translate all file  paths  that
311              start  with  the  installation  prefix in the package relocation
312              hint(s) to NEWPATH.
313
314       --relocate OLDPATH=NEWPATH
315              For relocatable binary packages, translate all file  paths  that
316              start with OLDPATH in the package relocation hint(s) to NEWPATH.
317              This option can be used repeatedly if several OLDPATH's  in  the
318              package are to be relocated.
319
320       --replacefiles
321              Install  the  packages  even  if  they replace files from other,
322              already installed, packages.
323
324       --replacepkgs
325              Install the packages even if some of them are already  installed
326              on this system.
327
328       --test Do  not  install the package, simply check for and report poten‐
329              tial conflicts.
330
331   ERASE OPTIONS
332       The general form of an rpm erase command is
333
334       rpm {-e|--erase}  [--allmatches]  [--justdb]  [--nodeps]  [--noscripts]
335       [--notriggers] [--test] PACKAGE_NAME ...
336
337
338       The following options may also be used:
339
340       --allmatches
341              Remove  all  versions  of  the package which match PACKAGE_NAME.
342              Normally an error is issued  if  PACKAGE_NAME  matches  multiple
343              packages.
344
345       --justdb
346              Update only the database, not the filesystem.
347
348       --nodeps
349              Don't check dependencies before uninstalling the packages.
350
351       --noscripts, --nopreun, --nopostun
352              Don't  execute  the scriptlet of the same name.  The --noscripts
353              option during package erase is equivalent to
354
355              --nopreun --nopostun
356
357              and turns off the execution of  the  corresponding  %preun,  and
358              %postun scriptlet(s).
359
360       --notriggers, --notriggerun, --notriggerpostun
361              Don't  execute  any  trigger  scriptlet  of the named type.  The
362              --notriggers option is equivalent to
363
364              --notriggerun --notriggerpostun
365
366              and turns off execution of  the  corresponding  %triggerun,  and
367              %triggerpostun scriptlet(s).
368
369       --test Don't  really  uninstall  anything, just go through the motions.
370              Useful in conjunction with the -vv option for debugging.
371
372   QUERY OPTIONS
373       The general form of an rpm query command is
374
375       rpm {-q|--query} [select-options] [query-options]
376
377
378       You may specify the format that package information should  be  printed
379       in. To do this, you use the
380
381        --qf|--queryformat QUERYFMT
382
383       option, followed by the QUERYFMT format string.  Query formats are mod‐
384       ified versions of the standard printf(3) formatting. The format is made
385       up  of  static  strings (which may include standard C character escapes
386       for newlines, tabs, and other special characters)  and  printf(3)  type
387       formatters.  As rpm already knows the type to print, the type specifier
388       must be omitted however, and replaced by the name of the header tag  to
389       be  printed, enclosed by {} characters. Tag names are case insensitive,
390       and the leading RPMTAG_ portion of the tag name may be omitted as well.
391
392       Alternate output formats may be requested by  following  the  tag  with
393       :typetag.  Currently, the following types are supported:
394
395       :armor Wrap a public key in ASCII armor.
396
397       :arraysize
398              Display number of elements in array tags.
399
400       :base64
401              Encode binary data using base64.
402
403       :date  Use strftime(3) "%c" format.
404
405       :day   Use strftime(3) "%a %b %d %Y" format.
406
407       :depflags
408              Format dependency comparison operator.
409
410       :deptype
411              Format dependency type.
412
413       :expand
414              Perform macro expansion.
415
416       :fflags
417              Format file flags.
418
419       :fstate
420              Format file state.
421
422       :fstatus
423              Format file verify status.
424
425       :hex   Format in hexadecimal.
426
427       :octal Format in octal.
428
429       :humaniec
430              Human  readable  number (in IEC 80000). The suffix K = 1024, M =
431              1048576, ...
432
433       :humansi
434              Human readable number (in SI). The suffix K = 1000, M = 1000000,
435              ...
436
437       :perms Format file permissions.
438
439       :pgpsig
440              Display signature fingerprint and time.
441
442       :shescape
443              Escape single quotes for use in a script.
444
445       :triggertype
446              Display trigger suffix.
447
448       :vflags
449              File verification flags.
450
451       :xml   Wrap data in simple xml markup.
452
453       For example, to print only the names of the packages queried, you could
454       use %{NAME} as the format string.  To print the packages name and  dis‐
455       tribution information in two columns, you could use %-30{NAME}%{DISTRI‐
456       BUTION}.  rpm will print a list of all of the tags it knows about  when
457       it is invoked with the --querytags argument.
458
459       There  are  two subsets of options for querying: package selection, and
460       information selection.
461
462   PACKAGE SELECTION OPTIONS:
463       PACKAGE_NAME
464              Query installed package named PACKAGE_NAME. To specify the pack‐
465              age  more precisely the package name may be followed by the ver‐
466              sion or version and release both  separated  by  a  dash  or  an
467              architecture  name separated by a dot. See the output of rpm -qa
468              or rpm -qp PACKAGE_FILE as an example.
469
470
471       -a, --all [SELECTOR]
472              Query all installed packages.
473
474              An optional SELECTOR in the form of tag=pattern can be  provided
475              to narrow the selection, for example name="b*" to query packages
476              whose name starts with "b".
477
478       --dupes
479              List duplicated packages.
480
481       -f, --file FILE
482              Query package owning FILE.
483
484       --filecaps
485              List file names with POSIX1.e capabilities.
486
487       --fileclass
488              List file names with their classes (libmagic classification).
489
490       --filecolor
491              List file names with their colors (0 for noarch, 1 for 32bit,  2
492              for 64 bit).
493
494       --fileprovide
495              List file names with their provides.
496
497       --filerequire
498              List file names with their requires.
499
500       -g, --group GROUP
501              Query packages with the group of GROUP.
502
503       --hdrid SHA1
504              Query  package that contains a given header identifier, i.e. the
505              SHA1 digest of the immutable header region.
506
507       -p, --package PACKAGE_FILE
508              Query an (uninstalled) package PACKAGE_FILE.   The  PACKAGE_FILE
509              may  be specified as an ftp or http style URL, in which case the
510              package header will be downloaded  and  queried.   See  FTP/HTTP
511              OPTIONS  for  information  on rpm's internal ftp and http client
512              support. The PACKAGE_FILE argument(s), if not a binary  package,
513              will be interpreted as an ASCII package manifest unless --noman‐
514              ifest option is used.  In  manifests,  comments  are  permitted,
515              starting  with  a  '#', and each line of a package manifest file
516              may include white space separated  glob  expressions,  including
517              URL's,  that  will  be expanded to paths that are substituted in
518              place of the package manifest as additional  PACKAGE_FILE  argu‐
519              ments to the query.
520
521       --pkgid MD5
522              Query package that contains a given package identifier, i.e. the
523              MD5 digest of the combined header and payload contents.
524
525       --querybynumber HDRNUM
526              Query the HDRNUMth database entry directly; this is useful  only
527              for debugging.
528
529       --specfile SPECFILE
530              Parse  and  query SPECFILE as if it were a package. Although not
531              all the information (e.g. file lists) is available, this type of
532              query  permits  rpm  to be used to extract information from spec
533              files without having to write a specfile parser.
534
535       --tid TID
536              Query package(s) that have a given TID transaction identifier. A
537              unix  time  stamp is currently used as a transaction identifier.
538              All package(s) installed or erased within a  single  transaction
539              have a common identifier.
540
541       --triggeredby PACKAGE_NAME
542              Query packages that are triggered by package(s) PACKAGE_NAME.
543
544       --whatobsoletes CAPABILITY
545              Query all packages that obsolete CAPABILITY for proper function‐
546              ing.
547
548       --whatprovides CAPABILITY
549              Query all packages that provide the CAPABILITY capability.
550
551       --whatrequires CAPABILITY
552              Query all packages that require CAPABILITY for proper  function‐
553              ing.
554
555       --whatconflicts CAPABILITY
556              Query all packages that conflict with CAPABILITY.
557
558       --whatrecommends CAPABILITY
559              Query all packages that recommend CAPABILITY.
560
561       --whatsuggests CAPABILITY
562              Query all packages that suggest CAPABILITY.
563
564       --whatsupplements CAPABILITY
565              Query all packages that supplement CAPABILITY.
566
567       --whatenhances CAPABILITY
568              Query all packages that enhance CAPABILITY.
569
570   PACKAGE QUERY OPTIONS:
571       -d, --artifactfiles
572              List only artifact files (implies -l).
573
574       --changelog
575              Display change information for the package.
576
577       --changes
578              Display  change  information  for  the  package  with  full time
579              stamps.
580
581       -c, --configfiles
582              List only configuration files (implies -l).
583
584       --conflicts
585              List capabilities this package conflicts with.
586
587       -d, --docfiles
588              List only documentation files (implies -l).
589
590       --dump Dump file information as follows (implies -l):
591
592
593              path size mtime digest mode owner group isconfig isdoc rdev symlink
594
595
596       --enhances
597              List capabilities enhanced by package(s)
598
599       --filesbypkg
600              List all the files in each selected package.
601
602       --filetriggers
603              List filetrigger scriptlets from package(s).
604
605       -i, --info
606              Display  package  information,  including  name,  version,   and
607              description.  This uses the --queryformat if one was specified.
608
609       --last Orders  the package listing by install time such that the latest
610              packages are at the top.
611
612       -L, --licensefiles
613              List only license files (implies -l).
614
615       -l, --list
616              List files in package.
617
618       --obsoletes
619              List packages this package obsoletes.
620
621       --provides
622              List capabilities this package provides.
623
624       --recommends
625              List capabilities recommended by package(s)
626
627       -R, --requires
628              List capabilities on which this package depends.
629
630       --suggests
631              List capabilities suggested by package(s)
632
633       --supplements
634              List capabilities supplemented by package(s)
635
636       --scripts
637              List the package specific scriptlet(s) that are used as part  of
638              the installation and uninstallation processes.
639
640       -s, --state
641              Display  the  states  of files in the package (implies -l).  The
642              state of each file is one of normal, not installed, or replaced.
643
644       --triggers, --triggerscripts
645              Display the trigger scripts, if any, which are contained in  the
646              package.
647
648       --noartifact
649              Don't  display  artifact  files.   --noghost Don't display ghost
650              files. Useful in combination with option --list.
651
652       --noconfig
653              Don't display config files.
654
655       --xml  Format package headers as XML.
656
657
658   VERIFY OPTIONS
659       The general form of an rpm verify command is
660
661       rpm {-V|--verify} [select-options] [verify-options]
662
663
664       Verifying a package compares information about the installed  files  in
665       the  package  with  information  about the files taken from the package
666       metadata stored in the rpm database.   Among  other  things,  verifying
667       compares  the  size, digest, permissions, type, owner and group of each
668       file.  Any discrepancies are displayed.  Files that were not  installed
669       from  the package, for example, documentation files excluded on instal‐
670       lation using the "--excludedocs" option, will be silently ignored.
671
672       The package selection options are the  same  as  for  package  querying
673       (including  package manifest files as arguments).  Other options unique
674       to verify mode are:
675
676       --nodeps
677              Don't verify dependencies of packages.
678
679       --nodigest
680              Don't verify package or header digests when reading.
681
682       --nofiles
683              Don't verify any attributes of package files.
684
685       --noghost
686              Don't verify ghost files.
687
688       --noconfig
689              Don't verify config files.
690
691       --noscripts
692              Don't execute the %verifyscript scriptlet (if any).
693
694       --nosignature
695              Don't verify package or header signatures when reading.
696
697       --nolinkto
698
699       --nofiledigest (formerly --nomd5)
700
701       --nosize
702
703       --nouser
704
705       --nogroup
706
707       --nomtime
708
709       --nomode
710
711       --nordev
712              Don't verify the corresponding file attribute.
713
714       --nocaps
715              Don't verify file capabilities.
716
717       The format of the output is  a  string  of  9  characters,  a  possible
718       attribute marker:
719
720       c %config configuration file.
721       d %doc documentation file.
722       g %ghost file (i.e. the file contents are not included in the package payload).
723       l %license license file.
724       r %readme readme file.
725
726       from  the  package  header,  followed  by the file name.  Each of the 9
727       characters denotes the result of a comparison of  attribute(s)  of  the
728       file  to  the  value of those attribute(s) recorded in the database.  A
729       single "." (period) means the test passed, while a single "?" (question
730       mark)  indicates the test could not be performed (e.g. file permissions
731       prevent reading). Otherwise, the  (mnemonically  emBoldened)  character
732       denotes failure of the corresponding --verify test:
733
734       S file Size differs
735       M Mode differs (includes permissions and file type)
736       5 digest (formerly MD5 sum) differs
737       D Device major/minor number mismatch
738       L readLink(2) path mismatch
739       U User ownership differs
740       G Group ownership differs
741       T mTime differs
742       P caPabilities differ
743
744
745   MISCELLANEOUS COMMANDS
746       rpm --showrc
747              shows  the  values  rpm will use for all of the options are cur‐
748              rently set in rpmrc and macros configuration file(s).
749
750       rpm --setperms PACKAGE_NAME
751              sets permissions of files in the given package.  Consider  using
752              --restore instead.
753
754       rpm --setugids PACKAGE_NAME
755              sets  user/group  ownership  of files in the given package. This
756              command can change permissions and capabilities of files in that
757              package. In most cases it is better to use --restore instead.
758
759       rpm --setcaps PACKAGE_NAME
760              sets  capabilities of files in the given package. Consider using
761              --restore instead.
762
763       rpm --restore PACKAGE_NAME
764              The option restores owner, group, permissions  and  capabilities
765              of files in the given package.
766
767       Options --setperms, --setugids, --setcaps and
768              --restore are mutually exclusive.
769
770
771   FTP/HTTP OPTIONS
772       rpm  can  act  as  an  FTP  and/or  HTTP client so that packages can be
773       queried or installed from the internet.   Package  files  for  install,
774       upgrade,  and query operations may be specified as an ftp or http style
775       URL:
776
777       ftp://USER:PASSWORD@HOST:PORT/path/to/package.rpm
778
779       If the :PASSWORD portion is omitted, the password will be prompted  for
780       (once  per user/hostname pair). If both the user and password are omit‐
781       ted, anonymous ftp is used.  In all cases, passive (PASV) ftp transfers
782       are performed.
783
784       rpm allows the following options to be used with ftp URLs:
785
786       --ftpproxy HOST
787              The  host HOST will be used as a proxy server for all ftp trans‐
788              fers, which allows users to ftp through firewall machines  which
789              use  proxy systems. This option may also be specified by config‐
790              uring the macro %_ftpproxy.
791
792       --ftpport PORT
793              The TCP PORT number to use for the ftp connection on  the  proxy
794              ftp  server instead of the default port. This option may also be
795              specified by configuring the macro %_ftpport.
796
797       rpm allows the following options to be used with http URLs:
798
799       --httpproxy HOST
800              The host HOST will be used as a proxy server for all http trans‐
801              fers. This option may also be specified by configuring the macro
802              %_httpproxy.
803
804       --httpport PORT
805              The TCP PORT number to use for the http connection on the  proxy
806              http server instead of the default port. This option may also be
807              specified by configuring the macro %_httpport.
808

LEGACY ISSUES

810   Executing rpmbuild
811       The build modes of rpm are now resident in the  /usr/bin/rpmbuild  exe‐
812       cutable.   Install  the package containing rpmbuild (usually rpm-build)
813       and see rpmbuild(8) for documentation of all the rpm build modes.
814

FILES

816   rpmrc Configuration
817       /usr/lib/rpm/rpmrc
818       /usr/lib/rpm/redhat/rpmrc
819       /etc/rpmrc
820       ~/.rpmrc
821
822   Macro Configuration
823       /usr/lib/rpm/macros
824       /usr/lib/rpm/redhat/macros
825       /etc/rpm/macros
826       ~/.rpmmacros
827
828   Database
829       /var/lib/rpm/Basenames
830       /var/lib/rpm/Conflictname
831       /var/lib/rpm/Dirnames
832       /var/lib/rpm/Group
833       /var/lib/rpm/Installtid
834       /var/lib/rpm/Name
835       /var/lib/rpm/Obsoletename
836       /var/lib/rpm/Packages
837       /var/lib/rpm/Providename
838       /var/lib/rpm/Requirename
839       /var/lib/rpm/Sha1header
840       /var/lib/rpm/Sigmd5
841       /var/lib/rpm/Triggername
842
843   Temporary
844       /var/tmp/rpm*
845

SEE ALSO

847       rpm-misc(8)(3),
848       popt(3),
849       rpm2cpio(8),
850       rpmbuild(8),
851       rpmdb(8),
852       rpmkeys(8),
853       rpmsign(8),
854       rpmspec(8),
855
856       rpm --help - as rpm supports customizing the options via  popt  aliases
857       it's  impossible  to  guarantee  that  what's  described  in the manual
858       matches what's available.
859
860
861       http://www.rpm.org/ <URL:http://www.rpm.org/>
862

AUTHORS

864       Marc Ewing <marc@redhat.com>
865       Jeff Johnson <jbj@redhat.com>
866       Erik Troan <ewt@redhat.com>
867
868
869
870Red Hat, Inc.                    09 June 2002                           RPM(8)
Impressum