- dccp - copy files from/to DiskCache
dccp [ -d <debuglevel> ] [ -h <replyHostName> ] [ -i ]
[ -S ] [ [ -P ] [ -t <time> ] [ -l <location> ] ]
[ -a ] [-b <read-ahead bufferSize>] [ -B <bufferSize> ] [ -u ]
[ -p <first_port>[:last_port] ] [ -T <IO tunnel plugin> ]
[ -r <TCP recive buffer size>] [ -s <TCP send buffer size>]
source [ destination ]
The dccp utility provides a cp(1) like functionality on the pnfs file system. The source must be a single file while the destination could be a directory name as well as a file name. If the directory is a destination, a new file with the same name as the source name will be created there and the contents of the source will be copied.
If the final destination file exists in pnfs, it won't be overwritten and an error code will be returned. Files in regular file systems will always be ovrerwriten if the -i option is not specified.
If the source and the final destination file are located on a regular file system (non pnfs), the dccp utility can be used similar to the cp(1) program.
- The following options are supported:
-d N Set the debug level. The possible debug levels are: 0: no output at all; 1: error messages only; 2: usefull information; 4: speed information; 8: trace ( for developers only ); 16: function calls sequence ( for developers only ); 32: IO ( for developers only ). Multiple -d options allowed. -h hostname Bind the callback connection to the specific interface. -i Secure mode. Do not overwrite the existing files. -a Enable the read-ahead. -b read-ahead bufferSize Specify read-ahead buffer size. -B bufferSize Specify transfer buffer size. -P Pre-stage. Do not copy the file now. -t time Specify time interval in seconds after which file should be staged. Used with -P option only. -l location Specify the location for pre-stage. If the location is not specifed, then local host name will be used. Used with -P option only. -u Enable unsafe write e.g. have only one acknoledgment at close for complete write operation. (Recommended for reproducible sources). -p first_port[:last_port] Bind the callback data connection to the specified TCP port/range. -T tunnel plugin Uses specified library for autehntification and tunneling of control line. -r TCP recive buffer size Specify the TCP resive buffer size. Default 256K. -s TCP send buffer size Specify the TCP send buffer size. Default 256K.
- The following operands are supported:
source A pathname of a regular file to be copied. destination A pathname of a directory or regular file where to copy the file. The stdin/stdout can be used as source/destination.
- Example 1: To copy a file:
- example% dccp user_output_file /acs/<user_space>/new_output_file
- Example 2: To copy a file to a destination directory:
- example% dccp user_output_file /acs/<user_space>/
- Example 3: Pre-Stage request:
- example% dccp -P -t 3600 -l batch_node.desy.de /acs/<user_space>/data_file
- Example 4: stdin/stdout:
- example% tar cf - <data_dir> | dccp - /acs/<user_space>/data_arch.tar
- example% dccp /acs/<user_space>/data_arch.tar - | tar xf -
The following exit values are returned: 0 All files were copied successfully. >0 An error occurred.
The regular expansion might be used with dccp only in case it results in a single operand.