DragonFly On-Line Manual Pages

Search: Section:  

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 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


SEE ALSO

       siod http://people.delphi.com/gjc/siod.html


AUTHOR

       George Carrette, GJC@delphi.com

                                     LOCAL                        cp-build(1C)

Search: Section: