1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22) |
2 .\" |
2 .\" |
3 .\" Standard preamble: |
3 .\" Standard preamble: |
4 .\" ======================================================================== |
4 .\" ======================================================================== |
5 .de Sh \" Subsection heading |
|
6 .br |
|
7 .if t .Sp |
|
8 .ne 5 |
|
9 .PP |
|
10 \fB\\$1\fR |
|
11 .PP |
|
12 .. |
|
13 .de Sp \" Vertical space (when we can't use .PP) |
5 .de Sp \" Vertical space (when we can't use .PP) |
14 .if t .sp .5v |
6 .if t .sp .5v |
15 .if n .sp |
7 .if n .sp |
16 .. |
8 .. |
17 .de Vb \" Begin verbatim text |
9 .de Vb \" Begin verbatim text |
23 .ft R |
15 .ft R |
24 .fi |
16 .fi |
25 .. |
17 .. |
26 .\" Set up some character translations and predefined strings. \*(-- will |
18 .\" Set up some character translations and predefined strings. \*(-- will |
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
28 .\" double quote, and \*(R" will give a right double quote. | will give a |
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will |
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and |
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, |
31 .\" expand to `' in nroff, nothing in troff, for use with C<>. |
23 .\" nothing in troff, for use with C<>. |
32 .tr \(*W-|\(bv\*(Tr |
24 .tr \(*W- |
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
34 .ie n \{\ |
26 .ie n \{\ |
35 . ds -- \(*W- |
27 . ds -- \(*W- |
36 . ds PI pi |
28 . ds PI pi |
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
46 . ds PI \(*p |
38 . ds PI \(*p |
47 . ds L" `` |
39 . ds L" `` |
48 . ds R" '' |
40 . ds R" '' |
49 'br\} |
41 'br\} |
50 .\" |
42 .\" |
|
43 .\" Escape single quotes in literal strings from groff's Unicode transform. |
|
44 .ie \n(.g .ds Aq \(aq |
|
45 .el .ds Aq ' |
|
46 .\" |
51 .\" If the F register is turned on, we'll generate index entries on stderr for |
47 .\" If the F register is turned on, we'll generate index entries on stderr for |
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
53 .\" entries marked with X<> in POD. Of course, you'll have to process the |
49 .\" entries marked with X<> in POD. Of course, you'll have to process the |
54 .\" output yourself in some meaningful fashion. |
50 .\" output yourself in some meaningful fashion. |
55 .if \nF \{\ |
51 .ie \nF \{\ |
56 . de IX |
52 . de IX |
57 . tm Index:\\$1\t\\n%\t"\\$2" |
53 . tm Index:\\$1\t\\n%\t"\\$2" |
58 .. |
54 .. |
59 . nr % 0 |
55 . nr % 0 |
60 . rr F |
56 . rr F |
61 .\} |
57 .\} |
62 .\" |
58 .el \{\ |
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
59 . de IX |
64 .\" way too many mistakes in technical documents. |
60 .. |
65 .hy 0 |
61 .\} |
66 .if n .na |
|
67 .\" |
62 .\" |
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
69 .\" Fear. Run. Save yourself. No user-serviceable parts. |
64 .\" Fear. Run. Save yourself. No user-serviceable parts. |
70 . \" fudge factors for nroff and troff |
65 . \" fudge factors for nroff and troff |
71 .if n \{\ |
66 .if n \{\ |
128 .rm #[ #] #H #V #F C |
123 .rm #[ #] #H #V #F C |
129 .\" ======================================================================== |
124 .\" ======================================================================== |
130 .\" |
125 .\" |
131 .IX Title "RPMTOOL 8" |
126 .IX Title "RPMTOOL 8" |
132 .TH RPMTOOL 8 "OpenPKG" "RPMTOOL(8)" "OpenPKG" |
127 .TH RPMTOOL 8 "OpenPKG" "RPMTOOL(8)" "OpenPKG" |
|
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
129 .\" way too many mistakes in technical documents. |
|
130 .if n .ad l |
|
131 .nh |
133 .SH "NAME" |
132 .SH "NAME" |
134 \&\fBrpmtool\fR \- RPM Auxiliary Tool |
133 rpmtool \- RPM Auxiliary Tool |
135 .SH "SYNOPSIS" |
134 .SH "SYNOPSIS" |
136 .IX Header "SYNOPSIS" |
135 .IX Header "SYNOPSIS" |
137 \&\fBrpmtool\fR |
136 \&\fBrpmtool\fR |
138 \&\fIcommand\fR |
137 \&\fIcommand\fR |
139 [\fIcommand-options\fR] |
138 [\fIcommand-options\fR] |
151 be \*(L"sun4u\-sunos5.8\*(R", etc. |
150 be \*(L"sun4u\-sunos5.8\*(R", etc. |
152 .Sp |
151 .Sp |
153 Example: |
152 Example: |
154 .Sp |
153 .Sp |
155 .Vb 5 |
154 .Vb 5 |
156 \& case `rpmtool platform`; in |
155 \& case \`rpmtool platform\`; in |
157 \& *-freebsd[34].* ) ... ;; |
156 \& *\-freebsd[34].* ) ... ;; |
158 \& *-sunos5.[678] ) ... ;; |
157 \& *\-sunos5.[678] ) ... ;; |
159 \& *-linux2.[24].* ) ... ;; |
158 \& *\-linux2.[24].* ) ... ;; |
160 \& esac |
159 \& esac |
161 .Ve |
160 .Ve |
162 .IP "\fBmflags\fR [\fB\-O\fR] \fItool\fR" 4 |
161 .IP "\fBmflags\fR [\fB\-O\fR] \fItool\fR" 4 |
163 .IX Item "mflags [-O] tool" |
162 .IX Item "mflags [-O] tool" |
164 This command outputs additional flags for \fImake\fR\|(1) for |
163 This command outputs additional flags for \fImake\fR\|(1) for |
168 outputs \*(L"\-j4\*(R" on an \s-1SMP\s0 system with 2 CPUs if \s-1GNU\s0 make or \s-1BSD\s0 pmake is used). |
167 outputs \*(L"\-j4\*(R" on an \s-1SMP\s0 system with 2 CPUs if \s-1GNU\s0 make or \s-1BSD\s0 pmake is used). |
169 .Sp |
168 .Sp |
170 Example: |
169 Example: |
171 .Sp |
170 .Sp |
172 .Vb 1 |
171 .Vb 1 |
173 \& make `rpmtool mflags -O make` |
172 \& make \`rpmtool mflags \-O make\` |
174 .Ve |
173 .Ve |
175 .IP "\fBcflags\fR [\fB\-O\fR] \fItool\fR" 4 |
174 .IP "\fBcflags\fR [\fB\-O\fR] \fItool\fR" 4 |
176 .IX Item "cflags [-O] tool" |
175 .IX Item "cflags [-O] tool" |
177 This command outputs additional flags for \fIcc\fR\|(1) for use with the program |
176 This command outputs additional flags for \fIcc\fR\|(1) for use with the program |
178 \&\fItool\fR. It provides only standard flags which always can be used. |
177 \&\fItool\fR. It provides only standard flags which always can be used. |
180 it outputs \*(L"\-O2 \-pipe\*(R" for \s-1GNU\s0 C/\*(C+ compiler). |
179 it outputs \*(L"\-O2 \-pipe\*(R" for \s-1GNU\s0 C/\*(C+ compiler). |
181 .Sp |
180 .Sp |
182 Example: |
181 Example: |
183 .Sp |
182 .Sp |
184 .Vb 1 |
183 .Vb 1 |
185 \& CC="$CC" CFLAGS=`rpmtool cflags -O $CC` ./configure ... |
184 \& CC="$CC" CFLAGS=\`rpmtool cflags \-O $CC\` ./configure ... |
186 .Ve |
185 .Ve |
187 .ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 |
186 .ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 |
188 .el .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 |
187 .el .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 |
189 .IX Item "cppflags [-p prefix] [[+|-subdir ...]" |
188 .IX Item "cppflags [-p prefix] [[+|-subdir ...]" |
190 This command output \fIcpp\fR\|(1) \f(CW\*(C`\-I\*(C'\fR options for the OpenPKG instance |
189 This command output \fIcpp\fR\|(1) \f(CW\*(C`\-I\*(C'\fR options for the OpenPKG instance |
191 \&\fIprefix\fR. It optionally can prefix or suffix with one or more \fIsubdir\fR |
190 \&\fIprefix\fR. It optionally can prefix or suffix with one or more \fIsubdir\fR |
192 related options, too. If \fIsubdir\fR is prefixed with \f(CW\*(C`+\*(C'\fR (or not |
191 related options, too. If \fIsubdir\fR is prefixed with \f(CW\*(C`+\*(C'\fR (or not |
194 prefixed with \f(CW\*(C`\-\*(C'\fR the generated option is prepended. |
193 prefixed with \f(CW\*(C`\-\*(C'\fR the generated option is prepended. |
195 .Sp |
194 .Sp |
196 Example: |
195 Example: |
197 .Sp |
196 .Sp |
198 .Vb 1 |
197 .Vb 1 |
199 \& rpmtool cppflags -p /foo bar -baz +quux |
198 \& rpmtool cppflags \-p /foo bar \-baz +quux |
200 .Ve |
199 .Ve |
201 .ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 |
200 .ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 |
202 .el .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 |
201 .el .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 |
203 .IX Item "ldflags [-p prefix] [[+|-subdir ...]" |
202 .IX Item "ldflags [-p prefix] [[+|-subdir ...]" |
204 This command output \fIld\fR\|(1) \f(CW\*(C`\-L\*(C'\fR options for the OpenPKG instance |
203 This command output \fIld\fR\|(1) \f(CW\*(C`\-L\*(C'\fR options for the OpenPKG instance |
205 \&\fIprefix\fR. It optionally can prefix or suffix with one or more \fIsubdir\fR |
204 \&\fIprefix\fR. It optionally can prefix or suffix with one or more \fIsubdir\fR |
206 related options, too. If \fIsubdir\fR is prefixed with \f(CW\*(C`+\*(C'\fR (or not |
205 related options, too. If \fIsubdir\fR is prefixed with \f(CW\*(C`+\*(C'\fR (or not |
208 prefixed with \f(CW\*(C`\-\*(C'\fR the generated option is prepended. |
207 prefixed with \f(CW\*(C`\-\*(C'\fR the generated option is prepended. |
209 .Sp |
208 .Sp |
210 Example: |
209 Example: |
211 .Sp |
210 .Sp |
212 .Vb 1 |
211 .Vb 1 |
213 \& rpmtool ldflags -p /foo bar -baz +quux |
212 \& rpmtool ldflags \-p /foo bar \-baz +quux |
214 .Ve |
213 .Ve |
215 .IP "\fBfiles\fR [\fB\-v\fR] [\fB\-o\fR \fIoutfile\fR] [\fB\-r\fR \fIbuild-root\fR] [\fIentry\fR ...]" 4 |
214 .IP "\fBfiles\fR [\fB\-v\fR] [\fB\-o\fR \fIoutfile\fR] [\fB\-r\fR \fIbuild-root\fR] [\fIentry\fR ...]" 4 |
216 .IX Item "files [-v] [-o outfile] [-r build-root] [entry ...]" |
215 .IX Item "files [-v] [-o outfile] [-r build-root] [entry ...]" |
217 This is a dynamic variant of the \s-1RPM\s0 \f(CW%files\fR section, i.e., it |
216 This is a dynamic variant of the \s-1RPM\s0 \f(CW%files\fR section, i.e., it |
218 dynamically creates the contents of the \f(CW%files\fR section for use with |
217 dynamically creates the contents of the \f(CW%files\fR section for use with |
227 .RS 4 |
226 .RS 4 |
228 .IP "\fBTrailing Tags\fR" 4 |
227 .IP "\fBTrailing Tags\fR" 4 |
229 .IX Item "Trailing Tags" |
228 .IX Item "Trailing Tags" |
230 \&\s-1RPM\s0 requires that all tags (like \f(CW\*(C`%attr(...)\*(C'\fR or \f(CW%dir\fR) preceed the |
229 \&\s-1RPM\s0 requires that all tags (like \f(CW\*(C`%attr(...)\*(C'\fR or \f(CW%dir\fR) preceed the |
231 path in a file list entry. This sometimes leads to ugly and unreadable |
230 path in a file list entry. This sometimes leads to ugly and unreadable |
232 file lists, because all paths cannot be left\-aligned. With \fIrpmtool\fR\|(8) |
231 file lists, because all paths cannot be left-aligned. With \fIrpmtool\fR\|(8) |
233 tags in the input file list can be at leading and trailing positions. |
232 tags in the input file list can be at leading and trailing positions. |
234 The output file list will nevertheless have all tags in leading |
233 The output file list will nevertheless have all tags in leading |
235 positions for \s-1RPM\s0. |
234 positions for \s-1RPM\s0. |
236 .IP "\fBSyntactical Set Pattern\fR" 4 |
235 .IP "\fBSyntactical Set Pattern\fR" 4 |
237 .IX Item "Syntactical Set Pattern" |
236 .IX Item "Syntactical Set Pattern" |
260 Example: |
259 Example: |
261 .Sp |
260 .Sp |
262 .Vb 8 |
261 .Vb 8 |
263 \& %install |
262 \& %install |
264 \& : |
263 \& : |
265 \& rpmtool files -o files -r$RPM_BUILD_ROOT \e |
264 \& rpmtool files \-o files \-r$RPM_BUILD_ROOT \e |
266 \& '%defattr(-,foo,foo)' \e |
265 \& \*(Aq%defattr(\-,foo,foo)\*(Aq \e |
267 \& '%{prefix}' \e |
266 \& \*(Aq%{prefix}\*(Aq \e |
268 \& '%attr(1755,root,foo) %{prefix}/bin/bar' \e |
267 \& \*(Aq%attr(1755,root,foo) %{prefix}/bin/bar\*(Aq \e |
269 \& '%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}' \e |
268 \& \*(Aq%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}\*(Aq \e |
270 \& '%not %{prefix}/info/dir' |
269 \& \*(Aq%not %{prefix}/info/dir\*(Aq |
271 .Ve |
270 \& |
272 .Sp |
271 \& %files \-f files |
273 .Vb 1 |
|
274 \& %files -f files |
|
275 .Ve |
272 .Ve |
276 .RE |
273 .RE |
277 .IP "\fBmsg\fR [\fB\-b\fR]" 4 |
274 .IP "\fBmsg\fR [\fB\-b\fR]" 4 |
278 .IX Item "msg [-b]" |
275 .IX Item "msg [-b]" |
279 This displays the contents of \fIstdin\fR as a boxed message. If option |
276 This displays the contents of \fIstdin\fR as a boxed message. If option |