lcg_cp_python(3) - Linux man page

Name

lcg_cp - copy files from/to/between Storage Element(s), without registering anything in the file catalog.

Synopsis

import lcg_util

(int returncode, string errmsg ) lcg_cp3 (string src_file, string dest_file, string defaulttype, string srctype, string dsttype, int nobdii, string vo, int nbstreams, string conf_file, int insecure, int verbose, int timeout, string src_spacetokendesc, string dest_spacetokendesc);

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. But if according to the BDII the default type is not available for this SE, it will use another type. Possible values are:
lcg_util.TYPE_NONE or 'none'
No default type
lcg_util.TYPE_SE or 'se'
Use classic SE endpoints
lcg_util.TYPE_SRM or 'srmv1'
Use SRMv1 endpoints first
lcg_util.TYPE_SRMv2 or 'srmv2'
Use SRMv2 endpoints first
srctype
specifies the SE type you want to use for the source file. But if according to the BDII the default type is not available for this SE, it will fail. Possible values are:
lcg_util.TYPE_NONE or 'none'
No default type
lcg_util.TYPE_SE or 'se'
Use classic SE endpoints
lcg_util.TYPE_SRM or 'srmv1'
Use SRMv1 endpoints first
lcg_util.TYPE_SRMv2 or 'srmv2'
Use SRMv2 endpoints first
dsttype
specifies the SE type you want to use for the destination file. But if according to the BDII the default type is not available for this SE, it will fail. Possible values are:
lcg_util.TYPE_NONE or 'none'
No default type
lcg_util.TYPE_SE or 'se'
Use classic SE endpoints
lcg_util.TYPE_SRM or 'srmv1'
Use SRMv1 endpoints first
lcg_util.TYPE_SRMv2 or 'srmv2'
Use SRMv2 endpoints first
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.
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.
verbose
Verbose level. Here are the possible levels:
  • Only critical errors are put into errmsg.
  • Warnings are displayed on stderr as well as critical errors.
  • Debug information is displayed as well as warnings and critical errors.

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.

See Also

lcg_aa_python(3), lcg_cp_python(3), lcg_cr_python(3), lcg_del_python(3), lcg_gt_python(3), lcg_la_python(3), lcg_lg_python(3), lcg_lr_python(3), lcg_ra_python(3), lcg_rep_python(3), lcg_rf_python(3), lcg_sd_python(3), lcg_stmd_python(3), lcg_uf_python(3)