.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` 
.    ds C' 
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "ADEQUATE 1"
.TH ADEQUATE 1 "2015-07-15" "adequate 0.15.2" ""
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
adequate \- Debian package quality testing tool
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBadequate\fR [\fIoptions\fR] \fIpackage-name\fR..." 1
.IX Item "adequate [options] package-name..."
.PD 0
.IP "\fBadequate\fR [\fIoptions\fR] \-\-all" 1
.IX Item "adequate [options] --all"
.IP "\fBadequate\fR [\fIoptions\fR] \-\-apt\-preinst" 1
.IX Item "adequate [options] --apt-preinst"
.IP "\fBadequate\fR [\fIoptions\fR] \-\-pending" 1
.IX Item "adequate [options] --pending"
.IP "\fBadequate\fR \-\-help" 1
.IX Item "adequate --help"
.PD
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBadequate\fR checks packages installed on the system and reports bugs and policy
violations.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-all\fR" 4
.IX Item "--all"
Run checks against all the installed packages.
.IP "\fB\-\-tags\fR \fItag1\fR[,\fItag2\fR...]" 4
.IX Item "--tags tag1[,tag2...]"
Emit only these tags.
.IP "\fB\-\-tags\fR \-\fItag1\fR[,\fItag2\fR...]" 4
.IX Item "--tags -tag1[,tag2...]"
Don't emit these tags.
.IP "\fB\-\-debconf\fR" 4
.IX Item "--debconf"
Report issues via \fB\f(CB\*(C`debconf\*(C'\fB\fR(7).
.IP "\fB\-\-root\fR \fIdirectory\fR" 4
.IX Item "--root directory"
Change the root directory (using \fB\f(CB\*(C`chroot\*(C'\fB\fR(2)).
.IP "\fB\-\-user\fR \fIuser\fR[:\fIgroup\fR]" 4
.IX Item "--user user[:group]"
Switch user and group before running any checks.
This is most useful together with \fB\-\-root\fR or \fB\-\-pending\fR, which require
superuser privileges.
.IP "\fB\-\-apt\-preinst\fR" 4
.IX Item "--apt-preinst"
Read \s-1APT\s0 configuration and \fI.deb\fR filenames from stdin, and append packages
names to \fI/var/lib/adequate/pending\fR for later processing (see \fB\-\-pending\fR).
.Sp
This option is used internally by the \s-1APT\s0 hook.
The hook is disabled by default; please edit \fI/etc/apt/apt.conf.d/20adequate\fR to enable it.
.IP "\fB\-\-pending\fR" 4
.IX Item "--pending"
Run checks against packages listed in \fI/var/lib/adequate/pending\fR,
then empty the file.
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Display help and exit.
.SH "TAGS"
.IX Header "TAGS"
.IP "\fB\f(CB\*(C`bin\-or\-sbin\-binary\-requires\-usr\-lib\-library\*(C'\fB\fR" 4
.IX Item "bin-or-sbin-binary-requires-usr-lib-library"
This package ships a binary in /bin or /sbin that requires a
library in /usr/lib.  This will make impossible to use this binary before /usr
is mounted.
.IP "\fB\f(CB\*(C`broken\-binfmt\-detector\*(C'\fB\fR" 4
.IX Item "broken-binfmt-detector"
The detector registered with \fB\f(CB\*(C`update\-binfmts\*(C'\fB\fR(8) does not exist.
.IP "\fB\f(CB\*(C`broken\-binfmt\-interpreter\*(C'\fB\fR" 4
.IX Item "broken-binfmt-interpreter"
The interpreter registered with \fB\f(CB\*(C`update\-binfmts\*(C'\fB\fR(8) does not exist.
.IP "\fB\f(CB\*(C`broken\-symlink\*(C'\fB\fR" 4
.IX Item "broken-symlink"
This package ships a symlink which points to a non-existent file.
.IP "\fB\f(CB\*(C`incompatible\-licenses\*(C'\fB\fR" 4
.IX Item "incompatible-licenses"
Licenses of the libraries the binary is linked to are
incompatible.
.IP "\fB\f(CB\*(C`ldd\-failure\*(C'\fB\fR" 4
.IX Item "ldd-failure"
Running "\f(CW\*(C`ldd \-r\*(C'\fR" on the file failed unexpectedly.  This is most
like a bug in libc or adequate itself.
.Sp
References: <\fIhttps://bugs.debian.org/710521\fR>.
.IP "\fB\f(CB\*(C`library\-not\-found\*(C'\fB\fR" 4
.IX Item "library-not-found"
The binary is linked with a library, which cannot be found.
.Sp
References: Debian Policy §8.6.
.IP "\fB\f(CB\*(C`missing\-alternative\*(C'\fB\fR" 4
.IX Item "missing-alternative"
This package is a provider of the virtual package
\&\f(CW\*(C`x\-terminal\-emulator\*(C'\fR, but it doesn't register itself as an alternative for
\&\f(CW\*(C`/usr/bin/x\-terminal\-emulator\*(C'\fR; or it is a provider of the virtual package
\&\f(CW\*(C`x\-window\-manager\*(C'\fR, but it doesn't register itself as an alternative for
\&\f(CW\*(C`/usr/bin/x\-window\-manager\*(C'\fR.
.Sp
References: Debian Policy §11.8.3, Debian Policy §11.8.4.
.IP "\fB\f(CB\*(C`missing\-copyright\-file\*(C'\fB\fR" 4
.IX Item "missing-copyright-file"
The copyright file for this package is missing.  This often
happens if /usr/share/doc/\fIpkg\fR/ was a real directory in a previous version of
the package, but it's now a symlink; dpkg never replaces directory with a
symlink to a directory.
.Sp
References: Debian Policy §12.5, §6.6.
.IP "\fB\f(CB\*(C`missing\-pkgconfig\-dependency\*(C'\fB\fR" 4
.IX Item "missing-pkgconfig-dependency"
Dependency of a pkg-config (.pc) file shipped by this package
couldn't be satisfied.
.Sp
References: Debian Policy §8.4.
.IP "\fB\f(CB\*(C`missing\-symbol\-version\-information\*(C'\fB\fR" 4
.IX Item "missing-symbol-version-information"
The binary uses versioned symbols, but the library provides only
unversioned ones.
.IP "\fB\f(CB\*(C`obsolete\-conffile\*(C'\fB\fR" 4
.IX Item "obsolete-conffile"
The current version of this package no longer ships a conffile
(that used to be included in the past).  However, the conffile hasn't been
removed on upgrade.
.Sp
References: <\fIhttps://wiki.debian.org/DpkgConffileHandling\fR>, \fB\f(CB\*(C`dpkg\-maintscript\-helper\*(C'\fB\fR(1).
.IP "\fB\f(CB\*(C`program\-name\-collision\*(C'\fB\fR" 4
.IX Item "program-name-collision"
This package ships a program with the same name as another
program.
.Sp
References: Debian Policy §10.1.
.IP "\fB\f(CB\*(C`py\-file\-not\-bytecompiled\*(C'\fB\fR" 4
.IX Item "py-file-not-bytecompiled"
This package ships Python modules that are not byte-compiled.
.Sp
References: Python Policy §2.6.
.IP "\fB\f(CB\*(C`pyshared\-file\-not\-bytecompiled\*(C'\fB\fR" 4
.IX Item "pyshared-file-not-bytecompiled"
This package ships Python modules in /usr/share/pyshared that are
not byte-compiled.
.Sp
References: Python Policy §2.6, §1.5.
.IP "\fB\f(CB\*(C`symbol\-size\-mismatch\*(C'\fB\fR" 4
.IX Item "symbol-size-mismatch"
The symbol has changed size since the package was built.  It might
be an indication that the library broke \s-1ABI.\s0  If \s-1ABI\s0 wasn't broken, and the
library bumped shlibs (or symbols), the package should be binNMUed.
.IP "\fB\f(CB\*(C`undefined\-symbol\*(C'\fB\fR" 4
.IX Item "undefined-symbol"
The symbol has not been found in the libraries linked with the
binary.  Either the binary either needs to be linked with an additional shared
library, or the dependency on the shared library package that provides this
symbol is too weak.
.Sp
References: Debian Policy §3.5, §8.6, §10.2.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.IP "\fB\f(CB\*(C`adequate coreutils\*(C'\fB\fR" 4
.IX Item "adequate coreutils"
Check the \fBcoreutils\fR package.
.IP "\fB\f(CB\*(C`adequate \-\-tags obsolete\-conffile \-\-all\*(C'\fB\fR" 4
.IX Item "adequate --tags obsolete-conffile --all"
Check all the packages for obsolete conffiles.
.IP "\fB\f(CB\*(C`adequate \-\-tags \-py\-file\-not\-bytecompiled,pyshared\-file\-not\-bytecompiled \-\-all\*(C'\fB\fR" 4
.IX Item "adequate --tags -py-file-not-bytecompiled,pyshared-file-not-bytecompiled --all"
Check all the packages, ignoring Python bytecompilation issues.
.SH "REPORTING BUGS"
.IX Header "REPORTING BUGS"
If you report a bug that was found by adequate, please use the following usertags:
.IP "" 4
.RS 4
.PD 0
.IP "User: debian\-qa@lists.debian.org" 4
.IX Item "User: debian-qa@lists.debian.org"
.IP "Usertags: adequate \fItag-name\fR" 4
.IX Item "Usertags: adequate tag-name"
.RE
.RS 4
.RE
.PD
.PP
Please keep in mind that adequate is not perfect; therefore false positives are
possible. Don't report the bug unless you understand the underlying problem.
When in doubt, please ask at \fIdebian\-qa@lists.debian.org\fR first.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Debian Policy:
\&\fI/usr/share/doc/debian\-policy/policy.txt.gz\fR
or <\fIhttps://www.debian.org/doc/debian\-policy/\fR>
.PP
Python Policy:
\&\fI/usr/share/doc/python/python\-policy.txt.gz\fR
or <\fIhttps://www.debian.org/doc/packaging\-manuals/python\-policy/\fR>
.PP
\&\fB\f(CB\*(C`lintian\*(C'\fB\fR(1), \fB\f(CB\*(C`piuparts\*(C'\fB\fR(1)