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)

NAME | SYNOPSIS | DESCRIPTION | FILES | SEE ALSO | AUTHOR

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

home | help