lcg_stmd(3) - Linux man page
Name
lcg_stmd - get space tokens associated to a space token description,and their metadata
Synopsis
#include "lcg_util.h"int lcg_stmd (char *spacetokendesc, char *endpoint, int *nbtokens, gfal_spacemd **spacemd, int nobdii, int timeout, char *errbuf, int errbufsz);
Description
- spacetokendesc
- the space token description whom you want to get metadata.
- endpoint
- the endpoint of the SE where the spacetokendesc is defined. Note that as only SRMv2 supports space tokens the endpoint must be SRMv2-compliant.
- nbtokens
- a pointer to an integer, where will be stored the number of space tokens associated with spacetokendesc.
- spacemd
- a pointer to a table of 'gfal_spacemd' objects, where will be stored metadata of each space tokens associated to spacetokendesc. Note that the memory will be allocated by the function itself, but it's up to the user to free it.
- 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 full (SRMv2) endpoint.
- timeout
- specifies the value of timeout (default 0).
- 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
Only SRMv2 supports space tokens, so this function is compatible with SRMv2 endpoints only. The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless nobdii is set to a non-zero value.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
- EINVAL
- At least one of the arguments is not correct.
- ENOMEM
- Memory problem, maybe not enough free memory.
- ECOMM
- Communication error.
Files
/opt/lcg/include/lcg_util.h- /opt/lcg/lib/liblcg_util.so