xrootd
XrdCpConfig.hh
Go to the documentation of this file.
1 #ifndef __XRDCPCONFIG_HH__
2 #define __XRDCPCONFIG_HH__
3 /******************************************************************************/
4 /* */
5 /* X r d C p C o n f i g . h h */
6 /* */
7 /* (c) 2012 by the Board of Trustees of the Leland Stanford, Jr., University */
8 /* All Rights Reserved */
9 /* Produced by Andrew Hanushevsky for Stanford University under contract */
10 /* DE-AC02-76-SFO0515 with the Department of Energy */
11 /* */
12 /* This file is part of the XRootD software suite. */
13 /* */
14 /* XRootD is free software: you can redistribute it and/or modify it under */
15 /* the terms of the GNU Lesser General Public License as published by the */
16 /* Free Software Foundation, either version 3 of the License, or (at your */
17 /* option) any later version. */
18 /* */
19 /* XRootD is distributed in the hope that it will be useful, but WITHOUT */
20 /* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or */
21 /* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public */
22 /* License for more details. */
23 /* */
24 /* You should have received a copy of the GNU Lesser General Public License */
25 /* along with XRootD in a file called COPYING.LESSER (LGPL license) and file */
26 /* COPYING (GPL license). If not, see <http://www.gnu.org/licenses/>. */
27 /* */
28 /* The copyright holder's institutional names and contributor's names may not */
29 /* be used to endorse or promote products derived from this software without */
30 /* specific prior written permission of the institution or contributor. */
31 /******************************************************************************/
32 
33 #include "XrdCks/XrdCksData.hh"
34 
35 #include <ctype.h>
36 #include <stdint.h>
37 
38 struct option;
39 class XrdCks;
40 class XrdCksCalc;
41 class XrdCpFile;
42 class XrdSysError;
43 
45 {
46 public:
47 
48 struct defVar
49  { defVar *Next; // -> Next such definition, 0 if no more
50  const char *vName; // -> Variable name
51  union {const char *strVal; // -> String value if in strDefs
52  int intVal; // Integer value if in intDefs
53  };
54  defVar(const char *vn, const char *vl)
55  : Next(0), vName(vn), strVal(vl) {}
56  defVar(const char *vn, int vl)
57  : Next(0), vName(vn), intVal(vl) {}
58  };
59 
60  defVar *intDefs; // -> -DI settings
61  defVar *strDefs; // -> -DS settings
62  const char *dstOpq; // -> -OD setting (dest opaque)
63  const char *srcOpq; // -> -OS setting (src opaque)
64  const char *Pgm; // -> Program name
65  long long xRate; // -> xrate value in bytes/sec (0 if not set)
66  long long xRateThreashold; // -> xrate threshold value in bytes/sec (0 if not set)
67  int Parallel; // Number of simultaneous copy ops (1 to 4)
68  char *pHost; // -> SOCKS4 proxy hname (0 if none)
69  int pPort; // SOCKS4 proxy port
70  long long OpSpec; // Bit mask of set options (see Doxxxx)
71  int Dlvl; // Debug level (0 to 3)
72  int nSrcs; // Number of sources wanted (dflt 1)
73  int nStrm; // Number of streams wanted (dflt 1)
74  int Retry; // Max times to retry connects (<0->use dflt)
75  int Verbose; // True if --verbose specified
76  int CksLen; // Binary length of checksum, if any
77 
78  int numFiles; // Number of source files
79  long long totBytes; // Total number of bytes for local files
80 
81 XrdCksData CksData; // Checksum information
82 XrdCks *CksMan; // -> Checksum manager
83 XrdCksCalc *CksObj; // -> Cks computation object (0 if no cks)
84 const char *CksVal; // -> Cks argument (0 if none)
85 
86 XrdCpFile *srcFile; // List of source files
87 XrdCpFile *dstFile; // The destination for the copy
88 
89 char *zipFile; // The file name if the URL points to a ZIP archive
90 
91 static XrdSysError *Log; // -> Error message object
92 
93 static const uint64_t OpCksum = 'C'; // -adler -MD5 legacy -> DoCksrc
94 static const uint64_t DoCksrc = 0x0000000000000001LL; // --cksum <type>:source
95 static const uint64_t DoCksum = 0x0000000000000002LL; // --cksum <type>
96 static const uint64_t DoCkprt = 0x0000000000000004LL; // --cksum <type>:print
97 
98 static const uint64_t OpCoerce = 'F';
99 static const uint64_t DoCoerce = 0x0000000000000008LL; // -F | --coerce
100 
101 static const uint64_t OpDebug = 'd';
102 static const uint64_t DoDebug = 0x0000000000000010LL; // -d | --debug <val>
103 
104 static const uint64_t OpForce = 'f';
105 static const uint64_t DoForce = 0x0000000000000020LL; // -f | --force
106 
107 static const uint64_t OpHelp = 'h';
108 static const uint64_t DoHelp = 0x0000000000000040LL; // -h | --help
109 
110 static const uint64_t OpIfile = 'I';
111 static const uint64_t DoIfile = 0x0000000000000080LL; // -I | --infiles
112 
113 static const uint64_t OpLicense = 'H'; // -H | --license
114 
115 static const uint64_t OpNoPbar = 'N'; // -N | --nopbar | -np {legacy}
116 static const uint64_t DoNoPbar = 0x0000000000000100LL;
117 
118 static const uint64_t OpPosc = 'P';
119 static const uint64_t DoPosc = 0x0000000000000200LL; // -P | --posc
120 
121 static const uint64_t OpProxy = 'D';
122 static const uint64_t DoProxy = 0x0000000000000400LL; // -D | --proxy
123 
124 static const uint64_t OpRecurse = 'r';
125 static const uint64_t OpRecursv = 'R'; // -r | --recursive | -R {legacy}
126 static const uint64_t DoRecurse = 0x0000000000000800LL;
127 
128 static const uint64_t OpRetry = 't';
129 static const uint64_t DoRetry = 0x0000000000001000LL; // -t | --retry
130 
131 static const uint64_t OpServer = 0x03;
132 static const uint64_t DoServer = 0x0000000000002000LL; // --server
133 
134 static const uint64_t OpSilent = 's';
135 static const uint64_t DoSilent = 0x0000000000004000LL; // -s | --silent
136 
137 static const uint64_t OpSources = 'y';
138 static const uint64_t DoSources = 0x0000000000008000LL; // -y | --sources
139 
140 static const uint64_t OpStreams = 'S';
141 static const uint64_t DoStreams = 0x0000000000010000LL; // -S | --streams
142 
143 static const uint64_t OpTpc = 'T'; // -T | --tpc [delegate] {first | only}
144 static const uint64_t DoTpc = 0x0000000000020000LL; // --tpc {first | only}
145 static const uint64_t DoTpcOnly = 0x0000000000100000LL; // --tpc only
146 static const uint64_t DoTpcDlgt = 0x0000000000800000LL; // --tpc delegate ...
147 
148 static const uint64_t OpVerbose = 'v';
149 static const uint64_t DoVerbose = 0x0000000000040000LL; // -v | --verbose
150 
151 static const uint64_t OpVersion = 'V'; // -V | --version
152 
153 static const uint64_t OpXrate = 'X';
154 static const uint64_t DoXrate = 0x0000000000080000LL; // -X | --xrate
155 
156 static const uint64_t OpParallel = 0x04;
157 static const uint64_t DoParallel = 0x0000000000200000LL; // --parallel
158 
159 static const uint64_t OpDynaSrc = 'Z';
160 static const uint64_t DoDynaSrc = 0x0000000000400000LL; // --dynamic-src
161 
162 // const uint64_t DoTpcDlgt = 0x0000000000800000LL; // Marker for bit used
163 
164 static const uint64_t OpZip = 'z';
165 static const uint64_t DoZip = 0x0000000001000000LL; // -z | --zip
166 
167 static const uint64_t OpTlsNoData = 'E';
168 static const uint64_t DoTlsNoData = 0x0000000002000000LL; // -E | --tlsnodata
169 
170 static const uint64_t OpNoTlsOK = 0x05;
171 static const uint64_t DoNoTlsOK = 0x0000000004000000LL; // --notlsok
172 
173 static const uint64_t OpTlsMLF = 0x06;
174 static const uint64_t DoTlsMLF = 0x0000000008000000LL; // --tlsmetalink
175 
176 static const uint64_t OpPath = 'p';
177 static const uint64_t DoPath = 0x0000000010000000LL; // -p | --path
178 
179 static const uint64_t OpXAttr = 0x07;
180 static const uint64_t DoXAttr = 0x0000000020000000LL; // --xattr
181 
182 static const uint64_t OpZipMtlnCksum = 0x08;
183 static const uint64_t DoZipMtlnCksum = 0x0000000040000000LL; // --zip-mtln-cksum
184 
185 static const uint64_t OpRmOnBadCksum = 0x09;
186 static const uint64_t DoRmOnBadCksum = 0x0000000080000000LL; // --rm-bad-cksum
187 
188 static const uint64_t OpContinue = 0x10;
189 static const uint64_t DoContinue = 0x0000000100000000LL; // --continue
190 
191 static const uint64_t OpXrateThreashold = 0x11;
192 static const uint64_t DoXrateThreashold = 0x0000000200000000LL; // --xrate-threashold
193 
194 // Flag to allow the use of HTTP (and HTTPS) as source and destination
195 // protocols. If specified, the XrdClHttp client plugin must be available
196 // for the transfer operations to succeed.
197 static const int OpAllowHttp = 'A';
198 static const int DoAllowHttp = 0x2000000; // --allow-http
199 
200 // Call Config with the parameters passed to main() to fill out this object. If
201 // the method returns then no errors have been found. Otherwise, it exits.
202 // The following options may be passed (largely to support legacy stuff):
203 //
204 static const int opt1Src = 0x00000001; // Only one source is allowed
205 static const int optNoXtnd = 0x00000002; // Do not index source directories
206 static const int optRmtRec = 0x00000004; // Allow remote recursive copy
207 static const int optNoStdIn = 0x00000008; // Disallow '-' as src for stdin
208 static const int optNoLclCp = 0x00000010; // Disallow local/local copy
209 
210  void Config(int argc, char **argv, int Opts=0);
211 
212 // Method to check for setting
213 //
214 inline int Want(uint64_t What) {return (OpSpec & What) != 0;}
215 
216  XrdCpConfig(const char *pgname);
217  ~XrdCpConfig();
218 
219 private:
220  int a2i(const char *item, int *val, int minv, int maxv=-1);
221  int a2l(const char *item, long long *val,
222  long long minv, long long maxv=-1);
223  int a2t(const char *item, int *val, int minv, int maxv=-1);
224  int a2x(const char *Val, char *Buff, int Vlen);
225  int a2z(const char *item, long long *val,
226  long long minv, long long maxv=-1);
227  int defCks(const char *opval);
228  int defOpq(const char *theOp);
229  int defOpt(const char *theOp, const char *theArg);
230  void defPxy(const char *opval);
231  const char *Human(long long Val, char *Buff, int Blen);
232  int Legacy(int oIndex);
233  int Legacy(const char *theOp, const char *theArg);
234  void License();
235  const char *OpName();
236  void ProcFile(const char *fname);
237  void Usage(int rc=0);
238 
239  static void toLower( char cstr[] )
240  {
241  for( int i = 0; cstr[i]; ++i )
242  cstr[i] = tolower( cstr[i] );
243  }
244 
245 
246  const char *PName;
247  int Opts;
248  int Argc;
249  char **Argv;
252 
253 static const char *opLetters;
254 static struct option opVec[];
255 
256 static const int dfltSrcs = 12;
257 
261  char *inFile;
262  char **parmVal;
263  int parmCnt;
264  int isLcl;
265 };
266 #endif
static const uint64_t DoServer
Definition: XrdCpConfig.hh:132
static const uint64_t OpTpc
Definition: XrdCpConfig.hh:143
defVar * intDend
Definition: XrdCpConfig.hh:250
int a2z(const char *item, long long *val, long long minv, long long maxv=-1)
static const uint64_t OpCoerce
Definition: XrdCpConfig.hh:98
defVar(const char *vn, int vl)
Definition: XrdCpConfig.hh:56
char * pHost
Definition: XrdCpConfig.hh:68
const char * strVal
Definition: XrdCpConfig.hh:51
XrdCpFile * pFile
Definition: XrdCpConfig.hh:258
int nStrm
Definition: XrdCpConfig.hh:73
static const uint64_t DoPosc
Definition: XrdCpConfig.hh:119
static const uint64_t OpTlsNoData
Definition: XrdCpConfig.hh:167
XrdCks * CksMan
Definition: XrdCpConfig.hh:82
const char * CksVal
Definition: XrdCpConfig.hh:84
long long totBytes
Definition: XrdCpConfig.hh:79
static const uint64_t OpHelp
Definition: XrdCpConfig.hh:107
int isLcl
Definition: XrdCpConfig.hh:264
static const uint64_t OpServer
Definition: XrdCpConfig.hh:131
Definition: XrdCks.hh:91
int Verbose
Definition: XrdCpConfig.hh:75
static const uint64_t OpLicense
Definition: XrdCpConfig.hh:113
static const uint64_t OpPath
Definition: XrdCpConfig.hh:176
int Dlvl
Definition: XrdCpConfig.hh:71
static struct option opVec[]
Definition: XrdCpConfig.hh:254
static const uint64_t OpStreams
Definition: XrdCpConfig.hh:140
int nSrcs
Definition: XrdCpConfig.hh:72
int parmCnt
Definition: XrdCpConfig.hh:263
char ** parmVal
Definition: XrdCpConfig.hh:262
static const uint64_t OpXrate
Definition: XrdCpConfig.hh:153
static const uint64_t OpCksum
Definition: XrdCpConfig.hh:93
static const uint64_t DoTpcDlgt
Definition: XrdCpConfig.hh:146
XrdCpFile * pLast
Definition: XrdCpConfig.hh:259
static const uint64_t DoRecurse
Definition: XrdCpConfig.hh:126
static const uint64_t DoCksrc
Definition: XrdCpConfig.hh:94
int Legacy(int oIndex)
XrdCpFile * dstFile
Definition: XrdCpConfig.hh:87
static const int DoAllowHttp
Definition: XrdCpConfig.hh:198
char ** Argv
Definition: XrdCpConfig.hh:249
XrdCpConfig(const char *pgname)
defVar * strDefs
Definition: XrdCpConfig.hh:61
static XrdSysError * Log
Definition: XrdCpConfig.hh:91
static const uint64_t OpSources
Definition: XrdCpConfig.hh:137
static const uint64_t OpTlsMLF
Definition: XrdCpConfig.hh:173
static const uint64_t OpZipMtlnCksum
Definition: XrdCpConfig.hh:182
static const uint64_t DoNoPbar
Definition: XrdCpConfig.hh:116
int a2l(const char *item, long long *val, long long minv, long long maxv=-1)
int Want(uint64_t What)
Definition: XrdCpConfig.hh:214
static const uint64_t DoParallel
Definition: XrdCpConfig.hh:157
static const uint64_t OpRecurse
Definition: XrdCpConfig.hh:124
static const uint64_t DoTlsNoData
Definition: XrdCpConfig.hh:168
static const uint64_t DoPath
Definition: XrdCpConfig.hh:177
static const uint64_t DoDebug
Definition: XrdCpConfig.hh:102
const char * Human(long long Val, char *Buff, int Blen)
static const uint64_t OpParallel
Definition: XrdCpConfig.hh:156
Definition: XrdCksData.hh:37
static const uint64_t DoForce
Definition: XrdCpConfig.hh:105
defVar * strDend
Definition: XrdCpConfig.hh:251
static const uint64_t OpXAttr
Definition: XrdCpConfig.hh:179
Definition: XrdSysError.hh:89
static const uint64_t DoDynaSrc
Definition: XrdCpConfig.hh:160
static const uint64_t DoVerbose
Definition: XrdCpConfig.hh:149
static const uint64_t OpVerbose
Definition: XrdCpConfig.hh:148
static const uint64_t DoSources
Definition: XrdCpConfig.hh:138
XrdCpFile * pPrev
Definition: XrdCpConfig.hh:260
static const uint64_t OpForce
Definition: XrdCpConfig.hh:104
defVar * intDefs
Definition: XrdCpConfig.hh:60
const char * dstOpq
Definition: XrdCpConfig.hh:62
static const uint64_t DoHelp
Definition: XrdCpConfig.hh:108
static const uint64_t OpVersion
Definition: XrdCpConfig.hh:151
static const uint64_t DoTlsMLF
Definition: XrdCpConfig.hh:174
Definition: XrdCpFile.hh:36
Definition: XrdCksCalc.hh:39
defVar * Next
Definition: XrdCpConfig.hh:49
void defPxy(const char *opval)
int defOpt(const char *theOp, const char *theArg)
defVar(const char *vn, const char *vl)
Definition: XrdCpConfig.hh:54
int defCks(const char *opval)
static const uint64_t OpXrateThreashold
Definition: XrdCpConfig.hh:191
static const uint64_t OpContinue
Definition: XrdCpConfig.hh:188
Definition: XrdCpConfig.hh:44
int CksLen
Definition: XrdCpConfig.hh:76
static const uint64_t OpDebug
Definition: XrdCpConfig.hh:101
static const uint64_t OpNoPbar
Definition: XrdCpConfig.hh:115
XrdCksCalc * CksObj
Definition: XrdCpConfig.hh:83
XrdCpFile * srcFile
Definition: XrdCpConfig.hh:86
static const uint64_t DoSilent
Definition: XrdCpConfig.hh:135
void License()
int intVal
Definition: XrdCpConfig.hh:52
static const uint64_t OpProxy
Definition: XrdCpConfig.hh:121
static const uint64_t OpZip
Definition: XrdCpConfig.hh:164
static const uint64_t DoRetry
Definition: XrdCpConfig.hh:129
int numFiles
Definition: XrdCpConfig.hh:78
static const int optNoXtnd
Definition: XrdCpConfig.hh:205
static const uint64_t DoProxy
Definition: XrdCpConfig.hh:122
int a2t(const char *item, int *val, int minv, int maxv=-1)
static const uint64_t OpDynaSrc
Definition: XrdCpConfig.hh:159
static const int optRmtRec
Definition: XrdCpConfig.hh:206
int Parallel
Definition: XrdCpConfig.hh:67
long long xRateThreashold
Definition: XrdCpConfig.hh:66
static const uint64_t OpNoTlsOK
Definition: XrdCpConfig.hh:170
void Usage(int rc=0)
static const int dfltSrcs
Definition: XrdCpConfig.hh:256
void Config(int argc, char **argv, int Opts=0)
static const uint64_t DoTpcOnly
Definition: XrdCpConfig.hh:145
char * zipFile
Definition: XrdCpConfig.hh:89
int pPort
Definition: XrdCpConfig.hh:69
static const char * opLetters
Definition: XrdCpConfig.hh:253
static const uint64_t DoContinue
Definition: XrdCpConfig.hh:189
static const uint64_t OpRmOnBadCksum
Definition: XrdCpConfig.hh:185
int Argc
Definition: XrdCpConfig.hh:248
long long xRate
Definition: XrdCpConfig.hh:65
static const uint64_t DoRmOnBadCksum
Definition: XrdCpConfig.hh:186
int a2i(const char *item, int *val, int minv, int maxv=-1)
static const uint64_t DoStreams
Definition: XrdCpConfig.hh:141
static const uint64_t DoTpc
Definition: XrdCpConfig.hh:144
static const int optNoLclCp
Definition: XrdCpConfig.hh:208
void ProcFile(const char *fname)
static const uint64_t OpSilent
Definition: XrdCpConfig.hh:134
const char * vName
Definition: XrdCpConfig.hh:50
const char * srcOpq
Definition: XrdCpConfig.hh:63
int a2x(const char *Val, char *Buff, int Vlen)
static const uint64_t OpRetry
Definition: XrdCpConfig.hh:128
XrdCksData CksData
Definition: XrdCpConfig.hh:81
static const uint64_t DoZipMtlnCksum
Definition: XrdCpConfig.hh:183
static const uint64_t OpIfile
Definition: XrdCpConfig.hh:110
Definition: XrdCpConfig.hh:48
static const int optNoStdIn
Definition: XrdCpConfig.hh:207
static const uint64_t DoXAttr
Definition: XrdCpConfig.hh:180
static const uint64_t DoCksum
Definition: XrdCpConfig.hh:95
long long OpSpec
Definition: XrdCpConfig.hh:70
static const uint64_t DoXrate
Definition: XrdCpConfig.hh:154
static void toLower(char cstr[])
Definition: XrdCpConfig.hh:239
const char * PName
Definition: XrdCpConfig.hh:246
static const uint64_t DoIfile
Definition: XrdCpConfig.hh:111
static const uint64_t DoZip
Definition: XrdCpConfig.hh:165
static const int opt1Src
Definition: XrdCpConfig.hh:204
int Opts
Definition: XrdCpConfig.hh:247
const char * OpName()
static const uint64_t DoXrateThreashold
Definition: XrdCpConfig.hh:192
static const uint64_t OpRecursv
Definition: XrdCpConfig.hh:125
const char * Pgm
Definition: XrdCpConfig.hh:64
static const uint64_t OpPosc
Definition: XrdCpConfig.hh:118
static const int OpAllowHttp
Definition: XrdCpConfig.hh:197
static const uint64_t DoCkprt
Definition: XrdCpConfig.hh:96
int defOpq(const char *theOp)
static const uint64_t DoCoerce
Definition: XrdCpConfig.hh:99
char * inFile
Definition: XrdCpConfig.hh:261
static const uint64_t DoNoTlsOK
Definition: XrdCpConfig.hh:171
int Retry
Definition: XrdCpConfig.hh:74