1RPMUSAGE(1)           User Contributed Perl Documentation          RPMUSAGE(1)
2
3
4

NAME

6       rpmusage - display rpm packages last use
7

DESCRIPTION

9       rpmusage will display for each package, the last date it was used (in
10       days). It can be used to find unused packages. It use the atime field
11       of all package's files to do this job.  Note : as it scan all files
12       inodes, the run may be long ...
13

SYNOPSIS

15       rpmusage.pl  [options] [targets]
16
17       options:
18
19          -help                brief help message
20          -man                 full documentation
21          -V, --version        print version
22
23          -verbose             verbose
24          -fullalgo            force full algorythm
25          -use-cache           use cache to avoid rpm query
26          -clear-cache         remove cache file
27
28          -exclude pac         exclude pac from results
29          -install-time +/-d   apply on packages which are installed before (after) d days
30          -access-time d       apply on packages which are not been accessed for d days (slow)
31
32       targets:
33
34          -package pac         search last access on pac package
35          -all                 apply on all packages (this is the default)
36          -guess-perl          apply on perl packages
37          -guess-python        apply on python packages
38          -guess-pike          apply on pike packages
39          -guess-ruby          apply on ruby packages
40          -guess-common        apply on common packages
41          -guess-data          apply on data packages
42          -guess-doc           apply on documentation packages
43          -guess-dev           apply on development packages
44          -guess-lib           apply on library packages
45          -guess-all           apply all -guess-* options (perl, python ...)
46          -guess-custom regex  apply the given regex to filter to package's names to filter the output
47

REQUIRED ARGUMENTS

49       it can be used without any argument, and then will apply on all
50       packages
51

OPTIONS

53       -help   Print a brief help message and exits.
54
55       -man    Print the manual page and exits.
56
57       -version
58               Print the program release and exit.
59
60       -verbose
61               The program works and print debugging messages.
62
63       -use-cache
64               the rpm query may be long (10 to 30 s). If you will run an
65               rpmorphan tool several time, this option will allow to gain a
66               lot of time : it save the rpm query on a file cache (first
67               call), then use this cache instead quering rpm (others calls).
68
69       -clear-cache
70               to remove cache file. Can be used with -use-cache to write a
71               new cache.
72
73       -exclude
74               this option will specify the packages to exclude from the
75               output.  Can be used as '--exclude pac1 --exclude pac2' or
76               '--exclude "pac1, pac2"'
77
78       -install-time
79               install-time is a filter on the period from the package
80               installation date to now (in days).  if set positive, it only
81               allow packages installed before x days.  if set negative, it
82               only allow packages installed since x days.
83
84       -access-time
85               access-time is designed to filter packages which have not been
86               used since x days.
87
88               be careful : this option will slow the program
89
90       -fullalgo
91               for a small list of packages, rpmusage use a different quicker
92               methode : rpm -e --test
93
94               this option can be used to force the use of the full algo
95
96       -package
97               search if the given package(s) is(are) orphaned.  Can be used
98               as '--package pac1 --package pac2' or '--package "pac1, pac2"'
99
100       -all    apply on all installed packages. The output should be
101               interpreted.  For example lilo or grub are orphaned packages,
102               but are necessary to boot ...
103
104               the "-install-time" and "-access-time" options may be useful to
105               filter the list
106
107       -guess-perl
108               This option tries to find perl modules. It tries to match
109               "^perl"
110
111       -guess-python
112               This option tries to find python modules. It tries to match
113               "^python"
114
115       -guess-pike
116               This option tries to find pike modules. It tries to match
117               "^pike"
118
119       -guess-ruby
120               This option tries to find ruby modules. It tries to match
121               "^ruby"
122
123       -guess-common
124               This option tries to find common packages. It tries to match
125               "-common$"
126
127       -guess-data
128               This option tries to find data packages. It tries to match
129               "-data$"
130
131       -guess-doc
132               This option tries to find documentation packages. It tries to
133               match "-doc$"
134
135       -guess-data
136               This option tries to find data packages. It tries to match
137               "-data$"
138
139       -guess-dev
140               This option tries to find development packages. It tries to
141               match "-devel$"
142
143       -guess-lib
144               This option tries to find library packages. It tries to match
145               "^lib"
146
147       -guess-all
148               This is a short to tell : Try all of the above (perl, python
149               ...)
150
151       -guess-custom
152               this will allow you to specify your own filter. for exemple
153               "^wh" will match whois, whatsnewfm ...
154

USAGE

156       display all packages in access date order
157
158       rpmusage.pl --all | sort -k 2 -n
159
160       only ask for perl packages
161
162       rpmusage.pl --guess-perl | sort -k 2 -n
163
164       to read the output : "python-pexpect 97 on
165       /usr/share/doc/python-pexpect" means the package was last used 97 days
166       ago and the more recently used file was the
167       /usr/share/doc/python-pexpect file
168

FILES

170       /tmp/rpmorphan.cache : cache file to store rpm query. The cache file is
171       common to all rpmorphan tools
172

DEPENDENCIES

174       rpmusage uses only standard perl module.
175
176       but it needs the rpm command tool.
177

BUGS AND LIMITATIONS

179       the software can only work with one version of each software : we only
180       treat the first version seen
181

CONFIGURATION

183       the program can read rcfile if some exists.  it will load in order
184
185       /etc/rpmorphanrc
186
187       ~/.rpmorphanrc
188
189       .rpmorphanrc
190
191       In this file,
192
193       # are comments,
194
195       and parameters are stored in the following format : parameter = value
196
197       example :
198
199       all = 1
200
201       curses = 1
202

INCOMPATIBILITIES

204       not known
205

DIAGNOSTICS

207       to be written
208

NOTES

210       this program should be used as root superuser, because it needs to
211       access (in read mode) to all files
212

SEE ALSO

214       rpm(1) for rpm call
215
216       rpmorphan(1)
217
218       rpmdep(1)
219
220       rpmduplicates(1)
221
222       rpmextra(1)
223

EXIT STATUS

225       should be allways 0
226
228       Copyright (C) 2006 by Eric Gerbier This program is free software; you
229       can redistribute it and/or modify it under the terms of the GNU General
230       Public License as published by the Free Software Foundation; either
231       version 2 of the License, or (at your option) any later version.
232

AUTHOR

234       Eric Gerbier
235
236       you can report any bug or suggest to gerbier@users.sourceforge.net
237
238
239
240perl v5.24.1                      2017-07-14                       RPMUSAGE(1)
Impressum