install(1B)

NAME

     install - install files

SYNOPSIS

     /usr/ucb/install  [-cs]  [-g group]   [-m mode]   [-o owner]
     filename1 filename2

     /usr/ucb/install  [-cs]  [-g group]   [-m mode]   [-o owner]
     filename... directory

     /usr/ucb/install -d [-g group] [-m mode]  [-o owner]  direc-
     tory

DESCRIPTION

     install is used within makefiles to  copy  new  versions  of
     files  into a destination directory and to create the desti-
     nation directory itself.

     The first two forms are similar to the  cp(1)  command  with
     the  addition  that  executable files can be stripped during
     the copy and the owner, group, and  mode  of  the  installed
     file(s) can be given.

     The third form can be used to create a destination directory
     with the required owner, group and permissions.

     Note: install uses no special privileges to copy files  from
     one place to another. The implications of this are:

        o  You must have permission  to  read  the  files  to  be
           installed.

        o  You must have permission to copy into the  destination
           file or directory.

        o  You must have permission to change the  modes  on  the
           final  copy  of  the  file  if  you want to use the -m
           option to change modes.

        o  You must be superuser if you want to specify the  own-
           ership  of  the installed file with -o. If you are not
           the super-user,  or  if  -o  is  not  in  effect,  the
           installed file will be owned by you, regardless of who
           owns the original.

OPTIONS

     -c    Copy files. In fact install always copies  files,  but
           the  -c option is retained for backwards compatibility
           with old shell scripts that might otherwise break.

     -d    Create a directory.  Missing  parent  directories  are
           created  as  required as in mkdir -p. If the directory
           already exists, the owner, group and mode will be  set
           to the values given on the command line.

     -s    Strip executable files as they are copied.

     -g group
           Set the group  ownership  of  the  installed  file  or
           directory. (staff by default.)

     -m mode
           Set the mode for  the  installed  file  or  directory.
           (0755 by default.)

     -o owner
           If run as root, set the  ownership  of  the  installed
           file to the user-ID of owner.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWscpu                    |
    |_____________________________|_____________________________|

SEE ALSO

     chgrp(1), chmod(1),  chown(1),  cp(1),  mkdir(1),  strip(1),
     install(1M), attributes(5)