1RFIO_RCP(3)                      Rfio      Library      Functions
2RFIO_RCP(3)
3
4
5
6[1mNAME[0m
7       rfio_rcp ‐ third party copy of a file
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "rfio_api.h"[0m
12
13       [1mint   rfio_rcp   (char   *[4m[22msource[24m[1m,    char
14*[4m[22mdestination[24m[1m, int [4m[22mtimeout[24m[1m);[0m
15
16[1mDESCRIPTION[0m
17       [1mrfio_rcp [22mtriggers a third party copy of a file.
18
19       [4msource[24m  specifies  the  physical path of the source
20file.
21
22       [4mdestination[0m
23              specifies the physical path of the file at destina‐
24tion.
25
26       [4mtimeout[0m
27              specifies  the  time  after  which the copy is can‐
28celled if not com‐
29              pleted.
30
31[1mRETURN VALUE[0m
32       This routine returns 0 if the operation was successful  or
33‐1  if  the
34       operation failed. In the latter case, [1mserrno [22mis set
35appropriately.
36
37[1mERRORS[0m
38       [1mENOENT       [22mThe  source file does not exist  or  a
39component of [4mdestina‐[0m
40                    [4mtion[24m prefix does not exist.
41
42       [1mEACCES        [22mSearch permission is denied on a com‐
43ponent of  the  [4msource[0m
44                    or [4mdestination[24m prefix or read  permis‐
45sion is not granted on
46                    the source file or write  permission  on  the
47destination
48                    parent directory is denied.
49
50       [1mEFAULT       [4m[22msource[24m or [4mdestination[24m is
51a NULL pointer.
52
53       [1mENOSPC       [22mNo space to store the new file copy.
54
55       [1mENAMETOOLONG   [22mThe    length  of  [4msource[24m  or
56[4mdestination[24m exceeds [1mCA_MAXPATHLEN[0m
57                    or the length of  a  path  component  exceeds
58[1mCA_MAXNAMELEN[22m.
59
60       [1mSENOSHOST    [22mHost unknown.
61
62       [1mSETIMEDOUT   [22mHas timed out.
63
64       [1mSECOMERR     [22mCommunication error.
65
66[1mSEE ALSO[0m
67       [1mCastor_limits(4)[0m
68
69
70
71LCG                                                        $Date$
72RFIO_RCP(3)
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132