lcg_lg(3) - Linux man page

Name

lcg_lg - get the GUID for a given LFN or SURL

Synopsis

#include "lcg_util.h"

int lcg_lg (char *lfn_or_surl, char *vo, char *conf_file, int insecure, char *guid);

int lcg_lgx (char *lfn_or_surl, char *vo, char *conf_file, int insecure, char *guid, char *errbuf, int errbufsz);

int lcg_lg2 (char *lfn_or_surl, int nobdii, char *vo, char *guid, char *errbuf, int errbufsz);

Description

lcg_lg gets the GUID for a given LFN or SURL.

lfn_or_surl: specifies the Logical File Name or the Site URL. An SURL scheme can be sfn: for a classical SE or srm:.
nobdii: If set to a non-zero value, it means that you don't want to make BDII calls to get LFC endpoint. So, you have to define the environment variable 'LFC_HOST'.
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.
guid: specifies a buffer (minimum 37 bytes) to receive the actual guid.
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.
EFAULT: lfn_or_surl, vo or guid is an invalid pointer.
EINVAL: lfn_or_surl 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

Referenced By

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