instcheck.1

NAME

installer - create directories, create/copy files, named pipes and devices

instcheck - check installed files for existence, owner, group, permissions

SYNOPSYS

/usr/libexec/indimail/installer [-cfum] dest

/usr/libexec/indimail/instcheck [-cfm] [package]

DESCRIPTION

installer program create directories, install files from source directories, create files with zeros, symbolic links, named pipes and devices files in directory dest of your choice. installer takes input from descriptor 0. It expects the data on descriptor 0 to be of the following form.

type:owner:group:mode:target:source:

Here type is either of d, l, f, z, p, c as following

d
= directory

l
= symbolic link

f
= file

z
= file with fixed number of zeroes

p
= named pipe

c
= device file

owner is the owner of the target (user name or numeric user ID), group is the group membership of the target (group name or numeric group ID) of the target, mode is the file mode bits of the target. target is a relative or absolute path of the filename in dest. source is a relative or absolute path of the source filename. target can be a directory, file, symbolic link, fifo or a device The lines expected by installer has to be any of the following forms given below. Invalid data is silently ignored.

 Directory
 d:owner:group:mode:target_dir::

 Soft link
 l:owner:group:mode:target_link::source:

 File
 f:owner:group:mode:target_file:source:

 File with zeros
 z:owner:group:mode:target_file:size:

 Named Pipes
 p:owner:group:mode:target_fifo::

 Device files
 c:owner:group:mode:target_device:devnum:

installer silently ignores comments, blank lines or any line starting with any white space character.

installer is not meant to be executed by end users. It is meant to be used to be used in Makefile and build scripts to install binaries, links, named pipes, devices and files with zeros to a destination directory.

instcheck checks the existence of files and ower, group, mode of installed files. It needs the same input as instcheck on descriptor 0. instcheck is just a frontend to installer, except that it uses input file started in /etc/indimail/perms.d/package. A special file named INPUT is present in the director under package/INPUT. Here package refers to binary packages which use installer to do the installation - daemontools, ucspi-tcp, indimail-mta, tinydnssec. e.g., the following command will check and fix permissions for each and every file that is part of the daemontools package.

  instcheck -cf daemontools < /etc/indimail/perms.d/daemontools/INPUT

An alternate of using instcheck is to rename it to instcheck.package. e.g., if instcheck is renamed as instcheck.indimail-mta, running the command instcheck.indimail-mta will check and fix all file part of the indimail-mta package.

OPTIONS

-c
This turns on check mode where installer checks the existence, owner, group and permission mode of the target.

-f
This option turns on check mode as well as fix mode where owner, group or mode of the target is fixed.

-u
Uninstall target from dest.

-m
Continue if there is an error with reading source file. This option can be used when type is f. For other file types, this option has no effect.

SEE ALSO

install(1)