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