POSTINSTALL(8) BSD System Manager's Manual POSTINSTALL(8)NAMEpostinstall — check and fix installation after system upgrades
SYNOPSISpostinstall [-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. The items
to check or fix are divided in two groups: enabled by default and dis‐
abled by default. The latter are items that are dangerous for some rea‐
son, for example because they remove files which may be still in use. If
no items are provided, the default checks or fixes are applied. Those
which are disabled by default must be provided explicitly.
Supported options:
-a arch MACHINE_ARCH. Defaults to machine of the host oper‐
ating 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 a binary dis‐
tribution of NetBSD. The files that
are distributed in the “etc.tgz” set
file must be present. The files that
are distributed in the “xetc.tgz” set
file are optional.
-s tgzfile The location of a set file (or “tgz
file”) such as “etc.tgz” or “xetc.tgz”
from a binary distribution of NetBSD.
Each set file is a compressed archive
containing reference files, which will
be extracted to the temproot direc‐
tory. Multiple -s options may be used
to specify multiple set files. The
“etc.tgz” set file must be specified.
The “xetc.tgz” set file is optional.
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, and
in some cases an error will be reported, after which man‐
ual intervention will be required.
Conflicts between existing files in the target file system
and new files from the NetBSD distribution are resolved by
replacing the existing file with the new file; there is no
attempt to merge the files. See etcupdate(8) for an
alternative update method that is able to merge files.
help Display a short help.
list List available items, showing if they are enabled or dis‐
abled by default.
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 ALSOetcupdate(8)HISTORY
The postinstall utility first appeared in NetBSD 1.6.
In NetBSD 4.0, the -s tgzfile option was added.
In NetBSD 5.0, the ability to specify multiple colon-separated files with
a single -s option was deprecated.
BSD October 4, 2008 BSD