Debian Codegraph @

upstream/mageia-cauldron/man1/rpmusage.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 "RPMUSAGE 1"
136 .TH RPMUSAGE 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 rpmusage \- display rpm packages last use
143 .SH "DESCRIPTION"
144 .IX Header "DESCRIPTION"
145 rpmusage will display for each package, the last date it was used (in days). It can be used
146 to find unused packages. It use the atime field of all package's files to do this job.
147 Note : as it scan all files inodes, the run may be long ...
148 .SH "SYNOPSIS"
149 .IX Header "SYNOPSIS"
150 rpmusage.pl [options] [targets]
151 .PP
152 options:
153 .PP
154 .Vb 3
155 \& \-help brief help message
156 \& \-man full documentation
157 \& \-V, \-\-version print version
158 \&
159 \& \-verbose verbose
160 \& \-fullalgo force full algorythm
161 \& \-use\-cache use cache to avoid rpm query
162 \& \-clear\-cache remove cache file
163 \&
164 \& \-exclude pac exclude pac from results
165 \& \-install\-time +/\-d apply on packages which are installed before (after) d days
166 \& \-access\-time d apply on packages which are not been accessed for d days (slow)
167 .Ve
168 .PP
169 targets:
170 .PP
171 .Vb 10
172 \& \-package pac search last access on pac package
173 \& \-all apply on all packages (this is the default)
174 \& \-guess\-perl apply on perl packages
175 \& \-guess\-python apply on python packages
176 \& \-guess\-pike apply on pike packages
177 \& \-guess\-ruby apply on ruby packages
178 \& \-guess\-common apply on common packages
179 \& \-guess\-data apply on data packages
180 \& \-guess\-doc apply on documentation packages
181 \& \-guess\-dev apply on development packages
182 \& \-guess\-lib apply on library packages
183 \& \-guess\-all apply all \-guess\-* options (perl, python ...)
184 \& \-guess\-custom regex apply the given regex to filter to package\*(Aqs names to filter the output
185 .Ve
186 .SH "REQUIRED ARGUMENTS"
187 .IX Header "REQUIRED ARGUMENTS"
188 it can be used without any argument, and then will apply on all packages
189 .SH "OPTIONS"
190 .IX Header "OPTIONS"
191 .IP "\fB\-help\fR" 8
192 .IX Item "-help"
193 Print a brief help message and exits.
194 .IP "\fB\-man\fR" 8
195 .IX Item "-man"
196 Print the manual page and exits.
197 .IP "\fB\-version\fR" 8
198 .IX Item "-version"
199 Print the program release and exit.
200 .IP "\fB\-verbose\fR" 8
201 .IX Item "-verbose"
202 The program works and print debugging messages.
203 .IP "\fB\-use\-cache\fR" 8
204 .IX Item "-use-cache"
205 the rpm query may be long (10 to 30 s). If you will run an rpmorphan tool
206 several time, this option will allow to gain a lot of time :
207 it save the rpm query on a file cache (first call), then
208 use this cache instead quering rpm (others calls).
209 .IP "\fB\-clear\-cache\fR" 8
210 .IX Item "-clear-cache"
211 to remove cache file. Can be used with \-use\-cache to write
212 a new cache.
213 .IP "\fB\-exclude\fR" 8
214 .IX Item "-exclude"
215 this option will specify the packages to exclude from the output.
216 Can be used as '\-\-exclude pac1 \-\-exclude pac2'
217 or '\-\-exclude \*(L"pac1, pac2\*(R"'
218 .IP "\fB\-install\-time\fR" 8
219 .IX Item "-install-time"
220 install-time is a filter on the period from the package installation date to now (in days).
221 if set positive, it only allow packages installed before x days.
222 if set negative, it only allow packages installed since x days.
223 .IP "\fB\-access\-time\fR" 8
224 .IX Item "-access-time"
225 access-time is designed to filter packages which have not been used since x days.
226 .Sp
227 be careful : this option will slow the program
228 .IP "\fB\-fullalgo\fR" 8
229 .IX Item "-fullalgo"
230 for a small list of packages, rpmusage use a different quicker methode : rpm \-e \-\-test
231 .Sp
232 this option can be used to force the use of the full algo
233 .IP "\fB\-package\fR" 8
234 .IX Item "-package"
235 search if the given package(s) is(are) orphaned.
236 Can be used as '\-\-package pac1 \-\-package pac2'
237 or '\-\-package \*(L"pac1, pac2\*(R"'
238 .IP "\fB\-all\fR" 8
239 .IX Item "-all"
240 apply on all installed packages. The output should be interpreted.
241 For example lilo or grub are orphaned packages, but are necessary
242 to boot ...
243 .Sp
244 the \*(L"\-install\-time\*(R" and \*(L"\-access\-time\*(R" options may be useful to filter the list
245 .IP "\fB\-guess\-perl\fR" 8
246 .IX Item "-guess-perl"
247 This option tries to find perl modules. It tries to match \*(L"^perl\*(R"
248 .IP "\fB\-guess\-python\fR" 8
249 .IX Item "-guess-python"
250 This option tries to find python modules. It tries to match \*(L"^python\*(R"
251 .IP "\fB\-guess\-pike\fR" 8
252 .IX Item "-guess-pike"
253 This option tries to find pike modules. It tries to match \*(L"^pike\*(R"
254 .IP "\fB\-guess\-ruby\fR" 8
255 .IX Item "-guess-ruby"
256 This option tries to find ruby modules. It tries to match \*(L"^ruby\*(R"
257 .IP "\fB\-guess\-common\fR" 8
258 .IX Item "-guess-common"
259 This option tries to find common packages. It tries to match \*(L"\-common$\*(R"
260 .IP "\fB\-guess\-data\fR" 8
261 .IX Item "-guess-data"
262 This option tries to find data packages. It tries to match \*(L"\-data$\*(R"
263 .IP "\fB\-guess\-doc\fR" 8
264 .IX Item "-guess-doc"
265 This option tries to find documentation packages. It tries to match \*(L"\-doc$\*(R"
266 .IP "\fB\-guess\-data\fR" 8
267 .IX Item "-guess-data"
268 This option tries to find data packages. It tries to match \*(L"\-data$\*(R"
269 .IP "\fB\-guess\-dev\fR" 8
270 .IX Item "-guess-dev"
271 This option tries to find development packages. It tries to match \*(L"\-devel$\*(R"
272 .IP "\fB\-guess\-lib\fR" 8
273 .IX Item "-guess-lib"
274 This option tries to find library packages. It tries to match \*(L"^lib\*(R"
275 .IP "\fB\-guess\-all\fR" 8
276 .IX Item "-guess-all"
277 This is a short to tell : Try all of the above (perl, python ...)
278 .IP "\fB\-guess\-custom\fR" 8
279 .IX Item "-guess-custom"
280 this will allow you to specify your own filter. for exemple \*(L"^wh\*(R"
281 will match whois, whatsnewfm ...
282 .SH "USAGE"
283 .IX Header "USAGE"
284 display all packages in access date order
285 .PP
286 rpmusage.pl \-\-all | sort \-k 2 \-n
287 .PP
288 only ask for perl packages
289 .PP
290 rpmusage.pl \-\-guess\-perl | sort \-k 2 \-n
291 .PP
292 to read the output :
293 \&\*(L"python-pexpect 97 on /usr/share/doc/python\-pexpect\*(R"
294 means the package was last used 97 days ago and the more recently used file was the
295 /usr/share/doc/python\-pexpect file
296 .SH "FILES"
297 .IX Header "FILES"
298 /tmp/rpmorphan.cache : cache file to store rpm query. The cache
299 file is common to all rpmorphan tools
300 .SH "DEPENDENCIES"
301 .IX Header "DEPENDENCIES"
302 rpmusage uses only standard perl module.
303 .PP
304 but it needs the rpm command tool.
305 .SH "BUGS AND LIMITATIONS"
306 .IX Header "BUGS AND LIMITATIONS"
307 the software can only work with one version of each software :
308 we only treat the first version seen
309 .SH "CONFIGURATION"
310 .IX Header "CONFIGURATION"
311 the program can read rcfile if some exists.
312 it will load in order
313 .PP
314 /etc/rpmorphanrc
315 .PP
316 ~/.rpmorphanrc
317 .PP
318 \&.rpmorphanrc
319 .PP
320 In this file,
321 .PP
322 # are comments,
323 .PP
324 and parameters are stored in the following format :
325 parameter = value
326 .PP
327 example :
328 .PP
329 all = 1
330 .PP
331 curses = 1
332 .SH "INCOMPATIBILITIES"
333 .IX Header "INCOMPATIBILITIES"
334 not known
335 .SH "DIAGNOSTICS"
336 .IX Header "DIAGNOSTICS"
337 to be written
338 .SH "NOTES"
339 .IX Header "NOTES"
340 this program should be used as root superuser, because it needs to access
341 (in read mode) to all files
342 .SH "SEE ALSO"
343 .IX Header "SEE ALSO"
344 \fIrpm\fR\|(1) for rpm call
345 .PP
346 \fIrpmorphan\fR\|(1)
347 .PP
348 \fIrpmdep\fR\|(1)
349 .PP
350 \fIrpmduplicates\fR\|(1)
351 .PP
352 \fIrpmextra\fR\|(1)
353 .SH "EXIT STATUS"
354 .IX Header "EXIT STATUS"
355 should be allways 0
356 .SH "LICENSE AND COPYRIGHT"
357 .IX Header "LICENSE AND COPYRIGHT"
358 Copyright (C) 2006 by Eric Gerbier
359 This program is free software; you can redistribute it and/or modify
360 it under the terms of the \s-1GNU\s0 General Public License as published by
361 the Free Software Foundation; either version 2 of the License, or
362 (at your option) any later version.
363 .SH "AUTHOR"
364 .IX Header "AUTHOR"
365 Eric Gerbier
366 .PP
367 you can report any bug or suggest to [email protected]