Name

       dccp - Copy a file from or to a dCache server.

Synopsis

       dccp [option...] <sourceUrl> <destUrl>

Arguments

       The following arguments are required:

       sourceUrl

              The URL of the source file.

       destUrl

              The URL of the destination file.

Description

       The dccp utility provides a cp(1) like functionality on the dCache file system. The source
       must be a single file while the destination could be a directory name or 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  dCache,  it  won’t be overwritten and an error code will be returned. Files in
       regular file systems will always be overwritten if the -i option is not specified. If  the
       source  and  the  final  destination  file  are located on a regular file system, the dccp
       utility can be used similar to the cp(1) program.

Options

       The following arguments are optional:

       -a
              Enable read-ahead functionality.

       -b <bufferSize>

              Set read-ahead buffer size. The default value is  1048570  Bytes.  To  disable  the
              buffer  this  can  be  set  to  any  value below the  default. dccp will attempt to
              allocate the buffer size so very large values should be used with care.

       -B <bufferSize>

              Set buffer size. The size of the  buffer  is  requested  in  each  request,  larger
              buffers  will be needed to saturate higher bandwidth connections. The optimum value
              is network dependent. Too large a value will lead to excessive  memory  usage,  too
              small a value will lead to excessive network communication.

       -d <debug level>

              Set  the debug level. <debug level> is a integer between 0 and 127. If the value is
              0 then no output is generated, otherwise the value is formed by adding together one
              or more of the following values:

                  Value Enabled output
                  1     Error messages
                  2     Info messages
                  4     Timing information
                  8     Trace information
                  16    Show stack-trace
                  32    IO operations
                  32    IO operations
                  64    Thread information

       -h <replyHostName>

              Bind the callback connection to the specific hostname interface.

       -H

              show progress during file transfer.

       -i

              Secure mode. Do not overwrite the existing files.

       -l <location>

              Set location for pre-stage. if the location is not specified, the local host of the
              door will be used. This option must be used with the -P option.

       -p <first_port>:<last_port>

              Bind the callback data connection to the specified TCP  port/rangeSet  port  range.
              Delimited by the ’:’ character, the <first_port> is required but the <last_port> is
              optional.

       -P

              Pre-stage. Do not copy the file to a local host but make sure the file is  on  disk
              on the dCache server.

       -r <bufferSize>

              TCP  receive buffer size. The default is 256K. Setting to 0 uses the system default
              value. Memory useage will increase with higher values, but performance better.

       -s <bufferSize>

              TCP send buffer size. The default is 256K. Setting to 0  uses  the  system  default
              value.

       -t <time>

              Stage timeout in seconds. This option must be used with the -P option.

Examples:

       To copy a file to dCache:

              [user] $ dccp /etc/group dcap://example.org/pnfs/desy.de/gading/

       To copy a file from dCache:

              [user] $ dccp dcap://example.org/pnfs/desy.de/gading/group /tmp/

       Pre-Stage request:

              [user] $ dccp -P -t 3600 -l example.org /acs/user_space/data_file

       stdin:

              [user] $ tar cf - data_dir | dccp - /acs/user_space/data_arch.tar

       stdout:

              [user] $ dccp /acs/user_space/data_arch.tar - | tar xf -

See also

       cp