Content-type: text/html
Man page of LCG_RF
LCG_RF
Section: Library Functions (3)
Updated: $Date: 2008/12/18 18:04:43 $
Index
Return to Main Contents
NAME
lcg_rf - register in the LRC (and optionally in the RMC) or the LFC a file residing on an SE
SYNOPSIS
import lcg_util
(int returncode,
string errmsg
) lcg_rf3 (string surl,
string guid,
string lfn,
string defaulttype,
string setype,
int nobdii,
string vo,
string conf_file,
int insecure,
int verbose,
int timeout,
string actual_gid);
DESCRIPTION
lcg_rf
registers in the LRC (and optionally in the RMC) or the LFC a file residing on an SE.
- surl
-
specifies the site URL of the file to be registered. The scheme can be
sfn:
for a classical SE or
srm:.
- guid
-
specifies the Grid Unique IDentifier. If NULL, a GUID is generated internally.
- lfn
-
specifies the Logical File Name associated with the file. If not NULL, an
entry is added to the Replica Metadata Catalog or the LFC.
- defaulttype
-
specifies the default SE type you want to use. Possible values are
none,
se,
srmv1,
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.
- setype
-
specifies the SE type you want to use for the SURL. Possible values are
none,
se,
srmv1,
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).
- 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 currently ignored.
- insecure
-
This argument is currently ignored.
The access to the Replica Catalog or the LFC is done according to the endpoints published
in MDS.
- timeout
-
specifies the value of timeout (default 0).
- actual_guid
-
specifies a buffer (minimum 37 bytes) to receive the actual guid.
This pointer can be NULL. In that case the actual guid is not returned.
- verbose
-
Verbose level. Here are the possible levels:
-
- 0
-
Only critical errors are put into errmsg.
- 1
-
Warnings are displayed on stderr as well as critical errors.
- 2
-
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
-
surl
or
vo
is an invalid pointer.
- EINVAL
-
surl
or
guid
is invalid.
- ECOMM
-
Communication error.
- ENAMETOOLONG
-
lfn
or
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- NOTE
-
- RETURN VALUE
-
- ERRORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 14:16:53 GMT, July 14, 2009