NAME

cp-build - copy a file to a destination with version numbering and auditing

SYNOPSIS

cp-build filename [destination] [:override=option[,options]] [:lock=option]

DESCRIPTION

The cp-build command will copy a file to a destination directory or file, while appending a version number to the end of the final destination, and setting up a symbolic link from the final destination to the new version of the file it creates. The user must have write access to the destination audit file in order to run the command. The audit file is used to interlock against concurrent copies to the same final destination and to enforce various rules controlling the copying.

The actual destination data file is left with a read-only protection.

COMMAND LINE OPTIONS

destination

The destination defaults to the setting of the environment variable CP_BUILD_DESTINATION and may be either a directory or a file.

:override=XXXXX

The XXXXX is used to force the command to go ahead and copy the file to the destination even if certain rules have been violated. The defined rules are old,same,size. Which prevent an old file, the same file, or a file of a radically different size from being copied to the destination. Currently only the same rule is implemented.

:lock=option

The option defaults to error which will result in any error if any other process is doing a cp-build concurrently. The option may also be specified as wait which will cause the cp-build to wait the other process has released its lock on the audit file.

FILES

/usr/local/bin/siod /var/shlib/libsiod.so

AUTHOR