Debian Codegraph @

upstream/debian-unstable/man8/rpm-common.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-COMMON" "8" "2026-04-10" "RPM 6.0.1"
9 .PP
10 .SH NAME
11 rpm-common - Operations and options common to the main \fBrpm\fR(8) executables
12 .PP
13 .SH SYNOPSIS
14 \fIRPMCMD\fR [options] {\fB-?\&\fR|\fB--help\fR}
15 .PP
16 \fIRPMCMD\fR [options] \fB--showrc\fR
17 .PP
18 \fIRPMCMD\fR [options] \fB--version\fR
19 .PP
20 .SH DESCRIPTION
21 The following \fIRPMCMD\fR executables share common configuration and the
22 options and operations documented in this manual:
23 .PD 0
24 .IP \(bu 4
25 \fBrpm\fR(8)
26 .IP \(bu 4
27 \fBrpmdb\fR(8)
28 .IP \(bu 4
29 \fBrpmkeys\fR(8)
30 .IP \(bu 4
31 \fBrpmbuild\fR(1)
32 .IP \(bu 4
33 \fBrpmsign\fR(1)
34 .IP \(bu 4
35 \fBrpmspec\fR(1)
36 .PD
37 .PP
38 .SH OPERATIONS
39 \fB-?\&\fR,
40 \fB--help\fR
41 .RS 4
42 Print a longer usage message than normal.\&
43 .PP
44 .RE
45 \fB--version\fR
46 .RS 4
47 Print a single line containing the version number of \fBrpm\fR being
48 used.\&
49 .PP
50 .RE
51 \fB--showrc\fR
52 .RS 4
53 Dump information about \fBrpm\fR configuration to standard output.\&
54 .PP
55 .RE
56 .SH OPTIONS
57 \fB--color\fR <\fIMODE\fR>
58 .RS 4
59 Use terminal colors for highlighting error and debug message,
60 where \fIMODE\fR is one of:
61 .PD 0
62 .IP \(bu 4
63 \fBalways\fR
64 .IP \(bu 4
65 \fBauto\fR (use color output on terminals)
66 .IP \(bu 4
67 \fBnever\fR (default)
68 .PD
69 .PP
70 .RE
71 \fB--dbpath\fR \fIDIRECTORY\fR
72 .RS 4
73 Use the database in \fIDIRECTORY\fR rather than the default path
74 \fI/var/lib/rpm\fR.\&
75 .PP
76 .RE
77 \fB-D\fR '\&\fIMACRO\fR \fIEXPR\fR'\&,
78 \fB--define\fR='\&\fIMACRO\fR \fIEXPR\fR'\&
79 .RS 4
80 Defines \fIMACRO\fR with value \fIEXPR\fR.\&
81 .PP
82 .RE
83 \fB-E\fR '\&\fIEXPR\fR'\&,
84 \fB--eval\fR='\&\fIEXPR\fR'\&
85 .RS 4
86 Prints \fBrpm-macros\fR(7) expansion of \fIEXPR\fR.\&
87 .PP
88 .RE
89 \fB--load\fR \fIFILE\fR
90 .RS 4
91 Load an individual \fBrpm-macrofile\fR(5).\&
92 .PP
93 .RE
94 \fB--macros\fR \fIFILELIST\fR
95 .RS 4
96 Replace the list of macro files to be loaded with \fIFILELIST\fR.\&
97 See \fBMacro Configuration\fR for details.\&
98 .PP
99 .RE
100 \fB--nodigest\fR
101 .RS 4
102 Don'\&t verify package or header digests when reading.\&
103 .PP
104 .RE
105 \fB--nohdrchk\fR
106 .RS 4
107 Don'\&t verify database header(s) when retrieved.\&
108 .PP
109 .RE
110 \fB--nosignature\fR
111 .RS 4
112 Don'\&t verify package or header signatures when reading.\&
113 .PP
114 .RE
115 \fB--pipe\fR \fICMD\fR
116 .RS 4
117 Pipes the output of \fBrpm\fR to the command \fICMD\fR.\&
118 .PP
119 .RE
120 \fB--predefine\fR='\&\fIMACRO\fR \fIEXPR\fR'\&
121 .RS 4
122 Defines \fIMACRO\fR with value \fIEXPR\fR before loading macro files.\&
123 This is a very rare special-purpose switch, use \fB--define\fR
124 for the common macro definition needs.\&
125 .PP
126 .RE
127 \fB--target\fR \fIPLATFORM\fR
128 .RS 4
129 Use \fIPLATFORM\fR configuration instead of detecting automatically.\&
130 \fIPLATFORM\fR is formed as \fIarch\fR[-\fIos\fR].\&
131 .PP
132 .RE
133 \fB--quiet\fR
134 .RS 4
135 Print as little as possible - normally only error messages will be
136 displayed.\&
137 .PP
138 .RE
139 \fB--rcfile\fR \fIFILELIST\fR
140 .RS 4
141 Replace the default list of configuration files to be read with
142 \fIFILELIST\fR.\& See \fBrpmrc Configuration\fR for details.\&
143 .PP
144 .RE
145 \fB--root\fR \fIDIRECTORY\fR
146 .RS 4
147 Use the filesystem tree rooted at \fIDIRECTORY\fR for all operations.\&
148 Note that this means the database within \fIDIRECTORY\fR will be used
149 for dependency checks and any scriptlet(s) (e.\&g.\& \fB%post\fR if
150 installing, or \fB%prep\fR if building, a package) will be run after a
151 \fBchroot\fR(2) to \fIDIRECTORY\fR.\&
152 .PP
153 Note that rpm assumes the environment inside the root is set up by
154 the caller, such as any mounts needed for the operation inside the
155 root directory.\&
156 .PP
157 .RE
158 \fB--undefine\fR='\&\fIMACRO\fR'\&
159 .RS 4
160 Undefines \fIMACRO\fR.\&
161 .PP
162 .RE
163 \fB-v\fR,
164 \fB--verbose\fR
165 .RS 4
166 Print verbose information - normally routine progress messages will
167 be displayed.\& Supply more than once to increase verbosity, eg.\& \fB-vv\fR.\&
168 .PP
169 .RE
170 .SH DEBUG OPTIONS
171 \fB--debug\fR
172 .RS 4
173 Print lots of debug information.\&
174 .PP
175 .RE
176 \fB--fsmdebug\fR
177 .RS 4
178 Print debug information about payload handling.\&
179 .PP
180 .RE
181 \fB--rpmiodebug\fR
182 .RS 4
183 Print debug information about file IO.\&
184 .PP
185 .RE
186 \fB--stats\fR
187 .RS 4
188 Print runtime statistics of often used functions.\&
189 .PP
190 .RE
191 .SH FTP/HTTP OPTIONS
192 These options are deprecated.\& Use special purpose software such as
193 \fBcurl\fR(1) or \fBwget\fR(1) for fetching data from the internet.\&
194 .PP
195 For some operations, \fBrpm\fR can act as an FTP and/or HTTP client so that
196 packages can be queried or installed from the internet.\& Package files for
197 install, upgrade, and query operations may be specified as an \fBftp\fR or \fBhttp\fR
198 style URL:
199 .PP
200 \fIhttp://HOST[:PORT]/path/to/package.\&rpm\fR
201 .PP
202 \fIftp://[USER:PASSWORD]@HOST[:PORT]/path/to/package.\&rpm\fR
203 .PP
204 If both the user and password are omitted, anonymous \fBftp\fR is used.\&
205 .PP
206 \fBrpm\fR allows the following options to be used with \fBhttp\fR and \fBftp\fR URLs:
207 .PP
208 \fB--httpproxy\fR \fIHOST\fR
209 .RS 4
210 Use \fIHOST\fR as the proxy server for all \fBhttp\fR and
211 \fBftp\fR transfers.\& This option may also be specified by configuring
212 the macro \fB%_httpproxy\fR.\&
213 .PP
214 .RE
215 \fB--httpport\fR \fIPORT\fR
216 .RS 4
217 The TCP \fIPORT\fR number to use for the \fBhttp\fR connection on the
218 proxy http server instead of the default port.\& This option may also
219 be specified by configuring the macro \fB%_httpport\fR.\&
220 .PP
221 .RE
222 .SH ENVIRONMENT
223 \fBRPM_CONFIGDIR\fR
224 .RS 4
225 Used to override the default \fBrpm\fR configuration home,
226 typically \fI/usr/lib/rpm\fR.\&
227 .PP
228 .RE
229 .SH EXIT STATUS
230 On success, 0 is returned, a nonzero failure code otherwise.\&
231 .PP
232 .SH BUGS
233 Not all options are meaningful or implemented in all the executables
234 they show in.\& In particular, \fB--root\fR and the various verify-related
235 options are only honored by \fBrpm\fR(8) and \fBrpmdb\fR(8).\&
236 .PP
237 .SH FILES
238 .PP
239 .SS Database
240 .PP
241 .nf
242 .RS 4
243 /var/lib/rpm/
244 .fi
245 .RE
246 .PP
247 .SS Temporary
248 .PP
249 .nf
250 .RS 4
251 /var/tmp/rpm*
252 .fi
253 .RE
254 .PP
255 .SH SEE ALSO
256 \fBpopt\fR(3), \fBrpm\fR(8) \fBrpm-config\fR(5), \fBrpm-rpmrc\fR(5), \fBrpm-macros\fR(7)