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

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

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)

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

home | help