Content-type: text/html
Man page of LCG_CP
LCG_CP
Section: Library Functions (3)
Updated: $Date: 2009/07/09 14:11:41 $
Index
Return to Main Contents
NAME
lcg_cp - copy files from/to/between Storage Element(s),
without registering anything in the file catalog.
SYNOPSIS
#include "lcg_util.h"
int lcg_cp (char *src_file,
char *dest_file,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose);
int lcg_cpt (char *src_file,
char *dest_file,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
int timeout);
int lcg_cpx (char *src_file,
char *dest_file,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
char *errbuf,
int errbufsz);
int lcg_cpxt (char *src_file,
char *dest_file,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *errbuf,
int errbufsz);
int lcg_cp2 (char *src_file,
char *dest_file,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *src_spacetokendesc,
char *dest_spacetokendesc,
char *errbuf,
int errbufsz);
int lcg_cp3 (char *src_file,
char *dest_file,
enum se_typedefaulttype,
enum se_typesrctype,
enum se_typedsttype,
int nobdii,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *src_spacetokendesc,
char *dest_spacetokendesc,
char *errbuf,
int errbufsz);
int lcg_cp4 (char *src_file,
char *dest_file,
enum se_typedefaulttype,
enum se_typesrctype,
enum se_typedsttype,
int nobdii,
char *vo,
int nbstreams,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *src_spacetokendesc,
char *dest_spacetokendesc,
enum gfal_cksm_typecksmtype,
char *errbuf,
int errbufsz);
DESCRIPTION
lcg_cp
copies a Grid file to a local destination, or copie a local file to a SE (without
registering it in a file catalog).
- src_file
-
specifies the source file name: the protocol can be LFN, GUID, SURL, GSIFTP or local
file. An SURL scheme can be
sfn:
for a classical SE or
srm:.
- dest_file
-
specifies the destination. The protocol can be SURL, GSIFTP or local file. An SURL
scheme can be
sfn:
for a classical SE or
srm:.
SURL can be used only if
src_file
is GSIFTP or local file. In that case, the SURL will NOT be registered in a file
catalog.
- defaulttype
-
specifies the default SE type you want to use. Possible values are
TYPE_NONE,
TYPE_SE,
TYPE_SRM,
TYPE_SRMv2,
for respectively no default type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type
is not available for this SE, it will use another type.
- srctype
-
specifies the SE type you want to use for the source file. Possible values are
TYPE_NONE,
TYPE_SE,
TYPE_SRM,
TYPE_SRMv2,
for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type
is not available for this SE, it will fail.
- dsttype
-
specifies the SE type you want to use for the destination file. Possible values are
TYPE_NONE,
TYPE_SE,
TYPE_SRM,
TYPE_SRMv2,
for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type
is not available for this SE, it will fail.
- nobdii
-
If set to a non-zero value, it means that you don't want to make BDII calls to get SE type. So, you must provide the type of the SE
for srm: arguments, and full endpoint in SURLs. For SE type,
defaulttype
can be used (it will be used for both source and destination).
- nbstreams
-
specifies the number of parallel streams (default 1).
- timeout
-
specifies the timeout value (default 0).
- vo
-
specifies the Virtual Organization the user belongs to. If it is
not specified, the environment variable LCG_GFAL_VO will be
used.
- conf_file
-
This argument is actually ignored.
- insecure
-
This argument is actually ignored.
- verbose
-
Verbose level. Here are the possible levels:
-
- 0
-
Only critical errors are displayed on stderr or put into errbuf if not null.
- 1
-
Warnings are displayed on stderr as well as critical errors.
- 2
-
Debug information is displayed as well as warnings and critical errors.
- cksmtype
-
is the checksum type (algorithm) to use. Possible values are:
-
- GFAL_CKSM_NONE
-
No checksum verification
- GFAL_CKSM_CRC32
-
CRC32 algorithm will be used
- GFAL_CKSM_ADLER32
-
Adler32 algorithm will be used
- GFAL_CKSM_MD5
-
MD5 algorithm will be used
- GFAL_CKSM_SHA1
-
SHA-1 algorithm will be used
- errbuf
-
specifies a buffer of size
errbufsz
to receive detailed error messages. If this pointer is
NULL,
the message goes
to stderr. The pointer should not be NULL if the application is a daemon or is
multi-threaded.
- src_spacetokendesc
-
specifies the space token to use with
src_file.
Can be
NULL.
- dest_spacetokendesc
-
specifies the space token to use with
dest_file.
Can be
NULL.
NOTE
The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless
nobdii
is set to a non-zero value.
To use the RLS as catalog instead of the LFC, the environment variable
LCG_CATALOG_TYPE must explicitely be set to "edg". By default, it is set to "lfc".
RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the operation
failed. In the latter case,
errno
is set appropriately.
ERRORS
- ENOENT
-
The named file does not exist.
- EACCES
-
Permission denied.
- EFAULT
-
src_file,
dest_file
or
vo
is an invalid pointer.
- EINVAL
-
src_file
or
dest_file
has an invalid syntax.
- ECOMM
-
Communication error.
- ENAMETOOLONG
-
vo
is too long.
- EPROTONOSUPPORT
-
Access method not supported.
FILES
/opt/lcg/include/lcg_util.h
- /opt/lcg/lib/liblcg_util.so
-
SEE ALSO
lcg_aa(3),
lcg_cp(3),
lcg_cr(3),
lcg_del(3),
lcg_gt(3),
lcg_la(3),
lcg_lg(3),
lcg_lr(3),
lcg_ra(3),
lcg_rep(3),
lcg_rf(3),
lcg_sd(3),
lcg_stmd(3),
lcg_uf(3)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- NOTE
-
- RETURN VALUE
-
- ERRORS
-
- FILES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 14:16:52 GMT, July 14, 2009