rpmlint/rpmlint.1

86 lines
2.7 KiB
Groff

.TH RPMLINT "1" "January 2009" "rpmlint" "User Commands"
.SH NAME
rpmlint \- check common problems in rpm packages
.SH SYNOPSIS
\fBrpmlint\fR [\fIOPTION\fR]... [\fIFILE\fR|\fIPACKAGE\fR]...
.SH DESCRIPTION
\fBrpmlint\fR is a tool for checking common errors in rpm packages.
It can be used to test individual packages and spec files before
uploading or to check an entire distribution. By default all
applicable checks are processed but specific checks can be performed
by using command line parameters.
\fIFILE\fR can be a rpm package file, a spec file, or a directory. In
case of a directory, it is recursively searched for rpm and spec files
to check. \fIPACKAGE\fR is the name of an installed package or a
.BR glob (7)
pattern to match installed packages, unless a file by that name exists.
.TP
\fB\-i\fR, \fB\-\-info\fR
Display explanations for reported messages.
.TP
\fB-I\fR \fImessageid\fR[,\fImessageid\fR...]
Display explanations for the specified message identifiers and exit.
Multiple identifiers can be specified by separating them with commas.
.TP
\fB\-c\fR, \fB\-\-check\fR=\fIcheck\fR
Run only the specified check. This option may be given multiple times
to specify multiple checks to run.
.TP
\fB\-a\fR, \fB\-\-all\fR
Check all installed packages.
.TP
\fB\-C\fR, \fB\-\-checkdir\fR=\fIdir\fR
Insert \fIdir\fR to the front of the list of paths to load checks
(and other Python modules) from.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display summary of command line options and exit.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Operate in verbose mode.
.TP
\fB\-E\fR, \fB\-\-extractdir\fR=\fIdir\fR
Base directory for extracted temporary files, default is what Python's
tempfile.gettempdir() returns.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information and exit.
.TP
\fB\-n\fR, \fB\-\-noexception\fR
Ignore output filters.
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIconffile\fR
Load user configuration from the specified file, default is ~/.rpmlintrc
.SH CAVEATS
rpmlint does not contain a full featured spec file parser; use eg.
"rpm \-q \-\-specfile /path/to/foo.spec" to check spec file syntax or
try building the package.
.SH FILES
.TP
\fB/usr/share/rpmlint/config\fR
Built-in configuration.
.TP
\fB/etc/rpmlint/*config\fR
System wide configuration.
.TP
\fB~/.rpmlintrc\fR
User configuration.
.SH EXIT CODES
.IP 0
No errors.
.IP 1
Unspecified error.
.IP 2
Interrupted.
.IP 64
One or more error message printed.
.IP 66
Badness threshold exceeded.
.SH AUTHOR
Originally written by Frédéric Lepied, see the file AUTHORS for (probably
incomplete) list of additional contributors.
.SH COPYRIGHT
This program is licensed under the GNU General Public License, see the
file COPYING included in the distribution archive.