Debian Codegraph @

upstream/mageia-cauldron/man1/rpmdep.1

raw
1 .\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 . ds C`
42 . ds C'
43 'br\}
44 .\"
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
46 .ie \n(.g .ds Aq \(aq
47 .el .ds Aq '
48 .\"
49 .\" If the F register is >0, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD. Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
53 .\"
54 .\" Avoid warning from groff about undefined register 'F'.
55 .de IX
56 ..
57 .nr rF 0
58 .if \n(.g .if rF .nr rF 1
59 .if (\n(rF:(\n(.g==0)) \{\
60 . if \nF \{\
61 . de IX
62 . tm Index:\\$1\t\\n%\t"\\$2"
63 ..
64 . if !\nF==2 \{\
65 . nr % 0
66 . nr F 2
67 . \}
68 . \}
69 .\}
70 .rr rF
71 .\"
72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73 .\" Fear. Run. Save yourself. No user-serviceable parts.
74 . \" fudge factors for nroff and troff
75 .if n \{\
76 . ds #H 0
77 . ds #V .8m
78 . ds #F .3m
79 . ds #[ \f1
80 . ds #] \fP
81 .\}
82 .if t \{\
83 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
84 . ds #V .6m
85 . ds #F 0
86 . ds #[ \&
87 . ds #] \&
88 .\}
89 . \" simple accents for nroff and troff
90 .if n \{\
91 . ds ' \&
92 . ds ` \&
93 . ds ^ \&
94 . ds , \&
95 . ds ~ ~
96 . ds /
97 .\}
98 .if t \{\
99 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
100 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
101 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
102 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
103 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
104 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
105 .\}
106 . \" troff and (daisy-wheel) nroff accents
107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
114 .ds ae a\h'-(\w'a'u*4/10)'e
115 .ds Ae A\h'-(\w'A'u*4/10)'E
116 . \" corrections for vroff
117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
119 . \" for low resolution devices (crt and lpr)
120 .if \n(.H>23 .if \n(.V>19 \
121 \{\
122 . ds : e
123 . ds 8 ss
124 . ds o a
125 . ds d- d\h'-1'\(ga
126 . ds D- D\h'-1'\(hy
127 . ds th \o'bp'
128 . ds Th \o'LP'
129 . ds ae ae
130 . ds Ae AE
131 .\}
132 .rm #[ #] #H #V #F C
133 .\" ========================================================================
134 .\"
135 .IX Title "RPMDEP 1"
136 .TH RPMDEP 1 "2018-09-13" "perl v5.26.2" "User Contributed Perl Documentation"
137 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138 .\" way too many mistakes in technical documents.
139 .if n .ad l
140 .nh
141 .SH "NAME"
142 rpmdep \- display the full dependency of an installed rpm package
143 .SH "DESCRIPTION"
144 .IX Header "DESCRIPTION"
145 rpmdep is an improved 'rpm \-qR' command :
146 it search recursively for package dependencies,
147 and resolves all dependencies to package names.
148 It can also prepare a file to build a graph of dependencies, with graphviz.
149 .SH "SYNOPSIS"
150 .IX Header "SYNOPSIS"
151 rpmdep.pl [options] package
152 .PP
153 options:
154 .PP
155 .Vb 5
156 \& \-help brief help message
157 \& \-man full documentation
158 \& \-V, \-\-version print version
159 \& \-use\-cache use cache file instead rpm query
160 \& \-clear\-cache clear cache file
161 \&
162 \& \-level display dependencies by level
163 \& \-debug debug mode
164 \& \-dot dotfile build a dot file for graphviz
165 \& \-depending instead of dependencies, display dependings
166 \& \-suggests also show very weak dependencies : suggests
167 \& \-recommends also show weak dependencies : recommends
168 \& \-all works on all installed packages
169 .Ve
170 .SH "REQUIRED ARGUMENTS"
171 .IX Header "REQUIRED ARGUMENTS"
172 a package to analyse. Only one name may be given.
173 It is not necessary if you are using the \-all option.
174 .SH "OPTIONS"
175 .IX Header "OPTIONS"
176 .IP "\fB\-help\fR" 8
177 .IX Item "-help"
178 Print a brief help message and exits.
179 .IP "\fB\-man\fR" 8
180 .IX Item "-man"
181 Print the manual page and exits.
182 .IP "\fB\-version\fR" 8
183 .IX Item "-version"
184 Print the program release and exit.
185 .IP "\fB\-debug\fR" 8
186 .IX Item "-debug"
187 The program works and print debugging messages.
188 .IP "\fB\-level\fR" 8
189 .IX Item "-level"
190 The program also print dependencies by level
191 .IP "\fB\-dot\fR" 8
192 .IX Item "-dot"
193 create a dot file to be used by graphviz.
194 in normal call, an arrow from a to b means that a package depends (uses) b package.
195 in dependings call, an arrow from a to b means that a package is used by b package.
196 .IP "\fB\-use\-cache\fR" 8
197 .IX Item "-use-cache"
198 the rpm query may be long (10 to 30 s). If you will run an rpmorphan tool
199 several time, this option will allow to gain a lot of time :
200 it save the rpm query on a file cache (first call), then
201 use this cache instead quering rpm (others calls).
202 .IP "\fB\-clear\-cache\fR" 8
203 .IX Item "-clear-cache"
204 to remove cache file. Can be used with \-use\-cache to write
205 a new cache.
206 .IP "\fB\-\-depending\fR" 8
207 .IX Item "--depending"
208 instead of showing package dependencies (rpm \-qR),
209 display packages wich are depending upon the given argument :
210 it then act as an improved 'rpm \-q \-\-whatrequires' command
211 .IP "\fB\-\-suggests\fR" 8
212 .IX Item "--suggests"
213 add to \*(L"required\*(R" dependencies, very weak dependencies
214 .IP "\fB\-\-recommends\fR" 8
215 .IX Item "--recommends"
216 add to \*(L"required\*(R" dependencies, weak dependencies
217 .IP "\fB\-\-all\fR" 8
218 .IX Item "--all"
219 rpmdep will then work on all installed packages, and display the results
220 sorted by the number of depends (or dependings).
221 .SH "USAGE"
222 .IX Header "USAGE"
223 get the full list of dependencies for rpmrebuild package
224 .PP
225 .Vb 1
226 \& rpmdep.pl rpmrebuild
227 .Ve
228 .PP
229 get the full list of dependencies for rpmrestore package and
230 build the graph data file (rpmrestore.dot)
231 .PP
232 .Vb 1
233 \& rpmdep.pl \-dot rpmrestore.dot rpmrestore
234 .Ve
235 .PP
236 build a png graph image from the graph data
237 .PP
238 .Vb 1
239 \& dot \-Tpng rpmrestore.dot \-o rpmrestore.png
240 .Ve
241 .PP
242 get depending package of perl
243 .PP
244 .Vb 1
245 \& rpmdep.pl \-\-depending perl
246 .Ve
247 .PP
248 check is a package is an orphan
249 .PP
250 .Vb 1
251 \& rpmdep.pl \-\-depending afick\-gui
252 .Ve
253 .PP
254 list all package dependencies
255 .PP
256 .Vb 1
257 \& rpmdep.pl \-a
258 .Ve
259 .PP
260 list all packages dependings and prepare a graph
261 .PP
262 .Vb 1
263 \& rpmdep.pl \-a \-\-depending \-\-dot alldep.dot
264 .Ve
265 .PP
266 get all dependencies of rpmrebuild package
267 .PP
268 .Vb 1
269 \& rpmdep.pl \-suggests \-\-recommends rpmrebuild
270 .Ve
271 .SH "FILES"
272 .IX Header "FILES"
273 the program can use the /tmp/rpmorphan.cache file
274 .SH "DIAGNOSTICS"
275 .IX Header "DIAGNOSTICS"
276 the debug mode allow to see all the recursive work
277 .PP
278 others messages are
279 .IP "\fBpackage ... is not installed\fR" 8
280 .IX Item "package ... is not installed"
281 this is not a name of an installed package
282 .IP "\fB... has no dependencies\fR" 8
283 .IX Item "... has no dependencies"
284 this can comes for some admin tools (ash for example)
285 .IP "\fB... depends upon (list)\fR" 8
286 .IX Item "... depends upon (list)"
287 return a list of sorted and comma separated packages
288 .IP "\fB... is needed by (list)\fR" 8
289 .IX Item "... is needed by (list)"
290 return the depending package list
291 .IP "\fBno depending : ... is an orphan\fR" 8
292 .IX Item "no depending : ... is an orphan"
293 the given package has no depending packages : it is an orphan
294 .SH "EXIT STATUS"
295 .IX Header "EXIT STATUS"
296 O if all is ok
297 .PP
298 >=1 if a problem
299 .SH "CONFIGURATION"
300 .IX Header "CONFIGURATION"
301 nothing
302 .SH "DEPENDENCIES"
303 .IX Header "DEPENDENCIES"
304 you should use graphviz to build graph from dot files
305 .SH "INCOMPATIBILITIES"
306 .IX Header "INCOMPATIBILITIES"
307 not known
308 .SH "BUGS AND LIMITATIONS"
309 .IX Header "BUGS AND LIMITATIONS"
310 the program does not work well on program installed
311 in several versions
312 .PP
313 the code does not use the following rpm tags : Supplements, Enhances
314 .SH "NOTES"
315 .IX Header "NOTES"
316 this program can be used as \*(L"normal\*(R" (unpriviledge) user
317 .SH "SEE ALSO"
318 .IX Header "SEE ALSO"
319 \fIrpm\fR\|(1) for rpm call
320 .PP
321 \fIrpmorphan\fR\|(1)
322 .PP
323 \fIrpmusage\fR\|(1)
324 .PP
325 \fIrpmduplicates\fR\|(1)
326 .PP
327 \fIrpmextra\fR\|(1)
328 .SH "LICENSE AND COPYRIGHT"
329 .IX Header "LICENSE AND COPYRIGHT"
330 Copyright (C) 2008 by Eric Gerbier
331 This program is free software; you can redistribute it and/or modify
332 it under the terms of the \s-1GNU\s0 General Public License as published by
333 the Free Software Foundation; either version 2 of the License, or
334 (at your option) any later version.
335 .SH "AUTHOR"
336 .IX Header "AUTHOR"
337 Eric Gerbier
338 .PP
339 you can report any bug or suggest to [email protected]