Debian Codegraph @

upstream/opensuse-tumbleweed/man1/rpmdep.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "RPMDEP 1"
61 .TH RPMDEP 1 2020-09-07 "perl v5.42.0" "User Contributed Perl Documentation"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 rpmdep \- display the full dependency of an installed rpm package
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 rpmdep is an improved \*(Aqrpm \-qR\*(Aq command :
71 it search recursively for package dependencies,
72 and resolves all dependencies to package names.
73 It can also prepare a file to build a graph of dependencies, with graphviz.
74 .SH SYNOPSIS
75 .IX Header "SYNOPSIS"
76 rpmdep.pl [options] package
77 .PP
78 options:
79 .PP
80 .Vb 5
81 \& \-help brief help message
82 \& \-man full documentation
83 \& \-V, \-\-version print version
84 \& \-use\-cache use cache file instead rpm query
85 \& \-clear\-cache clear cache file
86 \&
87 \& \-level display dependencies by level
88 \& \-debug debug mode
89 \& \-dot dotfile build a dot file for graphviz
90 \& \-depending instead of dependencies, display dependings
91 \& \-suggests also show very weak dependencies : suggests
92 \& \-recommends also show weak dependencies : recommends
93 \& \-all works on all installed packages
94 .Ve
95 .SH "REQUIRED ARGUMENTS"
96 .IX Header "REQUIRED ARGUMENTS"
97 a package to analyse. Only one name may be given.
98 It is not necessary if you are using the \-all option.
99 .SH OPTIONS
100 .IX Header "OPTIONS"
101 .IP \fB\-help\fR 8
102 .IX Item "-help"
103 Print a brief help message and exits.
104 .IP \fB\-man\fR 8
105 .IX Item "-man"
106 Print the manual page and exits.
107 .IP \fB\-version\fR 8
108 .IX Item "-version"
109 Print the program release and exit.
110 .IP \fB\-debug\fR 8
111 .IX Item "-debug"
112 The program works and print debugging messages.
113 .IP \fB\-level\fR 8
114 .IX Item "-level"
115 The program also print dependencies by level
116 .IP \fB\-dot\fR 8
117 .IX Item "-dot"
118 create a dot file to be used by graphviz.
119 in normal call, an arrow from a to b means that a package depends (uses) b package.
120 in dependings call, an arrow from a to b means that a package is used by b package.
121 .IP \fB\-use\-cache\fR 8
122 .IX Item "-use-cache"
123 the rpm query may be long (10 to 30 s). If you will run an rpmorphan tool
124 several time, this option will allow to gain a lot of time :
125 it save the rpm query on a file cache (first call), then
126 use this cache instead quering rpm (others calls).
127 .IP \fB\-clear\-cache\fR 8
128 .IX Item "-clear-cache"
129 to remove cache file. Can be used with \-use\-cache to write
130 a new cache.
131 .IP \fB\-\-depending\fR 8
132 .IX Item "--depending"
133 instead of showing package dependencies (rpm \-qR),
134 display packages wich are depending upon the given argument :
135 it then act as an improved \*(Aqrpm \-q \-\-whatrequires\*(Aq command
136 .IP \fB\-\-suggests\fR 8
137 .IX Item "--suggests"
138 add to "required" dependencies, very weak dependencies
139 .IP \fB\-\-recommends\fR 8
140 .IX Item "--recommends"
141 add to "required" dependencies, weak dependencies
142 .IP \fB\-\-all\fR 8
143 .IX Item "--all"
144 rpmdep will then work on all installed packages, and display the results
145 sorted by the number of depends (or dependings).
146 .SH USAGE
147 .IX Header "USAGE"
148 get the full list of dependencies for rpmrebuild package
149 .PP
150 .Vb 1
151 \& rpmdep.pl rpmrebuild
152 .Ve
153 .PP
154 get the full list of dependencies for rpmrestore package and
155 build the graph data file (rpmrestore.dot)
156 .PP
157 .Vb 1
158 \& rpmdep.pl \-dot rpmrestore.dot rpmrestore
159 .Ve
160 .PP
161 build a png graph image from the graph data
162 .PP
163 .Vb 1
164 \& dot \-Tpng rpmrestore.dot \-o rpmrestore.png
165 .Ve
166 .PP
167 get depending package of perl
168 .PP
169 .Vb 1
170 \& rpmdep.pl \-\-depending perl
171 .Ve
172 .PP
173 check is a package is an orphan
174 .PP
175 .Vb 1
176 \& rpmdep.pl \-\-depending afick\-gui
177 .Ve
178 .PP
179 list all package dependencies
180 .PP
181 .Vb 1
182 \& rpmdep.pl \-a
183 .Ve
184 .PP
185 list all packages dependings and prepare a graph
186 .PP
187 .Vb 1
188 \& rpmdep.pl \-a \-\-depending \-\-dot alldep.dot
189 .Ve
190 .PP
191 get all dependencies of rpmrebuild package
192 .PP
193 .Vb 1
194 \& rpmdep.pl \-suggests \-\-recommends rpmrebuild
195 .Ve
196 .SH FILES
197 .IX Header "FILES"
198 the program can use the /tmp/rpmorphan.cache file
199 .SH DIAGNOSTICS
200 .IX Header "DIAGNOSTICS"
201 the debug mode allow to see all the recursive work
202 .PP
203 others messages are
204 .IP "\fBpackage ... is not installed\fR" 8
205 .IX Item "package ... is not installed"
206 this is not a name of an installed package
207 .IP "\fB... has no dependencies\fR" 8
208 .IX Item "... has no dependencies"
209 this can comes for some admin tools (ash for example)
210 .IP "\fB... depends upon (list)\fR" 8
211 .IX Item "... depends upon (list)"
212 return a list of sorted and comma separated packages
213 .IP "\fB... is needed by (list)\fR" 8
214 .IX Item "... is needed by (list)"
215 return the depending package list
216 .IP "\fBno depending : ... is an orphan\fR" 8
217 .IX Item "no depending : ... is an orphan"
218 the given package has no depending packages : it is an orphan
219 .SH "EXIT STATUS"
220 .IX Header "EXIT STATUS"
221 O if all is ok
222 .PP
223 >=1 if a problem
224 .SH CONFIGURATION
225 .IX Header "CONFIGURATION"
226 nothing
227 .SH DEPENDENCIES
228 .IX Header "DEPENDENCIES"
229 you should use graphviz to build graph from dot files
230 .SH INCOMPATIBILITIES
231 .IX Header "INCOMPATIBILITIES"
232 not known
233 .SH "BUGS AND LIMITATIONS"
234 .IX Header "BUGS AND LIMITATIONS"
235 the program does not work well on program installed
236 in several versions
237 .PP
238 the code does not use the following rpm tags : Supplements, Enhances
239 .SH NOTES
240 .IX Header "NOTES"
241 this program can be used as "normal" (unpriviledge) user
242 .SH "SEE ALSO"
243 .IX Header "SEE ALSO"
244 \fIrpm\fR\|(1) for rpm call
245 .PP
246 \fIrpmorphan\fR\|(1)
247 .PP
248 \fIrpmusage\fR\|(1)
249 .PP
250 \fIrpmduplicates\fR\|(1)
251 .PP
252 \fIrpmextra\fR\|(1)
253 .SH "LICENSE AND COPYRIGHT"
254 .IX Header "LICENSE AND COPYRIGHT"
255 Copyright (C) 2008 by Eric Gerbier
256 This program is free software; you can redistribute it and/or modify
257 it under the terms of the GNU General Public License as published by
258 the Free Software Foundation; either version 2 of the License, or
259 (at your option) any later version.
260 .SH AUTHOR
261 .IX Header "AUTHOR"
262 Eric Gerbier
263 .PP
264 you can report any bug or suggest to [email protected]