


cp-build(1C)                                                     cp-build(1C)



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 inter-
  lock 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 imple-
          mented.

  :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

AUTHOR
  George Carrette, GJC@world.std.com









