1dccp(1)                     General Commands Manual                    dccp(1)
2
3
4

Name

6       dccp - Copy a file from or to a dCache server.
7
8

Synopsis

10       dccp [option...] <sourceUrl> <destUrl>
11
12

Arguments

14       The following arguments are required:
15
16       sourceUrl
17
18              The URL of the source file.
19
20       destUrl
21
22              The URL of the destination file.
23
24

Description

26       The dccp utility provides a cp(1) like functionality on the dCache file
27       system. The source must be a single file while the destination could be
28       a  directory  name or a file name. If the directory is a destination, a
29       new file with the same name as the source name will  be  created  there
30       and the contents of the source will be copied. If the final destination
31       file exists in dCache, it won’t be overwritten and an error  code  will
32       be  returned.  Files in regular file systems will always be overwritten
33       if the -i option is not specified. If the source and the final destina‐
34       tion file are located on a regular file system, the dccp utility can be
35       used similar to the cp(1) program.
36
37

Options

39       The following arguments are optional:
40
41       -a
42              Enable read-ahead functionality.
43
44       -b <bufferSize>
45
46              Set read-ahead buffer size. The default value is 1048570  Bytes.
47              To  disable  the  buffer  this can be set to any value below the
48              default. dccp will attempt to allocate the buffer size  so  very
49              large values should be used with care.
50
51       -B <bufferSize>
52
53              Set  buffer  size.  The  size of the buffer is requested in each
54              request, larger buffers will be needed to saturate higher  band‐
55              width  connections.  The optimum value is network dependent. Too
56              large a value will lead to excessive memory usage, too  small  a
57              value will lead to excessive network communication.
58
59       -d <debug level>
60
61              Set  the  debug  level. <debug level> is a integer between 0 and
62              127. If the value is 0 then no output  is  generated,  otherwise
63              the  value  is formed by adding together one or more of the fol‐
64              lowing values:
65
66                  Value Enabled output
67                  1     Error messages
68                  2     Info messages
69                  4     Timing information
70                  8     Trace information
71                  16    Show stack-trace
72                  32    IO operations
73                  32    IO operations
74                  64    Thread information
75
76       -h <replyHostName>
77
78              Bind the callback connection to the specific hostname interface.
79
80       -H
81
82              show progress during file transfer.
83
84       -i
85
86              Secure mode. Do not overwrite the existing files.
87
88       -l <location>
89
90              Set location for pre-stage. if the location  is  not  specified,
91              the  local  host  of  the door will be used. This option must be
92              used with the -P option.
93
94       -p <first_port>:<last_port>
95
96              Bind  the  callback  data  connection  to  the   specified   TCP
97              port/rangeSet  port  range.  Delimited by the ’:’ character, the
98              <first_port> is required but the <last_port> is optional.
99
100       -P
101
102              Pre-stage. Do not copy the file to a local host  but  make  sure
103              the file is on disk on the dCache server.
104
105       -r <bufferSize>
106
107              TCP  receive buffer size. The default is 256K. Setting to 0 uses
108              the system default  value.  Memory  useage  will  increase  with
109              higher values, but performance better.
110
111       -s <bufferSize>
112
113              TCP send buffer size. The default is 256K. Setting to 0 uses the
114              system default value.
115
116       -t <time>
117
118              Stage timeout in seconds. This option must be used with  the  -P
119              option.
120
121

Examples:

123       To copy a file to dCache:
124
125              [user] $ dccp /etc/group dcap://example.org/pnfs/desy.de/gading/
126
127       To copy a file from dCache:
128
129              [user] $ dccp dcap://example.org/pnfs/desy.de/gading/group /tmp/
130
131       Pre-Stage request:
132
133              [user]     $     dccp     -P     -t    3600    -l    example.org
134              /acs/user_space/data_file
135
136       stdin:
137
138              [user]    $    tar    cf     -     data_dir     |     dccp     -
139              /acs/user_space/data_arch.tar
140
141       stdout:
142
143              [user] $ dccp /acs/user_space/data_arch.tar - | tar xf -
144
145

See also

147       cp
148
149
150
151version 2.47.6                 22 February 2011                        dccp(1)
Impressum