urpm-tools/docs/urpm-package-cleanup.1

105 lines
3.1 KiB
Groff
Raw Normal View History

.\" 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\-\-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 while leaving old kernel-devel packages installed:"
\fBurpm-package-cleanup --oldkernels --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
urpm-package-cleanup --oldkernels also reads the options from /etc/urpmi/kernels.cfg:
.IP \fBremove_old_kernels (yes|no)\fP
If remove_old_kernels is set to "no", urpm-package-cleanup --oldkernels has no effect.
.IP \fBkernels_to_keep\fP
How many kernels to keep.
.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