lcg_rf(3) - Linux man page

Name

LFC a file residing on an SE

Synopsis

int lcg_rf (char *surl, char *guid, char *lfn, char *vo, char *conf_file, int insecure, int verbose, char *actual_gid);

int lcg_rft (char *surl, char *guid, char *lfn, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *actual_gid);

int lcg_rfx (char *surl, char *guid, char *lfn, char *vo, char *conf_file, int insecure, int verbose, char *actual_gid, char *errbuf, int errbufsz);

int lcg_rfxt (char *surl, char *guid, char *lfn, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *actual_gid, char *errbuf, int errbufsz);

int lcg_rf3 (char *surl, char *guid, char *lfn, enum se_typedefaulttype, enum se_typesetype, int nobdii, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *actual_gid, char *errbuf, int errbufsz);

Description

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 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.

setype

specifies the SE type you want to use for the SURL. 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).

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).

verbose

Verbose level. Here are the possible levels:

• Only critical errors are displayed on stderr or put into errbuf if not null.
• Warnings are displayed on stderr as well as critical errors.
• Debug information is displayed as well as warnings and critical errors.

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.

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.

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.

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)

Referenced By

lcg_get_checksum(3), lcg_get_checksum_python(3), lcg_set_transfer_callback(3)