Seth Woolley's Man Viewer

install(1) - ginstall, install - copy files and set attributes - man 1 install

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

INSTALL(1)                                                          INSTALL(1)



NAME
       install - copy files and set(7,n,1 builtins) attributes

SYNOPSIS
       install [options] [-s] [--strip] source dest
       install [options] [-s] [--strip] source... directory
       install [options] [-d,--directory] directory...

       Options (shortest form):
       [-b]  [-c]  [-D]  [-g group] [-m mode] [-o owner] [-S SUFFIX] [-V {num-
       bered,existing,simple}] [--help] [--version] [--]

DESCRIPTION
       install copies files while setting their permission modes and, if(3,n)  pos-
       sible, their owner and group.

       In  the  first  of these invocation forms, the source file(1,n) is copied to
       the dest target file.  In the second, each  of  the  source  files  are
       copied  to the destination directory.  In the last, each directory (and
       any missing parent directories) is created.

       install is similar to cp, but allows you to control the  attributes  of
       destination  files.  It is typically used in(1,8) Makefiles to copy programs
       into their destination directories.  It  refuses  to  copy  files  onto
       themselves.


OPTIONS
       -c     Ignored; for compatibility with old Unix versions of install.

       -d, --directory
              Create  each given directory and any missing parent directories,
              setting the owner, group and mode as given on the  command  line
              or  to  the  defaults.   It also gives any parent directories it
              creates those attributes.  (This is different from the SunOS 4.x
              install,  which  gives  directories  that it creates the default
              attributes.)

       -D     Create all leading components of the dest except the last,  then
              copy  source to dest.  This option is useful in(1,8) the first format
              in(1,8) the synopsis, above.  (New in(1,8) fileutils-4.0.)

       -g group, --group=group
              Set the group ownership of installed  files  or  directories  to
              group.   The  default is the process's current group.  group may
              be either a group name or a numeric group id.

       -m mode, --mode=mode
              Set the permissions for the installed file(1,n) or directory to mode,
              which  can  be  either an octal number, or a symbolic mode as in(1,8)
              chmod(1,2), with 0 as the point of departure.  The  default  mode  is
              0755 - read(2,n,1 builtins), write(1,2), and execute for the owner, and read(2,n,1 builtins) and exe-
              cute for group and other.

       -o owner, --owner=owner
              If install has appropriate privileges (is run as root), set(7,n,1 builtins)  the
              ownership  of  installed  files  or  directories  to owner.  The
              default is `root'.  owner may be either a user name or a numeric
              user ID.

       -s, --strip
              Strip the symbol tables from installed binary executables.

GNU BACKUP OPTIONS
       The  GNU  versions  of programs like cp, mv, ln, install and patch will
       make a backup of files about to be overwritten, changed or destroyed if(3,n)
       that  is  desired. That backup files are desired is indicated by the -b
       option. How they should be named(5,8) is specified by  the  -V  option.   In
       case  the  name  of  the  backup  file(1,n) is given by the name of the file(1,n)
       extended by a suffix, this suffix is specified by the -S option.

       -b, --backup
              Make backups of files  that  are  about  to  be  overwritten  or
              removed.

       -S SUFFIX, --suffix=SUFFIX
              Append  SUFFIX  to each backup file(1,n) made.  If this option is not
              specified, the value  of  the  SIMPLE_BACKUP_SUFFIX  environment
              variable  is  used.  And if(3,n) SIMPLE_BACKUP_SUFFIX is not set(7,n,1 builtins), the
              default is `~'.

       -V METHOD, --version-control=METHOD
              Specify how backup files are named. The METHOD argument  can  be
              `numbered' (or `t'), `existing' (or `nil'), or `never' (or `sim-
              ple').  If this option is not specified, the value of  the  VER-
              SION_CONTROL  environment variable is used.  And if(3,n) VERSION_CON-
              TROL is not set(7,n,1 builtins), the default backup type is `existing'.

              This option corresponds to the Emacs variable `version-control'.
              The valid METHODs are (unique abbreviations are accepted):

              t, numbered
                     Always make numbered backups.

              nil, existing
                     Make  numbered  backups  of files that already have them,
                     simple backups of the others.

              never, simple
                     Always make simple backups.

GNU STANDARD OPTIONS
       --help Print a usage message on standard output and exit(3,n,1 builtins)  successfully.

       --version
              Print version(1,3,5) information on standard output, then exit(3,n,1 builtins) success-
              fully.

       --     Terminate option list.

ENVIRONMENT
       The variables LANG, LC_ALL, LC_CTYPE and  LC_MESSAGES  have  the  usual
       meaning.  For  the  GNU version(1,3,5), the variables SIMPLE_BACKUP_SUFFIX and
       VERSION_CONTROL control backup file(1,n) naming, as described above.

CONFORMING TO
       BSD 4.2 (which had the -c, -m, -o, -g and -s options).

NOTES
       This page describes install as  found  in(1,8)  the  fileutils-4.0  package;
       other versions may differ slightly.



GNU fileutils 4.0                   1998-11                         INSTALL(1)

References for this manual (incoming links)