release notes | Book: 2.16, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2 | Wiki | Q&A black_bg



User Commands

NAME

SYNOPSIS

DESCRIPTION

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.

OPTIONS

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

OPERANDS

    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.

EXAMPLES

    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 -

EXIT STATUS

     The following exit values are returned:

          0     All files were copied successfully.
          >0    An error occurred.

NOTES

The regular expansion might be used with dccp only in case it results in a single operand.