NAME

cpset − install object files in binary directories

SYNOPSIS

cpset [-o] object directory [mode owner group]

DESCRIPTION

cpset is used to install the specified object file in the given directory.  The mode, owner, and group of the destination file may be specified on the command line.  If this data is omitted, two results are possible:

If the user of cpset has administrative permissions (that is, the user’s numberical ID is less than 100), the following defaults  are provided:

mode - 0755
owner - bin
group - bin

If the user is not an administrator, the default, owner, and group of the destination file will be that of the invoker. 

For example:

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

All the examples above have the same effect (assuming the user is an administrator). The file echo will be copied into /bin and will be given 0755, bin, bin as the mode, owner and group, respectively. 

An optional argument of -o will force cpset to move object to OLDobject in the destination directory before installing the new object. cpset will fail if the filename OLDobject exceeds the maximum allowable filename size of the target filesystem on which the destination directory resides (currently, 14 characters on a System V filesystem, 255 characters on a LAFS filesystem). 

cpset utilizes the file /usr/src/destinations to determine the final destination of a file.  The locations file contains pairs of path names separated by spaces or tabls.  The first name is the “official” destination (for example: /bin/echo).  The second name is the new destination.  For example, if echo is moved 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” path name does not exist.  If a file exists at that location, cpset issues a warning and continues.  This file does not exist on a distribution tape; it us used by sites to track local command movement.  The procedures used to build the source will be responsible for defining the “official” locations of the source. 

Cross Generation

The environment variable ROOT will be used to locate the destination file (in the form $ROOT/usr/src/destination).  This is necessary in the cases where cross generation is being done on a production system. 

SEE ALSO

install(1M), make(1), mk(8)

September 02, 1992