urpm-tools/docs/urpm-package-cleanup.1
2012-09-05 15:45:44 +04:00

100 lines
3 KiB
Groff

.\" package-cleanup
.TH "urpm-package-cleanup" "1" "21 December 2011" "Denis Silakov" ""
.SH "NAME"
urpm-package-cleanup - find and fix rpmdb problems
.SH "SYNOPSIS"
\fBurpm-package-cleanup\fP [options]
.SH "DESCRIPTION"
.PP
\fBurpm-package-cleanup\fP is a program for cleaning up the locally-installed RPMs.
.PP
.SH "GENERAL OPTIONS"
.IP "\fB\-h, \-\-help\fP"
Help; display a help message and then quit\&.
.IP "\fB\-v, \-\-version\fP"
Report program version and exit.
.IP "\fB\-\-leaves\fP"
List leaf nodes in the local RPM database. Leaf nodes are RPMs that
are not relied upon by any other RPM.
.IP "\fB\-\-orphans\fP"
List installed packages which are not available from currently configured
repositories. This is identical to "urpmq --not-available".
.IP "\fB\-\-oldkernels\fP"
Remove old kernel and kernel-devel packages.
.IP "\fB\-\-problems\fP"
List dependency problems in the local RPM database.
.IP "\fB\-\-dupes\fP"
Scan for duplicates in the local RPM database.
.PP
.SH "LEAVES OPTIONS"
.IP "\fB\-\-all\fP"
When listing leaf nodes also list leaf nodes that are
not libraries.
.IP "\fB\-\-leaf\-regex\fP"
A package name that matches this regular expression will be considered a leaf.
.IP "\fB\-\-exclude\-devel\fP"
When listing leaf nodes do not list development packages.
.IP "\fB\-\-exclude\-bin\fP"
When listing leaf nodes do not list packages with files in bin directories.
.PP
.SH "OLDKERNELS OPTIONS"
.IP "\fB\-\-count <COUNT>\fP"
Number of kernel packages to keep on the system (default 2)
.IP "\fB\-\-keepdevel\fP"
Do not remove kernel-devel packages when removing kernels
.PP
.SH "DUPLICATE PACKAGE OPTIONS"
.IP "\fB\-\-cleandupes\fP"
Scan for duplicates in the local RPM database and clean out the
older versions.
.IP "\fB\-\-noscripts\fP"
Disable rpm scriptlets from running when cleaning duplicates
.PP
.SH "DEPENDENCY PROBLEMS OPTIONS"
.IP "\fB\-\-suggests\fP"
List missing suggestions of installed packages
.SH "EXAMPLES"
.IP "List all dependency problems:"
\fBurpm-package-cleanup --problems\fP
.IP "List all packages that are not in any configured repository:"
\fBurpm-package-cleanup --orphans\fP
.IP "Remove old kernels keeping 3 and leaving old kernel-devel packages installed:"
\fBurpm-package-cleanup --oldkernels --count=3 --keepdevel\fP
.PP
.IP "List all leaf packages with no files in a bin directory whose name begins with either 'perl' or 'python':"
\fBurpm-package-cleanup --leaves --exclude-bin --leaf-regex="^(perl)|(python)"\fP
.PP
.SH "FILES"
For some actions urpm-package-cleanup invokes urpmi and relies on its
configuration file:
.PP
.nf
/etc/urpmi/urpmi.cfg
.fi
.PP
.SH "EXIT CODES"
.IP \fB0\fP
Completed successfully
.IP \fB1\fP
Script execution error (wrong option, insufficient permissions, etc.)
.IP \fB2\fP
Unsatisfied dependencies detected
.IP \fB3\fP
Unsatisfied soft dependencies detected
.IP \fB100\fP
Illegal option value
.PP
.SH "SEE ALSO"
.nf
.I urpmi.cfg (1)
.fi
.PP
.SH "AUTHORS"
.nf
See the Authors file included with this program.
.fi