POSTINSTALL(8)						    BSD System Manager's Manual 					    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 sys-
     tem 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 disabled by default.  The latter are items that are dangerous for some reason, 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 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 speci-
			 fied 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 distribution 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 distribu-
					tion of NetBSD.  Each set file is a compressed archive containing reference files, which will be extracted
					to the temproot directory.  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 manual intervention will be required.

		    Conflicts between existing files in the target file system and new files from the NetBSD distribution are resolved by replac-
		    ing 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 disabled 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 ALSO

     etcupdate(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