.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 "PACCHECK 1"
.TH PACCHECK 1 2024-04-16 pacutils paccheck
.\" 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
paccheck \- check installed packages
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\& paccheck [options] [<package>]...
\& paccheck (\-\-help|\-\-version)
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Check installed packages.  Additional packages may be specified on \fIstdin\fR.
If no package are provided, all installed packages will be checked.  By default
only package dependencies and basic file information will checked.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-\-config\fR=\fIpath\fR 4
.IX Item "--config=path"
Set an alternate configuration file path.
.IP \fB\-\-dbpath\fR=\fIpath\fR 4
.IX Item "--dbpath=path"
Set an alternate database path.
.IP \fB\-\-root\fR=\fIpath\fR 4
.IX Item "--root=path"
Set an alternate installation root.
.IP \fB\-\-sysroot\fR=\fIpath\fR 4
.IX Item "--sysroot=path"
Set an alternate system root.  See \fBpacutils\-sysroot\fR\|(7).
.IP \fB\-\-null\fR[=\fIsep\fR] 4
.IX Item "--null[=sep]"
Set an alternate separator for values parsed from \fIstdin\fR.  By default
a newline \f(CW\*(C`\en\*(C'\fR is used as the separator.  If \fB\-\-null\fR is used without
specifying \fIsep\fR \f(CW\*(C`NUL\*(C'\fR will be used.
.IP \fB\-\-list\-broken\fR 4
.IX Item "--list-broken"
Only print the names of packages that fail the selected checks.
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
Only display messages if a problem is found.
.IP \fB\-\-recursive\fR 4
.IX Item "--recursive"
Recursively perform checks on packages' dependencies as well.
.IP \fB\-\-depends\fR 4
.IX Item "--depends"
Check that all package dependencies are satisfied.
.IP \fB\-\-opt\-depends\fR 4
.IX Item "--opt-depends"
Check that all package optional dependencies are satisfied.
.IP \fB\-\-files\fR 4
.IX Item "--files"
Check package files against the local database.
.IP \fB\-\-file\-properties\fR 4
.IX Item "--file-properties"
Check package files against MTREE data.
.IP \fB\-\-md5sum\fR 4
.IX Item "--md5sum"
Check file md5sums against MTREE data.
.IP \fB\-\-sha256sum\fR 4
.IX Item "--sha256sum"
Check file sha256sums against MTREE data.
.IP \fB\-\-require\-mtree\fR 4
.IX Item "--require-mtree"
Treat missing MTREE data as an error for \fB\-\-db\-files\fR and/or
\&\fB\-\-file\-properties\fR.
.IP \fB\-\-db\-files\fR 4
.IX Item "--db-files"
Include database files in \fB\-\-files\fR and \fB\-\-file\-properties\fR checks.
\&\fB\-\-files\fR will test for the existence of \fIdesc\fR, \fIfiles\fR, and \fImtree\fR (with
\&\fB\-\-require\-mtree\fR) files in the package database entry.  \fB\-\-file\-properties\fR
will check \fIinstall\fR and \fIchangelog\fR files in the package database where
applicable.
.IP \fB\-\-backup\fR 4
.IX Item "--backup"
Include backup files in file modification checks.
.IP \fB\-\-noextract\fR 4
.IX Item "--noextract"
Include NoExtract files in file modification checks.
.IP \fB\-\-noupgrade\fR 4
.IX Item "--noupgrade"
Include NoUpgrade files in file modification checks.
.IP \fB\-\-help\fR 4
.IX Item "--help"
Display usage information and exit.
.IP \fB\-\-version\fR 4
.IX Item "--version"
Display version information and exit.
.SH CAVEATS
.IX Header "CAVEATS"
\&\fBpaccheck\fR determines whether or not to read packages from \fIstdin\fR based on
a naive check using \fBisatty\fR\|(3).  If \fBpaccheck\fR is called in an environment,
such as a shell function or script being used in a pipe, where \fIstdin\fR is not
connected to a terminal but does not contain packages to check, \fBpaccheck\fR
should be called with \fIstdin\fR closed.  For POSIX-compatible shells, this can
be done with \f(CW\*(C`<&\-\*(C'\fR.