Data Structures | |
struct | globus_rls_rli_info_t |
Macros | |
#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) |
Functions to view and update data managed by a LRC server.
#define FRLI_BLOOMFILTER 0x1 |
Update RLI using bloom filters (see globus_rls_client_lrc_rli_add()).
#define MAXURL 256 |
Maximum length of URL string.
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.
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. |
GLOBUS_SUCCESS | Attribute successfully associated with object. |
References globus_rls_client_attr2s(), GLOBUS_RLS_INV_ATTR_TYPE, globus_rls_attribute_t::name, globus_rls_attribute_t::objtype, and globus_rls_attribute_t::type.
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.
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.
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. |
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().
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. |
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.
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. |
GLOBUS_SUCCESS | Attribute definitions successfully retrieved. attr_list should be freed with globus_rls_client_free_list() when it is no longer needed. |
References globus_rls_client_free_list(), GLOBUS_RLS_NOMEMORY, globus_rls_attribute_t::name, globus_rls_attribute_t::objtype, and globus_rls_attribute_t::type.
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.
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. |
GLOBUS_SUCCESS | Attribute successfully modified. |
References globus_rls_client_attr2s(), globus_rls_attribute_t::name, globus_rls_attribute_t::objtype, and globus_rls_attribute_t::type.
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.
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. |
GLOBUS_SUCCESS | Attribute successfully removed. |
References globus_rls_attribute_t::name, and globus_rls_attribute_t::objtype.
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.
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.
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. |
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. |
References globus_rls_client_attr2s(), globus_rls_client_free_list(), GLOBUS_RLS_INV_ATTR_TYPE, and GLOBUS_RLS_NOMEMORY.
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).
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. |
GLOBUS_SUCCESS | Attributes successfully retrieved. attr_list should be freed with globus_rls_client_free_list() when it is no longer needed. |
References globus_rls_client_free_list(), globus_rls_client_s2attr(), GLOBUS_RLS_NOMEMORY, GLOBUS_RLS_SUCCESS, globus_rls_attribute_t::name, and globus_rls_attribute_t::objtype.
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).
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. |
GLOBUS_SUCCESS | Attributes successfully retrieved. attr_obj_list should be freed with globus_rls_client_free_list() when it is no longer needed. |
References globus_rls_handle_t::flags, GLOBUS_RLS_BADARG, globus_rls_client_free_list(), GLOBUS_RLS_NOMEMORY, GLOBUS_RLS_SUCCESS, globus_rls_handle_t::handle, and MAXERRMSG.
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.
h | Handle connected to an RLS server. |
lfn | LFN to add pfn mapping to, should already exist. |
pfn | PFN that lfn should map to. |
GLOBUS_SUCCESS | New mapping created. |
References GLOBUS_RLS_BADARG.
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.
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.
h | Handle connected to an RLS server. |
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.
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. |
GLOBUS_SUCCESS | New mapping created. |
References GLOBUS_RLS_BADARG.
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.
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.
h | Handle connected to an RLS server. |
lfn | LFN to remove mapping from. |
pfn | PFN that lfn maps to that is being removed. |
GLOBUS_SUCCESS | Mapping removed. |
References GLOBUS_RLS_BADARG.
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.
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.
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). |
GLOBUS_SUCCESS | Object exists. |
References GLOBUS_RLS_BADARG.
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.
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.
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. |
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.
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.
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. |
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.
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. |
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.
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.
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. |
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.
h | Handle connected to an RLS server. |
lfn | LFN of mapping. |
pfn | PFN of mapping. |
GLOBUS_SUCCESS | Object exists. |
References GLOBUS_RLS_BADARG.
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.
h | Handle connected to an RLS server. |
oldname | Existing LFN name, to be renamed. |
newname | New LFN name, to replace existing name. |
GLOBUS_SUCCESS | LFN renamed. |
References GLOBUS_RLS_BADARG.
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.
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.
h | Handle connected to an RLS server. |
oldname | Exisintg PFN name, to be renamed. |
newname | New PFN name, to replace existing name. |
GLOBUS_SUCCESS | PFN renamed. |
References GLOBUS_RLS_BADARG.
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.
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.
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. |
GLOBUS_SUCCESS | RLI (with pattern if not NULL) added to LRC database. |
References GLOBUS_RLS_BADARG.
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.
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. |
GLOBUS_SUCCESS | RLI and pattern (if specified) removed from LRC partition table. |
References GLOBUS_RLS_BADARG.
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.
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. |
GLOBUS_SUCCESS | Partition data retrieved from server, written to str2_list. |
References globus_rls_client_free_list(), and GLOBUS_RLS_NOMEMORY.
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.
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. |
GLOBUS_SUCCESS | Info about RLI server successfully retrieved. |
References globus_rls_rli_info_t::flags, GLOBUS_RLS_BADARG, globus_rls_rli_info_t::lastupdate, MAXURL, globus_rls_rli_info_t::updateinterval, and globus_rls_rli_info_t::url.
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.
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. |
GLOBUS_SUCCESS | List of RLIs updated by this LRC returned in rliinfo_list. |
References globus_rls_rli_info_t::flags, globus_rls_client_free_list(), GLOBUS_RLS_NOMEMORY, globus_rls_rli_info_t::lastupdate, MAXURL, globus_rls_rli_info_t::updateinterval, and globus_rls_rli_info_t::url.
about globus |
globus toolkit |
dev.globus
Comments? webmaster@globus.org