cp-build(1C)cp-build(1C)NAMEcp-build - copy a file to a destination with version numbering and
auditing
SYNOPSIScp-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 destina‐
tion, 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 desti‐
nation 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 vio‐
lated. 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
SEE ALSO
siod http://people.delphi.com/gjc/siod.html
AUTHOR
George Carrette, GJC@delphi.com
LOCAL cp-build(1C)
