openpkg/rpmtool.8

changeset 767
3ee660c5bc4f
parent 13
cb59d6afeb61
equal deleted inserted replaced
0:cf8c33f21256 1:21c72f40c02c
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

mercurial