Content-type: text/html Man page of LCG_STMD

LCG_STMD

Section: Library Functions (3)
Updated: $Date: 2008/05/07 12:40:28 $
Index Return to Main Contents

 

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

lcg_stmd get space tokens associated to a space token description, and their metadata
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

 

SEE ALSO

lcg_aa(3), lcg_cp(3), lcg_cr(3), lcg_del(3), lcg_gt(3), lcg_la(3), lcg_lg(3), lcg_ra(3), lcg_rep(3), lcg_rf(3), lcg_sd(3), lcg_stmd(3), lcg_uf(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
NOTE
RETURN VALUE
ERRORS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 14:16:53 GMT, July 14, 2009