cpset(1M)                                               cpset(1M)



NAME
     cpset - installs files in specified directories

SYNOPSIS
     cpset [-o] [-O] file directory [mode [owner [group]]]

ARGUMENTS
     directory
          Specifies the directory into which file is to be
          placed.

     file Specifies the file to be installed.

     group
          Specifies the group affiliation of file when it is
          installed.

     mode Specifies the mode of file when it is installed.

     -o   Moves file to OLDfile in the destination directory
          before installing file, but does not remove OLDfile.

     -O   Moves file to OLDfile in the destination directory
          before installing file, and then removes OLDfile.

     owner
          Specifies the owner of file when it is installed.

DESCRIPTION
     cpset installs a file in a specified directory.  You can
     specify the file permissions, owner, and group affiliation
     of the installed file.  If you do not specify the file
     permissions, owner, and group affiliation, there are two
     possible results:

     ⊕    If you are using cpset with administrative permissions
          (that is, your user ID is less than 100), the following
          defaults are used:

               mode 0755

               owner
                    bin

               group
                    bin

     ⊕    If you are not an administrator, the destination file
          has your default mode, owner, and group.






January 1992                                                    1

cpset(1M)                                               cpset(1M)



EXAMPLES
     The following examples have the same effect (assuming they
     are used by an administrator).  They copy the file echo into
     /bin and give 0755, bin, bin as the mode, owner, and group,
     respectively.

        cpset echo /bin 0755 bin bin
        cpset echo /bin
        cpset echo /bin/echo

     The cpset command uses the file /usr/src/destinations to
     determine the final destination of a file.  This file
     contains pairs of pathnames separated by spaces or tabs.
     The first name is the ``official'' destination, such as
     /bin/echo.  The second name is the new destination.  For
     example, if you move echo from /bin to /usr/bin, the entry
     in /usr/src/destinations would be:

        /bin/echo /usr/bin/echo

     When the actual installation happens, cpset verifies that
     the ``old'' pathname does not exist.  If a file is there,
     cpset issues a warning and continues.  The
     /usr/src/destinations file is not distributed with the
     system; sites use it to track local command movement.  The
     procedures for building the source define the ``official''
     locations of the source.

STATUS MESSAGES AND VALUES
     If you use the -O option and cpset cannot remove OLDfile,
     for example, because OLDfile is currently running, cpset
     displays this message:

     cpset: Warning: Could not unlink 'OLDfile' - No such file or directory


NOTES
     The environment variable ROOT locates the destination file
     (in the form $ROOT/usr/src/destinations).  This is necessary
     when cross-generation is being done on a production system.

FILES
     /usr/bin/cpset
          Executable file

SEE ALSO
     install(1M)

     make(1) in A/UX Command Reference






2                                                    January 1992