Debian Codegraph @

upstream/opensuse-tumbleweed/man1/rpmusage.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 "RPMUSAGE 1"
61 .TH RPMUSAGE 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 rpmusage \- display rpm packages last use
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 rpmusage will display for each package, the last date it was used (in days). It can be used
71 to find unused packages. It use the atime field of all package\*(Aqs files to do this job.
72 Note : as it scan all files inodes, the run may be long ...
73 .SH SYNOPSIS
74 .IX Header "SYNOPSIS"
75 rpmusage.pl [options] [targets]
76 .PP
77 options:
78 .PP
79 .Vb 3
80 \& \-help brief help message
81 \& \-man full documentation
82 \& \-V, \-\-version print version
83 \&
84 \& \-verbose verbose
85 \& \-fullalgo force full algorythm
86 \& \-use\-cache use cache to avoid rpm query
87 \& \-clear\-cache remove cache file
88 \&
89 \& \-exclude pac exclude pac from results
90 \& \-install\-time +/\-d apply on packages which are installed before (after) d days
91 \& \-access\-time d apply on packages which are not been accessed for d days (slow)
92 .Ve
93 .PP
94 targets:
95 .PP
96 .Vb 10
97 \& \-package pac search last access on pac package
98 \& \-all apply on all packages (this is the default)
99 \& \-guess\-perl apply on perl packages
100 \& \-guess\-python apply on python packages
101 \& \-guess\-pike apply on pike packages
102 \& \-guess\-ruby apply on ruby packages
103 \& \-guess\-common apply on common packages
104 \& \-guess\-data apply on data packages
105 \& \-guess\-doc apply on documentation packages
106 \& \-guess\-dev apply on development packages
107 \& \-guess\-lib apply on library packages
108 \& \-guess\-all apply all \-guess\-* options (perl, python ...)
109 \& \-guess\-custom regex apply the given regex to filter to package\*(Aqs names to filter the output
110 .Ve
111 .SH "REQUIRED ARGUMENTS"
112 .IX Header "REQUIRED ARGUMENTS"
113 it can be used without any argument, and then will apply on all packages
114 .SH OPTIONS
115 .IX Header "OPTIONS"
116 .IP \fB\-help\fR 8
117 .IX Item "-help"
118 Print a brief help message and exits.
119 .IP \fB\-man\fR 8
120 .IX Item "-man"
121 Print the manual page and exits.
122 .IP \fB\-version\fR 8
123 .IX Item "-version"
124 Print the program release and exit.
125 .IP \fB\-verbose\fR 8
126 .IX Item "-verbose"
127 The program works and print debugging messages.
128 .IP \fB\-use\-cache\fR 8
129 .IX Item "-use-cache"
130 the rpm query may be long (10 to 30 s). If you will run an rpmorphan tool
131 several time, this option will allow to gain a lot of time :
132 it save the rpm query on a file cache (first call), then
133 use this cache instead quering rpm (others calls).
134 .IP \fB\-clear\-cache\fR 8
135 .IX Item "-clear-cache"
136 to remove cache file. Can be used with \-use\-cache to write
137 a new cache.
138 .IP \fB\-exclude\fR 8
139 .IX Item "-exclude"
140 this option will specify the packages to exclude from the output.
141 Can be used as \*(Aq\-\-exclude pac1 \-\-exclude pac2\*(Aq
142 or \*(Aq\-\-exclude "pac1, pac2"\*(Aq
143 .IP \fB\-install\-time\fR 8
144 .IX Item "-install-time"
145 install\-time is a filter on the period from the package installation date to now (in days).
146 if set positive, it only allow packages installed before x days.
147 if set negative, it only allow packages installed since x days.
148 .IP \fB\-access\-time\fR 8
149 .IX Item "-access-time"
150 access\-time is designed to filter packages which have not been used since x days.
151 .Sp
152 be careful : this option will slow the program
153 .IP \fB\-fullalgo\fR 8
154 .IX Item "-fullalgo"
155 for a small list of packages, rpmusage use a different quicker methode : rpm \-e \-\-test
156 .Sp
157 this option can be used to force the use of the full algo
158 .IP \fB\-package\fR 8
159 .IX Item "-package"
160 search if the given package(s) is(are) orphaned.
161 Can be used as \*(Aq\-\-package pac1 \-\-package pac2\*(Aq
162 or \*(Aq\-\-package "pac1, pac2"\*(Aq
163 .IP \fB\-all\fR 8
164 .IX Item "-all"
165 apply on all installed packages. The output should be interpreted.
166 For example lilo or grub are orphaned packages, but are necessary
167 to boot ...
168 .Sp
169 the "\-install\-time" and "\-access\-time" options may be useful to filter the list
170 .IP \fB\-guess\-perl\fR 8
171 .IX Item "-guess-perl"
172 This option tries to find perl modules. It tries to match "^perl"
173 .IP \fB\-guess\-python\fR 8
174 .IX Item "-guess-python"
175 This option tries to find python modules. It tries to match "^python"
176 .IP \fB\-guess\-pike\fR 8
177 .IX Item "-guess-pike"
178 This option tries to find pike modules. It tries to match "^pike"
179 .IP \fB\-guess\-ruby\fR 8
180 .IX Item "-guess-ruby"
181 This option tries to find ruby modules. It tries to match "^ruby"
182 .IP \fB\-guess\-common\fR 8
183 .IX Item "-guess-common"
184 This option tries to find common packages. It tries to match "\-common$"
185 .IP \fB\-guess\-data\fR 8
186 .IX Item "-guess-data"
187 This option tries to find data packages. It tries to match "\-data$"
188 .IP \fB\-guess\-doc\fR 8
189 .IX Item "-guess-doc"
190 This option tries to find documentation packages. It tries to match "\-doc$"
191 .IP \fB\-guess\-data\fR 8
192 .IX Item "-guess-data"
193 This option tries to find data packages. It tries to match "\-data$"
194 .IP \fB\-guess\-dev\fR 8
195 .IX Item "-guess-dev"
196 This option tries to find development packages. It tries to match "\-devel$"
197 .IP \fB\-guess\-lib\fR 8
198 .IX Item "-guess-lib"
199 This option tries to find library packages. It tries to match "^lib"
200 .IP \fB\-guess\-all\fR 8
201 .IX Item "-guess-all"
202 This is a short to tell : Try all of the above (perl, python ...)
203 .IP \fB\-guess\-custom\fR 8
204 .IX Item "-guess-custom"
205 this will allow you to specify your own filter. for exemple "^wh"
206 will match whois, whatsnewfm ...
207 .SH USAGE
208 .IX Header "USAGE"
209 display all packages in access date order
210 .PP
211 rpmusage.pl \-\-all | sort \-k 2 \-n
212 .PP
213 only ask for perl packages
214 .PP
215 rpmusage.pl \-\-guess\-perl | sort \-k 2 \-n
216 .PP
217 to read the output :
218 "python\-pexpect 97 on /usr/share/doc/python\-pexpect"
219 means the package was last used 97 days ago and the more recently used file was the
220 /usr/share/doc/python\-pexpect file
221 .SH FILES
222 .IX Header "FILES"
223 /tmp/rpmorphan.cache : cache file to store rpm query. The cache
224 file is common to all rpmorphan tools
225 .SH DEPENDENCIES
226 .IX Header "DEPENDENCIES"
227 rpmusage uses only standard perl module.
228 .PP
229 but it needs the rpm command tool.
230 .SH "BUGS AND LIMITATIONS"
231 .IX Header "BUGS AND LIMITATIONS"
232 the software can only work with one version of each software :
233 we only treat the first version seen
234 .SH CONFIGURATION
235 .IX Header "CONFIGURATION"
236 the program can read rcfile if some exists.
237 it will load in order
238 .PP
239 /etc/rpmorphanrc
240 .PP
241 ~/.rpmorphanrc
242 .PP
243 \&.rpmorphanrc
244 .PP
245 In this file,
246 .PP
247 # are comments,
248 .PP
249 and parameters are stored in the following format :
250 parameter = value
251 .PP
252 example :
253 .PP
254 all = 1
255 .PP
256 curses = 1
257 .SH INCOMPATIBILITIES
258 .IX Header "INCOMPATIBILITIES"
259 not known
260 .SH DIAGNOSTICS
261 .IX Header "DIAGNOSTICS"
262 to be written
263 .SH NOTES
264 .IX Header "NOTES"
265 this program should be used as root superuser, because it needs to access
266 (in read mode) to all files
267 .SH "SEE ALSO"
268 .IX Header "SEE ALSO"
269 \fIrpm\fR\|(1) for rpm call
270 .PP
271 \fIrpmorphan\fR\|(1)
272 .PP
273 \fIrpmdep\fR\|(1)
274 .PP
275 \fIrpmduplicates\fR\|(1)
276 .PP
277 \fIrpmextra\fR\|(1)
278 .SH "EXIT STATUS"
279 .IX Header "EXIT STATUS"
280 should be allways 0
281 .SH "LICENSE AND COPYRIGHT"
282 .IX Header "LICENSE AND COPYRIGHT"
283 Copyright (C) 2006 by Eric Gerbier
284 This program is free software; you can redistribute it and/or modify
285 it under the terms of the GNU General Public License as published by
286 the Free Software Foundation; either version 2 of the License, or
287 (at your option) any later version.
288 .SH AUTHOR
289 .IX Header "AUTHOR"
290 Eric Gerbier
291 .PP
292 you can report any bug or suggest to [email protected]