NAME
LRC Operations -
Functions to view and update data managed by a LRC server.
Data Structures
struct globus_rls_rli_info_t
Information about RLI server, returned by
globus_rls_client_lrc_rli_info() and
globus_rls_client_lrc_rli_list().
Defines
#define FRLI_BLOOMFILTER 0x1
#define MAXURL 256
Functions
globus_result_t globus_rls_client_lrc_attr_add (globus_rls_handle_t *h,
char *key, globus_rls_attribute_t *attr)
globus_result_t globus_rls_client_lrc_attr_add_bulk
(globus_rls_handle_t *h, globus_list_t *attr_obj_list,
globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_attr_create (globus_rls_handle_t
*h, char *name, globus_rls_obj_type_t objtype,
globus_rls_attr_type_t type)
globus_result_t globus_rls_client_lrc_attr_delete (globus_rls_handle_t
*h, char *name, globus_rls_obj_type_t objtype, globus_bool_t
clearvalues)
globus_result_t globus_rls_client_lrc_attr_get (globus_rls_handle_t *h,
char *name, globus_rls_obj_type_t objtype, globus_list_t
**attr_list)
globus_result_t globus_rls_client_lrc_attr_modify (globus_rls_handle_t
*h, char *key, globus_rls_attribute_t *attr)
globus_result_t globus_rls_client_lrc_attr_remove (globus_rls_handle_t
*h, char *key, globus_rls_attribute_t *attr)
globus_result_t globus_rls_client_lrc_attr_remove_bulk
(globus_rls_handle_t *h, globus_list_t *attr_obj_list,
globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_attr_search (globus_rls_handle_t
*h, char *name, globus_rls_obj_type_t objtype, globus_rls_attr_op_t
op, globus_rls_attribute_t *operand1, globus_rls_attribute_t
*operand2, int *offset, int reslimit, globus_list_t
**attr_obj_list)
globus_result_t globus_rls_client_lrc_attr_value_get
(globus_rls_handle_t *h, char *key, char *name,
globus_rls_obj_type_t objtype, globus_list_t **attr_list)
globus_result_t globus_rls_client_lrc_attr_value_get_bulk
(globus_rls_handle_t *h, globus_list_t *keylist, char *name,
globus_rls_obj_type_t objtype, globus_list_t **attr_obj_list)
globus_result_t globus_rls_client_lrc_add (globus_rls_handle_t *h, char
*lfn, char *pfn)
globus_result_t globus_rls_client_lrc_add_bulk (globus_rls_handle_t *h,
globus_list_t *str2_list, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_clear (globus_rls_handle_t *h)
globus_result_t globus_rls_client_lrc_create (globus_rls_handle_t *h,
char *lfn, char *pfn)
globus_result_t globus_rls_client_lrc_create_bulk (globus_rls_handle_t
*h, globus_list_t *str2_list, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_delete (globus_rls_handle_t *h,
char *lfn, char *pfn)
globus_result_t globus_rls_client_lrc_delete_bulk (globus_rls_handle_t
*h, globus_list_t *str2_list, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_exists (globus_rls_handle_t *h,
char *key, globus_rls_obj_type_t objtype)
globus_result_t globus_rls_client_lrc_exists_bulk (globus_rls_handle_t
*h, globus_list_t *keylist, globus_rls_obj_type_t objtype,
globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_get_lfn (globus_rls_handle_t *h,
char *pfn, int *offset, int reslimit, globus_list_t **str2_list)
globus_result_t globus_rls_client_lrc_get_lfn_bulk (globus_rls_handle_t
*h, globus_list_t *pfnlist, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_get_lfn_wc (globus_rls_handle_t
*h, char *pfn_pattern, globus_rls_pattern_t type, int *offset, int
reslimit, globus_list_t **str2_list)
globus_result_t globus_rls_client_lrc_get_pfn (globus_rls_handle_t *h,
char *lfn, int *offset, int reslimit, globus_list_t **str2_list)
globus_result_t globus_rls_client_lrc_get_pfn_bulk (globus_rls_handle_t
*h, globus_list_t *lfnlist, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_lrc_get_pfn_wc (globus_rls_handle_t
*h, char *lfn_pattern, globus_rls_pattern_t type, int *offset, int
reslimit, globus_list_t **str2_list)
globus_result_t globus_rls_client_lrc_mapping_exists
(globus_rls_handle_t *h, char *lfn, char *pfn)
globus_result_t globus_rls_client_lrc_renamelfn (globus_rls_handle_t
*h, char *oldname, char *newname)
globus_result_t globus_rls_client_lrc_renamelfn_bulk
(globus_rls_handle_t *h, globus_list_t *str2_list, globus_list_t
**str2bulk_list)
globus_result_t globus_rls_client_lrc_renamepfn (globus_rls_handle_t
*h, char *oldname, char *newname)
globus_result_t globus_rls_client_lrc_renamepfn_bulk
(globus_rls_handle_t *h, globus_list_t *str2_list, globus_list_t
**str2bulk_list)
globus_result_t globus_rls_client_lrc_rli_add (globus_rls_handle_t *h,
char *rli_url, int flags, char *pattern)
globus_result_t globus_rls_client_lrc_rli_delete (globus_rls_handle_t
*h, char *rli_url, char *pattern)
globus_result_t globus_rls_client_lrc_rli_get_part (globus_rls_handle_t
*h, char *rli_url, char *pattern, globus_list_t **str2_list)
globus_result_t globus_rls_client_lrc_rli_info (globus_rls_handle_t *h,
char *rli_url, globus_rls_rli_info_t *info)
globus_result_t globus_rls_client_lrc_rli_list (globus_rls_handle_t *h,
globus_list_t **rliinfo_list)
Detailed Description
Functions to view and update data managed by a LRC server.
Define Documentation
#define FRLI_BLOOMFILTER 0x1
Update RLI using bloom filters (see globus_rls_client_lrc_rli_add()).
#define MAXURL 256
Maximum length of URL string.
Function Documentation
globus_result_t globus_rls_client_lrc_attr_add (globus_rls_handle_t * h,
char * key, globus_rls_attribute_t * attr)
Add an attribute to an object in the LRC database. Parameters:
h Handle connected to an RLS server.
key Logical or Physical File Name (LFN or PFN) that identifies
object attribute should be added to.
attr Attribute to be added to object. name, objtype, type and val
should be set in attr.
Return values:
GLOBUS_SUCCESS Attribute successfully associated with object.
globus_result_t globus_rls_client_lrc_attr_add_bulk (globus_rls_handle_t *
h, globus_list_t * attr_obj_list, globus_list_t ** str2bulk_list)
Bulk add attributes to objects in the LRC database. Parameters:
h Handle connected to an RLS server.
attr_obj_list List of object names (LFN or PFN) and attributes to
be added. Each list datum should be of type
globus_rls_attribute_object_t.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the oject
name, str2.s2 the attribute name, and rc will be the result code
from the failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_attr_create (globus_rls_handle_t * h,
char * name, globus_rls_obj_type_t objtype, globus_rls_attr_type_t
type)
Define new attribute in LRC database. Parameters:
h Handle connected to an LRC server.
name Name of attribute.
objtype Object (LFN or PFN) type that attribute applies to.
type Type of attribute value.
Return values:
GLOBUS_SUCCESS Attribute successfully created.
globus_result_t globus_rls_client_lrc_attr_delete (globus_rls_handle_t * h,
char * name, globus_rls_obj_type_t objtype, globus_bool_t clearvalues)
Undefine attribute in LRC database, previously created with
globus_rls_client_lrc_attr_create(). Parameters:
h Handle connected to an LRC server.
name Name of attribute.
objtype Object (LFN or PFN) type that attribute applies to.
clearvalues If GLOBUS_TRUE then any any values for this attribute
are first removed from the objects they’re associated with. If
GLOBUS_FALSE and any values exist then GLOBUS_RLS_ATTR_EXIST is
returned.
Return values:
GLOBUS_SUCCESS Attribute successfully removed.
globus_result_t globus_rls_client_lrc_attr_get (globus_rls_handle_t * h,
char * name, globus_rls_obj_type_t objtype, globus_list_t ** attr_list)
Return definitions of attributes in LRC database. Parameters:
h Handle connected to an RLS server.
name Name of attribute. If name is NULL all attributes of the
specified objtype are returned.
objtype Object (LFN or PFN) type that attribute applies to.
attr_list Any attribute definitions found will be returned as a
list of globus_rls_attribute_t structures.
Return values:
GLOBUS_SUCCESS Attribute definitions successfully retrieved.
attr_list should be freed with globus_rls_client_free_list() when
it is no longer needed.
globus_result_t globus_rls_client_lrc_attr_modify (globus_rls_handle_t * h,
char * key, globus_rls_attribute_t * attr)
Modify an attribute value. Parameters:
h Handle connected to an RLS server.
key Name of object (LFN or PFN).
attr Attribute to be modified. The objtype , name and type fields
should be set in attr to identify the attribute, the val field
should be the new value.
Return values:
GLOBUS_SUCCESS Attribute successfully modified.
globus_result_t globus_rls_client_lrc_attr_remove (globus_rls_handle_t * h,
char * key, globus_rls_attribute_t * attr)
Remove an attribute from an object (LFN or PFN) in the LRC database.
Parameters:
h Handle connected to an RLS server.
key Name of object (LFN or PFN).
attr Attribute to be removed. The objtype and name fields should
be set in attr to identify the attribute.
Return values:
GLOBUS_SUCCESS Attribute successfully removed.
globus_result_t globus_rls_client_lrc_attr_remove_bulk (globus_rls_handle_t
* h, globus_list_t * attr_obj_list, globus_list_t ** str2bulk_list)
Bulk remove attributes from objects in the LRC database. Parameters:
h Handle connected to an RLS server.
attr_obj_list List of object names (LFN or PFN) and attributes to
be removed. It is not necessary to set the attribute type or value.
Each list datum should be of type globus_rls_attribute_object_t.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the oject
name, str2.s2 the attribute name, and rc will be the result code
from the failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_attr_search (globus_rls_handle_t * h,
char * name, globus_rls_obj_type_t objtype, globus_rls_attr_op_t op,
globus_rls_attribute_t * operand1, globus_rls_attribute_t * operand2,
int * offset, int reslimit, globus_list_t ** attr_obj_list)
Search for objects (LFNs or PFNs) in a LRC database that have the
specified attribute whose value matches a boolean expression.
Parameters:
h Handle connected to an RLS server.
name Name of attribute.
objtype Object (LFN or PFN) type that attribute applies to.
op Operator to be used in searching for values.
operand1 First operand in boolean expression. type and val should
be set in globus_rls_attribute_t.
operand2 Second operand in boolean expression, only used when op is
globus_rls_client_attr_op_btw. type and val should be set in
globus_rls_attribute_t.
offset Offset into result list. Used in conjunction with reslimit
to retrieve results a few at a time. Use 0 to begin with first
result. If NULL then API will handle accumulating partial results
transparently.
reslimit Maximum number of results to return. Used in conjunction
with offset to retrieve results a few at a time. Use 0 to retrieve
all results.
attr_obj_list Any objects with the specified attribute will be
returned, with the attribute value, in a list of
globus_rls_attribute_object_t structures.
Return values:
GLOBUS_SUCCESS Objects with specified attribute returned in
attr_obj_list. attr_obj_list should be freed with
globus_rls_client_free_list() when it is no longer needed. See
Query Results.
globus_result_t globus_rls_client_lrc_attr_value_get (globus_rls_handle_t *
h, char * key, char * name, globus_rls_obj_type_t objtype,
globus_list_t ** attr_list)
Return attributes in LRC database for specified object (LFN or PFN).
Parameters:
h Handle connected to an RLS server.
key Logical or Physical File Name (LFN or PFN) that identifies
object attributes should be retrieved for.
name Name of attribute to retrieve. If NULL all attributes for key,
objtype are returned.
objtype Object (LFN or PFN) type that attribute applies to.
attr_list Any attributes found will be returned in this list of
globus_rls_attribute_t structures.
Return values:
GLOBUS_SUCCESS Attributes successfully retrieved. attr_list should
be freed with globus_rls_client_free_list() when it is no longer
needed.
globus_result_t globus_rls_client_lrc_attr_value_get_bulk
(globus_rls_handle_t * h, globus_list_t * keylist, char * name,
globus_rls_obj_type_t objtype, globus_list_t ** attr_obj_list)
Return attributes in LRC database for specified objects (LFN or PFN).
Parameters:
h Handle connected to an RLS server.
keylist Logical or Physical File Names (LFNs or PFNs) that identify
object attributes should be retrieved for. Each list datum should
be a string containing the LFN or PFN.
name Name of attribute to retrieve. If NULL all attributes for key,
objtype are returned.
objtype Object (LFN or PFN) type that attribute applies to.
attr_obj_list Any attributes found will be returned in this list of
globus_rls_attribute_object_t structures.
Return values:
GLOBUS_SUCCESS Attributes successfully retrieved. attr_obj_list
should be freed with globus_rls_client_free_list() when it is no
longer needed.
globus_result_t globus_rls_client_lrc_add (globus_rls_handle_t * h, char *
lfn, char * pfn)
Add mapping to PFN to an existing LFN. Parameters:
h Handle connected to an RLS server.
lfn LFN to add pfn mapping to, should already exist.
pfn PFN that lfn should map to.
Return values:
GLOBUS_SUCCESS New mapping created.
globus_result_t globus_rls_client_lrc_add_bulk (globus_rls_handle_t * h,
globus_list_t * str2_list, globus_list_t ** str2bulk_list)
Bulk add LFN,PFN mappings in LRC database. LFNs must already exist.
Parameters:
h Handle connected to an RLS server.
str2_list LFN,PFN pairs to add mappings.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN, and
str2.s2 the PFN it maps to, and rc will be the result code from the
failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_clear (globus_rls_handle_t * h)
Clear all mappings from LRC database. User needs both ADMIN and
LRCUPDATE privileges to perform this operation. Note that if the LRC is
cleared this will not be reflected in any RLI servers updated by the
LRC until the next softstate update, even if immediate updates are
enabled.
Parameters:
h Handle connected to an RLS server.
Return values:
GLOBUS_SUCCESS Mappings cleared.
globus_result_t globus_rls_client_lrc_create (globus_rls_handle_t * h, char
* lfn, char * pfn)
Create mapping between a LFN and PFN. LFN should not exist yet.
Parameters:
h Handle connected to an RLS server.
lfn LFN to add pfn mapping to, should not already exist.
pfn PFN that lfn should map to.
Return values:
GLOBUS_SUCCESS New mapping created.
globus_result_t globus_rls_client_lrc_create_bulk (globus_rls_handle_t * h,
globus_list_t * str2_list, globus_list_t ** str2bulk_list)
Bulk create LFN,PFN mappings in LRC database. Parameters:
h Handle connected to an RLS server.
str2_list LFN,PFN pairs to create mappings for.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN, and
str2.s2 the PFN it maps to, and rc will be the result code from the
failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_delete (globus_rls_handle_t * h, char
* lfn, char * pfn)
Delete mapping between LFN and PFN. Parameters:
h Handle connected to an RLS server.
lfn LFN to remove mapping from.
pfn PFN that lfn maps to that is being removed.
Return values:
GLOBUS_SUCCESS Mapping removed.
globus_result_t globus_rls_client_lrc_delete_bulk (globus_rls_handle_t * h,
globus_list_t * str2_list, globus_list_t ** str2bulk_list)
Bulk delete LFN,PFN mappings in LRC database. Parameters:
h Handle connected to an RLS server.
str2_list LFN,PFN pairs to add mappings.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN, and
str2.s2 the PFN it maps to, and rc will be the result code from the
failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_exists (globus_rls_handle_t * h, char
* key, globus_rls_obj_type_t objtype)
Check if an object exists in the LRC database. Parameters:
h Handle connected to an RLS server.
key LFN or PFN that identifies object.
objtype Type of object key refers to (globus_rls_obj_lrc_lfn or
globus_rls_obj_lrc_pfn).
Return values:
GLOBUS_SUCCESS Object exists.
globus_result_t globus_rls_client_lrc_exists_bulk (globus_rls_handle_t * h,
globus_list_t * keylist, globus_rls_obj_type_t objtype, globus_list_t
** str2bulk_list)
Bulk check if objects exist in the LRC database. Parameters:
h Handle connected to an RLS server.
keylist LFNs or PFNs that identify objects.
objtype Type of object key refers to (globus_rls_obj_lrc_lfn or
globus_rls_obj_lrc_pfn).
str2bulk_list Results of existence check. Each list datum will be a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN or
PFN, and str2.s2 empty, and rc will be the result code indicating
existence.
globus_result_t globus_rls_client_lrc_get_lfn (globus_rls_handle_t * h,
char * pfn, int * offset, int reslimit, globus_list_t ** str2_list)
Return LFNs mapped to PFN in the LRC database. Parameters:
h Handle connected to an RLS server.
pfn PFN to search for.
offset Offset into result list. Used in conjunction with reslimit
to retrieve results a few at a time. Use 0 to begin with first
result. If NULL then API will handle accumulating partial results
transparently.
reslimit Maximum number of results to return. Used in conjunction
with offset to retrieve results a few at a time. Use 0 to retrieve
all results.
str2_list List of LFNs that map to pfn. Each list datum will be a
globus_rls_string2_t structure. s1 will be the LFN, and s2 the PFN
it maps to.
Return values:
GLOBUS_SUCCESS List of LFNs that map to pfn in str2_list. See Query
Results.
globus_result_t globus_rls_client_lrc_get_lfn_bulk (globus_rls_handle_t *
h, globus_list_t * pfnlist, globus_list_t ** str2bulk_list)
Bulk return LFNs mapped to PFN in the LRC database. Parameters:
h Handle connected to an RLS server.
pfnlist PFNs to search for.
str2bulk_list Results of queries. Each list datum will be a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN, and
str2.s2 the PFN it maps to, and rc will be the result code from the
query.
globus_result_t globus_rls_client_lrc_get_lfn_wc (globus_rls_handle_t * h,
char * pfn_pattern, globus_rls_pattern_t type, int * offset, int
reslimit, globus_list_t ** str2_list)
Return LFNs mapped to wildcarded PFN in the LRC database. Parameters:
h Handle connected to an RLS server.
pfn_pattern PFN pattern to search for.
type Identifies wildcard characters used in pfn_pattern. Wildcard
chars can be Unix file globbing chars (* matches 0 or more
characters, ? matches any single character) or SQL ’like’ wildcard
characters (% matches 0 or more charactes, _ matches any single
character).
offset Offset into result list. Used in conjunction with reslimit
to retrieve results a few at a time. Use 0 to begin with first
result. If NULL then the API will handle accumulating partial
results transparently.
reslimit Maximum number of results to return. Used in conjunction
with offset to retrieve results a few at a time. Use 0 to retrieve
all results.
str2_list List of LFNs that map to pfn_pattern. Each list datum
will be a globus_rls_string2_t structure. s1 will be the LFN, and
s2 the PFN it maps to.
Return values:
GLOBUS_SUCCESS List of LFNs that map to pfn_pattern in str2_list.
See Query Results.
globus_result_t globus_rls_client_lrc_get_pfn (globus_rls_handle_t * h,
char * lfn, int * offset, int reslimit, globus_list_t ** str2_list)
Return PFNs mapped to LFN in the LRC database. Parameters:
h Handle connected to an RLS server.
lfn LFN to search for.
offset Offset into result list. Used in conjunction with reslimit
to retrieve results a few at a time. Use 0 to begin with first
result.
reslimit Maximum number of results to return. Used in conjunction
with offset to retrieve results a few at a time. Use 0 to retrieve
all results.
str2_list List of PFNs that map to lfn. Each list datum will be a
globus_rls_string2_t structure. s1 will be the LFN, and s2 the PFN
it maps to.
Return values:
GLOBUS_SUCCESS List of PFNs that map to lfn in str2_list.
globus_result_t globus_rls_client_lrc_get_pfn_bulk (globus_rls_handle_t *
h, globus_list_t * lfnlist, globus_list_t ** str2bulk_list)
Bulk return PFNs mapped to LFN in the LRC database. Parameters:
h Handle connected to an RLS server.
lfnlist LFNs to search for.
str2bulk_list Results of queries. Each list datum will be a
globus_rls_string2_bulk_t structure. str2.s1 will be the LFN, and
str2.s2 the PFN it maps to, and rc will be the result code from the
query.
globus_result_t globus_rls_client_lrc_get_pfn_wc (globus_rls_handle_t * h,
char * lfn_pattern, globus_rls_pattern_t type, int * offset, int
reslimit, globus_list_t ** str2_list)
Return PFNs mapped to wildcarded LFN in the LRC database. Parameters:
h Handle connected to an RLS server.
lfn_pattern LFN pattern to search for.
type Identifies wildcard characters used in lfn_pattern. Wildcard
chars can be Unix file globbing chars (* matches 0 or more
characters, ? matches any single character) or SQL ’like’ wildcard
characters (% matches 0 or more charactes, _ matches any single
character).
offset Offset into result list. Used in conjunction with reslimit
to retrieve results a few at a time. Use 0 to begin with first
result.
reslimit Maximum number of results to return. Used in conjunction
with offset to retrieve results a few at a time. Use 0 to retrieve
all results.
str2_list List of PFNs that map to lfn_pattern. Each list datum
will be a globus_rls_string2_t structure. s1 will be the LFN, and
s2 the PFN it maps to.
Return values:
GLOBUS_SUCCESS List of PFNs that map to lfn_pattern in str2_list.
See Query Results.
globus_result_t globus_rls_client_lrc_mapping_exists (globus_rls_handle_t *
h, char * lfn, char * pfn)
Check if a mapping exists in the LRC database. Parameters:
h Handle connected to an RLS server.
lfn LFN of mapping.
pfn PFN of mapping.
Return values:
GLOBUS_SUCCESS Object exists.
globus_result_t globus_rls_client_lrc_renamelfn (globus_rls_handle_t * h,
char * oldname, char * newname)
Rename LFN. If immediate mode is ON, the LRC will send update messages
to associated RLIs.
Parameters:
h Handle connected to an RLS server.
oldname Existing LFN name, to be renamed.
newname New LFN name, to replace existing name.
Return values:
GLOBUS_SUCCESS LFN renamed.
globus_result_t globus_rls_client_lrc_renamelfn_bulk (globus_rls_handle_t *
h, globus_list_t * str2_list, globus_list_t ** str2bulk_list)
Bulk rename LFN names in LRC database. LFNs must already exist. If
immediate mode is ON, the LRC will send update messages to associated
RLIs.
Parameters:
h Handle connected to an RLS server.
str2_list oldname,newname pairs such that newname replaces oldname
for LFNs.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the old LFN
name, and str2.s2 the new LFN name, and rc will be the result code
from the failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_renamepfn (globus_rls_handle_t * h,
char * oldname, char * newname)
Rename PFN. Parameters:
h Handle connected to an RLS server.
oldname Exisintg PFN name, to be renamed.
newname New PFN name, to replace existing name.
Return values:
GLOBUS_SUCCESS PFN renamed.
globus_result_t globus_rls_client_lrc_renamepfn_bulk (globus_rls_handle_t *
h, globus_list_t * str2_list, globus_list_t ** str2bulk_list)
Bulk rename PFN names in LRC database. PFNs must already exist.
Parameters:
h Handle connected to an RLS server.
str2_list oldname,newname pairs such that newname replaces oldname
for PFNs.
str2bulk_list List of failed updates. Each list datum is a
globus_rls_string2_bulk_t structure. str2.s1 will be the old PFN
name, and str2.s2 the new PFN name, and rc will be the result code
from the failed update. Only failed updates will be returned.
globus_result_t globus_rls_client_lrc_rli_add (globus_rls_handle_t * h,
char * rli_url, int flags, char * pattern)
LRC servers send information about LFNs in their database to the the
list of RLI servers in the database, added with the following function.
Updates may be partitioned amongst multiple RLIs by specifying one or
more patterns for an RLI.
Parameters:
h Handle connected to an RLS server.
rli_url URL of RLI server that LRC should send updates to.
flags Should be zero or FRLI_BLOOMFILTER.
pattern If not NULL used to filter which LFNs are sent to rli_url.
Standard Unix wildcard characters (*, ?) may be used to do wildcard
matches.
Return values:
GLOBUS_SUCCESS RLI (with pattern if not NULL) added to LRC
database.
globus_result_t globus_rls_client_lrc_rli_delete (globus_rls_handle_t * h,
char * rli_url, char * pattern)
Delete an entry from the LRC rli/partition tables. Parameters:
h Handle connected to an RLS server.
rli_url URL of RLI server to remove from LRC partition table.
pattern If not NULL then only the specific rli_url/pattern is
removed, else all partition information for rli_url is removed.
Return values:
GLOBUS_SUCCESS RLI and pattern (if specified) removed from LRC
partition table.
globus_result_t globus_rls_client_lrc_rli_get_part (globus_rls_handle_t *
h, char * rli_url, char * pattern, globus_list_t ** str2_list)
Get RLI update partitions from LRC server. Parameters:
h Handle connected to an RLS server.
rli_url If not NULL identifies RLI that partition data will be
retrieved for. If NULL then all RLIs are retrieved.
pattern If not NULL returns only partitions with matching patterns,
otherwise all patterns are retrieved.
str2_list Results added to list. Datums in str2_list are of type
globus_rls_string2_t structure. s1 will be the rli url, s2 an empty
string or the pattern used to partition updates. See Query Results.
Return values:
GLOBUS_SUCCESS Partition data retrieved from server, written to
str2_list.
globus_result_t globus_rls_client_lrc_rli_info (globus_rls_handle_t * h,
char * rli_url, globus_rls_rli_info_t * info)
Get info about RLI server updated by an LRC server. Parameters:
h Handle connected to an RLS server.
rli_url URL of RLI server to retrieve info for.
info Data about RLI server will be written here.
Return values:
GLOBUS_SUCCESS Info about RLI server successfully retrieved.
globus_result_t globus_rls_client_lrc_rli_list (globus_rls_handle_t * h,
globus_list_t ** rliinfo_list)
Return URLs of RLIs that LRC sends updates to. Parameters:
h Handle connected to an RLS server.
rliinfo_list List of RLIs updated by this LRC returned in this
list. Each list datum is of type globus_rls_rli_info_t.
rliinfo_list should be freed with globus_rls_client_free_list()
when no longer needed.
Return values:
GLOBUS_SUCCESS List of RLIs updated by this LRC returned in
rliinfo_list.
Author
Generated automatically by Doxygen for globus rls client from the
source code.