Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 au-
     dit  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 var-
     ious 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 http://people.delphi.com/gjc/siod.html

AUTHOR
     George Carrette, GJC@delphi.com

				      LOCAL			    cp-build(1C)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cp-build&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help