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  | sort -k 2 -n
159
160       only ask for perl packages
161
162       rpmusage.pl --guess-perl | sort -k 2 -n
163

FILES

165       /tmp/rpmorphan.cache : cache file to store rpm query. The cache file is
166       common to all rpmorphan tools
167

DEPENDENCIES

169       rpmusage uses only standard perl module.
170
171       but it needs the rpm command tool.
172

BUGS AND LIMITATIONS

174       the software can only work with one version of each software : we only
175       treat the first version seen
176

CONFIGURATION

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

INCOMPATIBILITIES

199       not known
200

DIAGNOSTICS

202       to be written
203

NOTES

205       this program should be used as root superuser, because it needs to
206       access (in read mode) to all files
207

SEE ALSO

209       rpm(1) for rpm call
210
211       rpmorphan(1) rpmdep(1) rpmduplicates(1)
212

EXIT STATUS

214       should be allways 0
215
217       Copyright (C) 2006 by Eric Gerbier This program is free software; you
218       can redistribute it and/or modify it under the terms of the GNU General
219       Public License as published by the Free Software Foundation; either
220       version 2 of the License, or (at your option) any later version.
221

AUTHOR

223       Eric Gerbier
224
225       you can report any bug or suggest to gerbier@users.sourceforge.net
226
227
228
229perl v5.10.0                      2010-01-15                       RPMUSAGE(1)
Impressum