POSTINSTALL(8)

NAME
postinstall - check and fix installation after system upgrades

SYNOPSIS
postinstall [-a arch] [-d destdir] [-m machine] [-s {srcdir | tgzdir | tgzfile}] operation [item [...]]

DESCRIPTION
The postinstall utility performs post-installation checks and/or fixes on a system's configuration files. It is especially useful after system upgrades, e.g. after updating from NetBSD 1.6.2 to NetBSD 2.0. If no items are provided, all checks or fixes are applied.

Supported options:

-a arch
    MACHINE_ARCH. Defaults to machine of the host operating system.

-d destdir
    Destination directory to check. Defaults to /.

-m machine
    MACHINE. Defaults to machine of the host operating system.

-s {srcdir | tgzdir | tgzfile}
    The location of the reference files, or the NetBSD source files used to create the reference files. This may be specified in one of three ways:

    -s srcdir
        The top level directory of the NetBSD source tree. By default this is /usr/src.

    -s tgzdir
        A directory in which reference files have been extracted from one or more of the “etc.tgz” or “xetc.tgz” files from a binary distribution of NetBSD.

    -s tgzfile
        The location of one or more set files (or “tgz files”) from a binary distribution of NetBSD. Each set file is a compressed archive containing reference files. More than one set file may be specified, either by using a single -s option with a colon-separated list of tgzfile names, or by using multiple -s options; this is likely to be useful to specify the locations of both the etc.tgz and xetc.tgz set files. Note that file names may not contain embedded colon (‘’): characters, because that would conflict with the use of the colon character to delimit multiple file names with a single argument.

The operation argument may be one of:

check
    Perform post-installation checks on items.

diff [diff(1) options]
    Similar to check, but also show the differences between the files.

fix Apply fixes that check determines need to be applied. Not all items can be automatically fixed by postinstall. etcupdate(8) may help, and in some cases manual intervention is required.

help
    Display a short help.

list
    List available items.

usage
    Same as help.

EXIT STATUS
The postinstall utility exits 0 on success, and 0 if an error occurs or a problem was found.

SEE ALSO
etcupdate(8)

HISTORY
The postinstall utility first appeared in NetBSD 1.6.