lcg_la_python(3) - Linux man page

Name

lcg_la - get the list of aliases for a given LFN, GUID or SURL

Synopsis

import lcg_util

(int returncode, listOfString lfns, string errmsg ) lcg_lax (string file, string vo, string conf_file, int insecure, listOfString lfns)

(int returncode, listOfString lfns, string errmsg ) lcg_la2 (string file, int nobdii, string vo, listOfString lfns)

Description

lcg_la gets the list of aliases for a given LFN, GUID or SURL.

file: specifies the Logical File Name, the Grid Unique IDentifier 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.
lfns: will be set by the routine to the address of the array of pointers to the aliases. The application should free both the logical file names and the array of pointers.

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: file, vo or lfns is an invalid pointer.
EINVAL: file has an invalid syntax.
ECOMM: Communication error.
ENAMETOOLONG: vo is too long.
EPROTONOSUPPORT: Access method not supported.