Penguin
Annotated edit history of rpmi(8) version 3, including all changes. View license author blame.
Rev Author # Line
1 perry 1 RPM
2 !!!RPM
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 FILES
7 SEE ALSO
8 AUTHORS
9 ----
10 !!NAME
11
12
13 rpm - RPM Package Manager
14 !!SYNOPSIS
15
16
17 __QUERYING AND VERIFYING PACKAGES:__
18
19
20 __rpm__ {__-q|--query__} [[__select-options__]
21 [[__query-options__]
22
23
24 __rpm__ {__-V|--verify__} [[__select-options__]
25 [[__--nodeps__] [[__--nofiles__] [[__--nomd5__]
26 [[__--noscripts__]
27
28
29 __rpm__ {__-K|--checksig__} [[__--nogpg__]
30 [[__--nopgp__] [[__--nomd5__] ''PACKAGE_FILE
31 ...''
32
33
34 __INSTALLING, UPGRADING, AND REMOVING
35 PACKAGES:__
36
37
38 __rpm__ {__-i|--install__} [[__install-options__]
39 ''PACKAGE_FILE ...''
40
41
42 __rpm__ {__-U|--upgrade__} [[__install-options__]
43 ''PACKAGE_FILE ...''
44
45
46 __rpm__ {__-F|--freshen__} [[__install-options__]
47 ''PACKAGE_FILE ...''
48
49
50 __rpm__ {__-e|--erase__} [[__--allmatches__]
51 [[__--nodeps__] [[__--noscripts__] [[__--notriggers__]
52 [[__--repackage__] [[__--test__] ''PACKAGE_NAME
53 ...''
54
55
56 __BUILDING PACKAGES:__
57
58
59 __rpm__ {__-ba|-bb|-bp|-bc|-bi|-bl|-bs__}
60 [[__build-options__] ''SPECFILE ...''
61
62
63 __rpm__ {__-ta|-tb|-tp|-tc|-ti|-tl|-ts__}
64 [[__build-options__] ''TARBALL ...''
65
66
67 __rpm__ {__--rebuild|--recompile__} ''SOURCEPKG
68 ...''
69
70
71 __MISCELLANEOUS:__
72
73
74 __rpm__ {__--initdb|--rebuilddb__}
75
76
77 __rpm__ {__--addsign|--resign__} ''PACKAGE_FILE
78 ...''
79
80
81 __rpm__ {__--querytags|--showrc__}
82
83
84 __rpm__ {__--setperms|--setugids__} ''PACKAGE_NAME
85 ...''
86
87
88 __SELECT-OPTIONS__
89
90
91 __[[__''PACKAGE_NAME''__] [[-a,--all] [[-f,--file__
92 ''FILE''__] [[-g,--group__ ''GROUP''__]
93 [[-p,--package__ ''PACKAGE_FILE''__]
94 [[--querybynumber__ ''NUMBER''__] [[--triggeredby__
95 ''PACKAGE_NAME''__] [[--whatprovides__
96 ''CAPABILITY''__] [[--whatrequires__
97 ''CAPABILITY''__]__
98
99
100 __QUERY-OPTIONS__
101
102
103 __[[--changelog] [[-c,--configfiles] [[-d,--docfiles] [[--dump]
104 [[--filesbypkg] [[-i,--info] [[--last] [[-l,--list] [[--provides]
105 [[--qf,--queryformat__ ''QUERYFMT''__] [[-R,--requires]
106 [[--scripts] [[-s,--state]
107 [[--triggers,--triggerscripts]__
108
109
110 __INSTALL-OPTIONS__
111
112
113 __[[--allfiles] [[--badreloc] [[--excludepath__
114 ''OLDPATH''__] [[--excludedocs] [[--force] [[-h,--hash]
115 [[--ignoresize] [[--ignorearch] [[--ignoreos] [[--includedocs]
116 [[--justdb] [[--nodeps] [[--noorder] [[--noscripts]
117 [[--notriggers] [[--oldpackage] [[--percent] [[--prefix__
118 ''NEWPATH''__] [[--relocate__
119 ''OLDPATH''__=__''NEWPATH''__] [[--repackage]
120 [[--replacefiles] [[--replacepkgs] [[--test]__
121
122
123 __BUILD-OPTIONS__
124
125
126 __[[--buildroot__ ''DIRECTORY''__] [[--clean]
127 [[--nobuild] [[--rmsource] [[--rmspec] [[--short-circuit]
128 [[--sign] [[--target__ ''PLATFORM''__]__
129 !!DESCRIPTION
130
131
132 __rpm__ is a powerful __Package Manager__, which can
133 be used to build, install, query, verify, update, and erase
134 individual software packages. A __package__ consists of
135 an archive of files and meta-data used to install and erase
136 the archive files. The meta-data includes helper scripts,
137 file attributes, and descriptive information about the
138 package. __Packages__ come in two varieties: binary
139 packages, used to encapsulate software to be installed, and
140 source packages, containing the source code and recipe
141 necessary to produce binary packages.
142
143
144 One of the following basic modes must be selected:
145 __Query__, __Verify__, __Signature Check__,
146 __Install/Upgrade/Freshen__, __Uninstall__, __Build
147 Package__, __Build Package from Tarball__, __Recompile
148 Package__, __Initialize Database__, __Rebuild
149 Database__, __Resign__, __Add Signature__, __Set
150 Owners/Groups__, __Show Querytags__, and __Show
151 Configuration__.
152
153
154 __GENERAL OPTIONS__
155
156
157 These options can be used in all the different
158 modes.
159
160
161 __-?, --help__
162
163
164 Print a longer usage message then normal.
165
166
167 __--version__
168
169
170 Print a single line containing the version number of
171 __rpm__ being used.
172
173
174 __--quiet__
175
176
177 Print as little as possible - normally only error messages
178 will be displayed.
179
180
181 __-v__
182
183
184 Print verbose information - normally routine progress
185 messages will be displayed.
186
187
188 __-vv__
189
190
191 Print lots of ugly debugging information.
192
193
194 __--rcfile__ ''FILELIST''
195
196
197 Each of the files in the colon separated ''FILELIST'' is
198 read sequentially by __rpm__ for configuration
199 information. Only the first file in the list must exist, and
200 tildes will be expanded to the value of __$HOME__. The
201 default ''FILELIST'' is
202 ''/usr/lib/rpm/rpmrc'':''/etc/rpmrc'':''~/.rpmrc''.
203
204
205 __--pipe__ ''CMD''
206
207
208 Pipes the output of __rpm__ to the command
209 ''CMD''.
210
211
212 __--dbpath__ ''DIRECTORY''
213
214
215 Use the database in ''DIRECTORY'' rathen than the default
216 path ''/var/lib/rpm''
217
218
219 __--root__ ''DIRECTORY''
220
221
222 Use the system rooted at ''DIRECTORY'' for all
223 operations. Note that this means the database will be read
224 or modified under ''DIRECTORY'' and any __%pre__ or
225 __%post__ scriptlet(s) are run after a chroot(2) to
226 ''DIRECTORY''.
227
228
229 __INSTALL AND UPGRADE OPTIONS__
230
231
232 The general form of an rpm install command is
233
234
235 __rpm__ {__-i|--install__} [[__install-options__]
236 ''PACKAGE_FILE ...''
237
238
239 This installs a new package.
240
241
242 The general form of an rpm upgrade command is
243
244
245 __rpm__ {__-U|--upgrade__} [[__install-options__]
246 ''PACKAGE_FILE ...''
247
248
249 This upgrades or installs the package currently installed to
250 a newer version. This is the same as install, except all
251 other version(s) of the package are removed after the new
252 package is installed.
253
254
255 __rpm__ {__-F|--freshen__} [[__install-options__]
256 ''PACKAGE_FILE ...''
257
258
259 This will upgrade packages, but only if an earlier version
260 currently exists. The ''PACKAGE_FILE'' may be specified
261 as an __ftp__ or __http__ URL, in which case the
262 package will be downloaded before being installed. See
263 __FTP/HTTP OPTIONS__ for information on __rpm__'s
264 internal __ftp__ and __http__ client
265 support.
266
267
268 __--allfiles__
269
270
271 Installs or upgrades all the missingok files in the package,
272 regardless if they exist.
273
274
275 __--badreloc__
276
277
278 Used with __--relocate__, permit relocations on all file
279 paths, not just those ''OLDPATH'''s included in the
280 binary package relocation hint(s).
281
282
283 __--excludepath__ ''OLDPATH''
284
285
286 Don't install files whose name begins with
287 ''OLDPATH''.
288
289
290 __--excludedocs__
291
292
293 Don't install any files which are marked as documentation
294 (which includes man pages and texinfo
295 documents).
296
297
298 __--force__
299
300
301 Same as using __--replacepkgs__, __--replacefiles__,
302 and __--oldpackage__.
303
304
305 __-h, --hash__
306
307
308 Print 50 hash marks as the package archive is unpacked. Use
309 with __-v|--verbose__ for a nicer display.
310
311
312 __--ignoresize__
313
314
315 Don't check mount file systems for sufficient disk space
316 before installing this package.
317
318
319 __--ignorearch__
320
321
322 Allow installation or upgrading even if the architectures of
323 the binary package and host don't match.
324
325
326 __--ignoreos__
327
328
329 Allow installation or upgrading even if the operating
330 systems of the binary package and host don't
331 match.
332
333
334 __--includedocs__
335
336
337 Install documentation files. This is the default
338 behavior.
339
340
341 __--justdb__
342
343
344 Update only the database, not the filesystem.
345
346
347 __--nodeps__
348
349
350 Don't do a dependency check before installing or upgrading a
351 package.
352
353
354 __--noorder__
355
356
357 Don't reorder the packages for an install. The list of
358 packages would normally be reordered to satisfy
359 dependancies.
360
361
362 __--noscripts__
363
364
365 __--nopre__
366
367
368 __--nopost__
369
370
371 __--nopreun__
372
373
374 __--nopostun__
375
376
377 Don't execute the scriptlet of the same name. The
378 __--noscripts__ option is equivalent to
379
380
381 __--nopre --nopost --nopreun --nopostun__
382
383
384 and turns off the execution of the corresponding
385 __%pre__, __%post__, __%preun__, and __%postun__
386 scriptlet(s).
387
388
389 __--notriggers__
390
391
392 __--notriggerin__
393
394
395 __--notriggerun__
396
397
398 __--notriggerpostun__
399
400
401 Don't execute any trigger scriptlet of the named type. The
402 __--notriggers__ option is equivalent to
403
404
405 __--notriggerin --notriggerun
406 --notriggerpostun__
407
408
409 and turns off execution of the corresponding
410 __%triggerin__, __%triggerun__, and
411 __%triggerpostun__ scriptlet(s).
412
413
414 __--oldpackage__
415
416
417 Allow an upgrade to replace a newer package with an older
418 one.
419
420
421 __--percent__
422
423
424 Print percentages as files are unpacked from the package
425 archive. This is intended to make __rpm__ easy to run
426 from other tools.
427
428
429 __--prefix__ ''NEWPATH''
430
431
432 For relocateable binary packages, translate all file paths
433 that start with the installation prefix in the package
434 relocation hint(s) to ''NEWPATH''.
435
436
437 __--relocate__
438 ''OLDPATH''__=__''NEWPATH''
439
440
441 For relocatable binary packages, translate all file paths
442 that start with ''OLDPATH'' in the package relocation
443 hint(s) to ''NEWPATH''. This option can be used
444 repeatedly if several ''OLDPATH'''s in the package are to
445 be relocated.
446
447
448 __--repackage__
449
450
451 Re-package the files before erasing. The previously
452 installed package will be named according to the macro
453 __%_repackage_name_fmt__ and will be created in the
454 directory named by the macro __%_repackage_dir__ (default
455 value is ''/var/tmp'').
456
457
458 __--replacefiles__
459
460
461 Install the packages even if they replace files from other,
462 already installed, packages.
463
464
465 __--replacepkgs__
466
467
468 Install the packages even if some of them are already
469 installed on this system.
470
471
472 __--nobuild__
473
474
475 Do not install the package, simply check for and report
476 potential conflicts.
477
478
479 __QUERY OPTIONS__
480
481
482 The general form of an rpm query command is
483
484
485 __rpm__ {__-q|--query__} [[__select-options__]
486 [[__query-options__]
487
488
489 You may specify the format that package information should
490 be printed in. To do this, you use the
491 {__--qf|--queryformat__} ''QUERYFMT'' option, followed
492 by the ''QUERYFMT'' format string. Query formats are
493 modifed versions of the standard __printf(3)__
494 formatting. The format is made up of static strings (which
495 may include standard C character escapes for newlines, tabs,
496 and other special characters) and __printf(3)__ type
497 formatters. As __rpm__ already knows the type to print,
498 the type specifier must be omitted however, and replaced by
499 the name of the header tag to be printed, enclosed by
500 __{}__ characters. Tag names are case insesitive, and the
501 __RPMTAG___ portion of the tag name may be omitted as
502 well.
503
504
505 Alternate output formats may be requested by following the
506 tag with __:__''typetag''. Currently, the following
507 types are supported: __octal__, __date__,
508 __shescape__, __perms__, __fflags__, and
509 __depflags__. For example, to print only the names of the
510 packages queried, you could use __%{NAME}__ as the format
511 string. To print the packages name and distribution
512 information in two columns, you could use
513 __%-30{NAME}%{DISTRIBUTION}__. __rpm__ will print a
514 list of all of the tags it knows about when it is invoked
515 with the __--querytags__ argument.
516
517
518 There are two subsets of options for querying: package
519 selection, and information selection.
520
521
522 __PACKAGE SELECTION OPTIONS:__
523
524
525 ''PACKAGE_NAME''
526
527
528 Query installed package named
529 ''PACKAGE_NAME''.
530
531
532 __-a, --all__
533
534
535 Query all installed packages.
536
537
538 __-f, --file__ ''FILE''
539
540
541 Query package owning ''FILE''.
542
543
544 __-g, --group__ ''GROUP''
545
546
547 Query packages with the group of ''GROUP''.
548
549
550 __-p, --package__ ''PACKAGE_FILE''
551
552
553 Query an (uninstalled) package ''PACKAGE_FILE''. The
554 ''PACKAGE_FILE'' may be specified as an __ftp__ or
555 __http__ style URL, in which case the package header will
556 be downloaded and queried. See __FTP/HTTP OPTIONS__ for
557 information on __rpm__'s internal __ftp__ and
558 __http__ client support. The ''PACKAGE_FILE''
559 argument(s), if not a binary package, will be interpreted as
560 an ASCII package manifest. Comments are permitted, starting
561 with a '#', and each line of a package manifest file may
562 include white space seperated glob expressions, including
563 URL's with remote glob expressions, that will be expanded to
564 paths that are substituted in place of the package manifest
565 as additional ''PACKAGE_FILE'' arguments to the
566 query.
567
568
569 __--querybynumber__ ''NUMBER''
570
571
572 Query the ''NUMBER''th database entry directly; this is
573 useful only for debugging.
574
575
576 __--specfile__ ''SPECFILE''
577
578
579 Parse and query ''SPECFILE'' as if it were a package.
580 Although not all the information (e.g. file lists) is
581 available, this type of query permits rpm to be used to
582 extract information from spec files without having to write
583 a specfile parser.
584
585
586 __--triggeredby__ ''PACKAGE_NAME''
587
588
589 Query packages that are triggered by package(s)
590 ''PACKAGE_NAME''.
591
592
593 __--whatprovides__ ''CAPABILITY''
594
595
596 Query all packages that provide the ''CAPABILITY''
597 capability.
598
599
600 __--whatrequires__ ''CAPABILITY''
601
602
603 Query all packages that requires ''CAPABILITY'' for
604 proper functioning.
605
606
607 __PACKAGE QUERY OPTIONS:__
608
609
610 __--changelog__
611
612
613 Display change information for the package.
614
615
616 __-c, --configfiles__
617
618
619 List only configuration files (implies
620 __-l__).
621
622
623 __-d, --docfiles__
624
625
626 List only documentation files (implies
627 __-l__).
628
629
630 __--dump__
631
632
633 Dump file information as follows:
634
635
636 path size mtime md5sum mode owner group isconfig isdoc rdev symlink
637
638
639 This option must be used with at least one of __-l__,
640 __-c__, __-d__.
641
642
643 __--filesbypkg__
644
645
646 List all the files in each selected package.
647
648
649 __-i, --info__
650
651
652 Display package information, including name, version, and
653 description. This uses the __--queryformat__ if one was
654 specified.
655
656
657 __--last__
658
659
660 Orders the package listing by install time such that the
661 latest packages are at the top.
662
663
664 __-l, --list__
665
666
667 List files in package.
668
669
670 __--provides__
671
672
673 List capabilities this package provides.
674
675
676 __-R, --requires__
677
678
679 List packages on which this package depends.
680
681
682 __--scripts__
683
684
685 List the package specific scriptlet(s) that are used as part
686 of the installation and uninstallation
687 processes.
688
689
690 __-s, --state__
691
692
693 Display the ''states'' of files in the package (implies
694 __-l__). The state of each file is one of ''normal'',
695 ''not installed'', or ''replaced''.
696
697
698 __--triggers, --triggerscripts__
699
700
701 Display the trigger scripts, if any, which are contained in
702 the package.
703
704
705 __VERIFY OPTIONS__
706
707
708 The general form of an rpm verify command is
709
710
711 __rpm__ {__-V|--verify__} [[__select-options__]
712 [[__--nodeps__] [[__--nofiles__] [[__--nomd5__]
713 [[__--noscripts__]
714
715
716 Verifying a package compares information about the installed
717 files in the package with information about the files taken
718 from the package metadata stored in the rpm database. Among
719 other things, verifying compares the size, MD5 sum,
720 permissions, type, owner and group of each file. Any
721 discrepencies are displayed. Files that were not installed
722 from the package, for example, documentation files excluded
723 on installation using the --excludedocs__
724 __
725
726
727 The package selection options are the same as for package
728 querying (including package manifest files as arguments).
729 Other options that can be used only in verify mode
730 are:
731
732
733 __--nodeps__
734
735
736 Don't verify dependencies.
737
738
739 __--nofiles__
740
741
742 Don't verify files.
743
744
745 __--nomd5__
746
747
748 Don't verify file MD5 checksums.
749
750
751 __--noscripts__
752
753
754 Don't execute the __%verifyscript__ scriptlet (if
755 any).
756
757
758 The format of the output is a string of 8 characters, a
759 possible c__
760 __.__
761 __?__
762 __B__oldened) character
763 denotes failure of the corresponding __--verify__
764 test:
765
766
767 __S__ file __S__ize differs
768
769
770 __M M__ode differs (includes permissions and file
771 type)
772
773
774 __5__ MD__5__ sum differs
775
776
777 __D D__evice major/minor number mis-match
778
779
780 __L__ read__L__ink(2) path mis-match
781
782
783 __U U__ser ownership differs
784
785
786 __G G__roup ownership differs
787
788
789 __T__ m__T__ime differs
790
791
792 __SIGNATURE CHECKING__
793
794
795 The general form of an rpm signature check command
796 is
797
798
799 __rpm --checksig__ [[__--nogpg__] [[__--nopgp__]
800 [[__--nomd5__] ''PACKAGE_FILE ...''
801
802
803 This checks the GPG signature of package ''PACKAGE_FILE''
804 to ensure its integrity and origin. GPG configuration
805 information is read from configuration files. See the
806 section on GPG SIGNATURES for details.
807
808
809 __ERASE OPTIONS__
810
811
812 The general form of an rpm erase command is
813
814
815 __rpm__ {__-e|--erase__} [[__--allmatches__]
816 [[__--nodeps__] [[__--noscripts__] [[__--notriggers__]
817 [[__--repackage__] [[__--test__] ''PACKAGE_NAME
818 ...''
819
820
821 The following options may also be used:
822
823
824 __--allmatches__
825
826
827 Remove all versions of the package which match
828 ''PACKAGE_NAME''. Normally an error is issued if
829 ''PACKAGE_NAME'' matches multiple packages.
830
831
832 __--nodeps__
833
834
835 Don't check dependencies before uninstalling the
836 packages.
837
838
839 __--noscripts__
840
841
842 __--nopreun__
843
844
845 __--nopostun__
846
847
848 Don't execute the scriptlet of the same name. The
849 __--noscripts__ option during package erase is equivalent
850 to
851
852
853 __--nopreun --nopostun__
854
855
856 and turns off the execution of the corresponding
857 __%preun__, and __%postun__ scriptlet(s).
858
859
860 __--notriggers__
861
862
863 __--notriggerun__
864
865
866 __--notriggerpostun__
867
868
869 Don't execute any trigger scriptlet of the named type. The
870 __--notriggers__ option is equivalent to
871
872
873 __--notriggerun --notriggerpostun__
874
875
876 and turns off execution of the corresponding
877 __%triggerun__, and __%triggerpostun__
878 scriptlet(s).
879
880
881 __--repackage__
882
883
884 Re-package the files before erasing. The previously
885 installed package will be named according to the macro
886 __%_repackage_name_fmt__ and will be created in the
887 directory named by the macro __%_repackage_dir__ (default
888 value is ''/var/tmp'').
889
890
891 __--test__
892
893
894 Don't really uninstall anything, just go through the
895 motions. Useful in conjunction with the __-vv__ option
896 for debugging.
897
898
899 __BUILD OPTIONS__
900
901
902 The general form of an rpm build command is
903
904
905 __rpm__ {__-b__''STAGE''__|-t__''STAGE''}
906 [[__build-options__] ''FILE ...''
907
908
909 The argument used is __-b__ if a spec file is being used
910 to build the package and __-t__ if __rpm__ should look
911 inside of a (possibly compressed) tar file for the spec file
912 to use. After the first argument, the next character
913 (''STAGE'') specifies the stages of building and
914 packaging to be done and is one of:
915
916
917 __-ba__
918
919
920 Build binary and source packages (after doing the %prep,
921 %build, and %install stages).
922
923
924 __-bb__
925
926
927 Build a binary package (after doing the %prep, %build, and
928 %install stages).
929
930
931 __-bp__
932
933
934 Executes the
935
936
937 __-bc__
938
939
940 Do the
941
942
943 __-bi__
944
945
946 Do the
947
948
949 __-bl__
950
951
952 Do a
953
954
955 __-bs__
956
957
958 Build just the source package.
959
960
961 The following options may also be used:
962
963
964 __--buildroot__ ''DIRECTORY''
965
966
2 perry 967 When building a package, override the !BuildRoot tag with
1 perry 968 directory ''DIRECTORY''.
969
970
971 __--clean__
972
973
974 Remove the build tree after the packages are
975 made.
976
977
978 __--nobuild__
979
980
981 Do not execute any build stages. Useful for testing out spec
982 files.
983
984
985 __--rmsource__
986
987
988 Remove the sources after the build (may also be used
989 standalone, e.g. rpm --rmsource
990 foo.spec____
991
992
993 __--rmspec__
994
995
996 Remove the spec file after the build (may also be used
997 standalone, eg. rpm --rmspec
998 foo.spec____
999
1000
1001 __--short-circuit__
1002
1003
1004 Skip straight to specified stage (i.e., skip all stages
1005 leading up to the specified stage). Only valid with
1006 __-bc__ and __-bi__.
1007
1008
1009 __--sign__
1010
1011
1012 Embed a GPG signature in the package. This signature can be
1013 used to verify the integrity and the origin of the package.
1014 See the section on GPG SIGNATURES for configuration
1015 details.
1016
1017
1018 __--target__ ''PLATFORM''
1019
1020
1021 When building the package, interpret ''PLATFORM'' as
1022 __arch-vendor-os__ and set the macros __%_target__,
1023 __%_target_arch__, and __%_target_os__
1024 accordingly.
1025
1026
1027 __REBUILD AND RECOMPILE OPTIONS__
1028
1029
1030 There are two other ways to invoke building with
1031 rpm:
1032
1033
1034 __rpm__ {__--rebuild|--recompile__} ''SOURCEPKG
1035 ...''
1036
1037
1038 When invoked this way, __rpm__ installs the named source
1039 package, and does a prep, compile and install. In addition,
1040 __--rebuild__ builds a new binary package. When the build
1041 has completed, the build directory is removed (as in
1042 __--clean__) and the the sources and spec file for the
1043 package are removed.
1044
1045
1046 __SIGNING A PACKAGE__
1047
1048
1049 __rpm__ {__--addsign|--resign__} ''PACKAGE_FILE
1050 ...''
1051
1052
1053 The __--addsign__ option generates and inserts new
1054 signatures for each package. Any existing signatures will be
1055 discarded.
1056
1057
1058 The __--resign__ option generates and appends signatures
1059 for the listed packages while preserving the existing
1060 signatures.
1061
1062
1063 __GPG SIGNATURES__
1064
1065
1066 In order to use the signature feature, __rpm__ must be
1067 configured to run GPG and be able to find a public key ring
1068 with Red Hat (or other vendor) public keys. By default,
1069 __rpm__ uses the same conventions as GPG to find key
1070 rings, namely the __$GPGPATH__ environment variable. If
1071 your key rings are not located where GPG expects them to be,
1072 you will need to configure the macro __%_gpg_path__ to be
1073 the location of the GPG key rings to use.
1074
1075
1076 If you want to be able to sign packages you create yourself,
1077 you also need to create your own public and secret key pair
1078 (see the GPG manual). You will also need to configure the
1079 macros
1080
1081
1082 __%_signature__
1083
1084
1085 The signature type. Right now only gpg and pgp are
1086 supported.
1087
1088
1089 __%_gpg_name__
1090
1091
1092 The name of the
1093
1094
1095 When building packages you then add __--sign__ to the
1096 command line. You will be prompted for your pass phrase, and
1097 your package will be built and signed. For example, to be
1098 able to use GPG to sign packages as the user ''
1099 '' from the key rings
1100 located in ''/etc/rpm/.gpg'' using the executable
1101 ''/usr/bin/gpg'' you would include
1102
1103
1104 %_signature gpg
1105 %_gpg_path /etc/rpm/.gpg
1106 %_gpg_name John Doe
1107 in a macro configuration file. Use ''/etc/rpm/macros'' for per-system configuration and ''~/.rpmmacros'' for per-user configuration.
1108
1109
1110 __REBUILD DATABASE OPTIONS__
1111
1112
1113 The general form of an rpm rebuild database command
1114 is
1115
1116
1117 __rpm__ {__--initdb|--rebuilddb__} [[__-v__]
1118 [[__--dbpath__ ''DIRECTORY''] [[__--root__
1119 ''DIRECTORY'']
1120
1121
1122 Use __--initdb__ to create a new database, use
1123 __--rebuilddb__ to rebuild the database indices from the
1124 installed package headers.
1125
1126
1127 __SHOWRC__
1128
1129
1130 The command
1131
1132
1133 __rpm --showrc__
1134
1135
1136 shows the values __rpm__ will use for all of the options
1137 are currently set in ''rpmrc'' and ''macros''
1138 configuration file(s).
1139
1140
1141 __FTP/HTTP OPTIONS__
1142
1143
1144 __rpm__ can act as an FTP and/or HTTP client so that
1145 packages can be queried or installed from the internet.
1146 Package files for install, upgrade, and query operations may
1147 be specified as an __ftp__ or __http__ style
1148 URL:
1149
1150
1151 ftp://USER:PASSWORD@HOST:PORT/path/to/package.rpm
1152
1153
1154 If the __:PASSWORD__ portion is omitted, the password
1155 will be prompted for (once per user/hostname pair). If both
1156 the user and password are omitted, anonymous __ftp__ is
1157 used. In all cases, passive (PASV) __ftp__ transfers are
1158 performed.
1159
1160
1161 __rpm__ allows the following options to be used with ftp
1162 URLs:
1163
1164
1165 __--ftpproxy__ ''HOST''
1166
1167
1168 The host ''HOST'' will be used as a proxy server for all
1169 ftp transfers, which allows users to ftp through firewall
1170 machines which use proxy systems. This option may also be
1171 specified by configuring the macro
1172 __%_ftpproxy__.
1173
1174
1175 __--ftpport__ ''HOST''
1176
1177
1178 The TCP ''PORT'' number to use for the ftp connection on
1179 the proxy ftp server instead of the default port. This
1180 option may also be specified by configuring the macro
1181 __%_ftpport__.
1182
1183
1184 __rpm__ allows the following options to be used with
1185 __http__ URLs:
1186
1187
1188 __--httpproxy__ ''HOST''
1189
1190
1191 The host ''HOST'' will be used as a proxy server for all
1192 __http__ transfers. This option may also be specified by
1193 configuring the macro __%_httpproxy__.
1194
1195
1196 __--httpport__ ''PORT''
1197
1198
1199 The TCP ''PORT'' number to use for the __http__
1200 connection on the proxy http server instead of the default
1201 port. This option may also be specified by configuring the
1202 macro __%_httpport__.
1203 !!FILES
1204
1205
1206 ''/usr/lib/rpm/rpmrc''
1207
1208
1209 ''/etc/rpmrc''
1210
1211
1212 ''~/.rpmrc''
1213
1214
1215 ''/usr/lib/rpm/macros''
1216
1217
1218 ''/etc/rpm/macros''
1219
1220
1221 ''~/.rpmmacros''
1222
1223
1224 ''/var/lib/rpm/Conflictname''
1225
1226
1227 ''/var/lib/rpm/Basenames''
1228
1229
1230 ''/var/lib/rpm/Group''
1231
1232
1233 ''/var/lib/rpm/Name''
1234
1235
1236 ''/var/lib/rpm/Packages''
1237
1238
1239 ''/var/lib/rpm/Providename''
1240
1241
1242 ''/var/lib/rpm/Requirename''
1243
1244
1245 ''/var/lib/rpm/Triggername''
1246
1247
1248 ''/var/tmp/rpm*''
1249 !!SEE ALSO
1250
1251
1252 popt(3),
1253
1254
3 perry 1255 rpm2cpio(8),
1 perry 1256
1257
1258 rpmbuild(8),
1259
1260
1261 __http://www.rpm.org/__
1262 !!AUTHORS
1263
1264
1265 Marc Ewing
1266
1267
1268 Jeff Johnson
1269
1270
1271 Erik Troan
1272 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.