INSTALL(1)                 OpenBSD Reference Manual                 INSTALL(1)

NAME
     install - install binaries

SYNOPSIS
     install [-bCcpSs] [-B suffix] [-f flags] [-g group] [-m mode] [-o owner]
             file1 file2
     install [-bCcpSs] [-B suffix] [-f flags] [-g group] [-m mode] [-o owner]
             file1 ...  fileN directory
     install -d [-g group] [-m mode] [-o owner] directory ...

DESCRIPTION
     The file(s) are moved (or copied if the -c option is specified) to the
     target file or directory.  If the destination is a directory, then the
     file is moved into directory with its original filename.  If the target
     file already exists, it is either renamed to file.old if the -b option is
     given or overwritten if permissions allow, An alternate backup suffix may
     be specified via the -B option's argument.

     The options are as follows:

     -b      Backup any existing files before overwriting them by renaming
             them to file.old. See -B for specifying a different backup suf-
             fix.

     -B suffix
             Use suffix as the backup suffix if -b is given.

     -C      Copy the file.  If the target file already exists and the files
             are the same, then don't change the modification time of the tar-
             get.

     -c      Copy the file.  This is actually the default.  The -c option is
             only included for backwards compatibility.

     -d      Create directories.  Missing parent directories are created as
             required.

     -f      Specify the target's file flags.  (See chflags(1) for a list of
             possible flags and their meanings.)

     -g      Specify a group.  A numeric GID is allowed.

     -m      Specify an alternate mode.  The default mode is set to rwxr-xr-x
             (0755).  The specified mode may be either an octal or symbolic
             value; see chmod(1) for a description of possible mode values.

     -o      Specify an owner.  A numeric UID is allowed.

     -p      Preserve the modification time.  Copy the file, as if the -C
             (compare and copy) option is specified, except if the target file
             doesn't already exist or is different, then preserve the modifi-
             cation time of the file.

     -S      Safe copy.  Normally, install unlinks an existing target before
             installing the new file.  With the -S flag a temporary file is
             used and then renamed to be the target.  The reason this is safer
             is that if the copy or rename fails, the existing target is left
             untouched.

     -s      install exec's the command /usr/bin/strip to strip binaries so
             that install can be portable over a large number of systems and
             binary types.  If the environment variable STRIP is set, it is
             used instead.

     By default, install preserves all file flags, with the exception of the
     ``nodump'' flag.

     The install utility attempts to prevent moving a file onto itself.

     Installing /dev/null creates an empty file.

     Upon successful completion a value of 0 is returned.  Otherwise, a value
     >0 is returned.

FILES
     INS@XXXXXX  If either -S option is specified, or the -C or -p option is
                 used in conjuction with the -s option, temporary files named
                 INS@XXXXXX, where XXXXXX is decided by mkstemp(3), are creat-
                 ed in the target directory.

ENVIRONMENT
     STRIP  For an alternate strip(1) program to run.  Default is
            /usr/bin/strip.

SEE ALSO
     chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), chown(8)

HISTORY
     The install utility appeared in 4.2BSD.

CAVEATS
     The -C, -p, and -S flags are non-standard and should not relied upon for
     portability.

     Temporary files may be left in the target directory if install exits ab-
     normally.

OpenBSD 3.0                      June 6, 1993                                2
