NAME
RLI Operations -
Functions to view and update data managed by a RLI server.
Data Structures
struct globus_rls_sender_info_t
Information about server sending updates to an rli, returned by
globus_rls_client_rli_sender_list().
Functions
globus_result_t globus_rls_client_rli_exists (globus_rls_handle_t *h,
char *key, globus_rls_obj_type_t objtype)
globus_result_t globus_rls_client_rli_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_rli_get_lrc (globus_rls_handle_t *h,
char *lfn, int *offset, int reslimit, globus_list_t **str2_list)
globus_result_t globus_rls_client_rli_get_lrc_bulk (globus_rls_handle_t
*h, globus_list_t *lfnlist, globus_list_t **str2bulk_list)
globus_result_t globus_rls_client_rli_get_lrc_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_rli_sender_list (globus_rls_handle_t
*h, globus_list_t **senderinfo_list)
globus_result_t globus_rls_client_rli_lrc_list (globus_rls_handle_t *h,
globus_list_t **lrcinfo_list)
globus_result_t globus_rls_client_rli_mapping_exists
(globus_rls_handle_t *h, char *lfn, char *lrc)
globus_result_t globus_rls_client_rli_rli_add (globus_rls_handle_t *h,
char *rli_url, char *pattern)
globus_result_t globus_rls_client_rli_rli_delete (globus_rls_handle_t
*h, char *rli_url, char *pattern)
globus_result_t globus_rls_client_rli_rli_get_part (globus_rls_handle_t
*h, char *rli_url, char *pattern, globus_list_t **str2_list)
globus_result_t globus_rls_client_rli_rli_list (globus_rls_handle_t *h,
globus_list_t **rliinfo_list)
Detailed Description
Functions to view and update data managed by a RLI server.
Function Documentation
globus_result_t globus_rls_client_rli_exists (globus_rls_handle_t * h, char
* key, globus_rls_obj_type_t objtype)
Check if an object exists in the RLI database. Parameters:
h Handle connected to an RLS server.
key LFN or LRC that identifies object.
objtype Type of object key refers to (globus_rls_obj_rli_lfn or
globus_rls_obj_rli_lrc).
Return values:
GLOBUS_SUCCESS Object exists.
globus_result_t globus_rls_client_rli_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 RLI database. Parameters:
h Handle connected to an RLS server.
keylist LFNs or LRCs that identify objects.
objtype Type of object key refers to (globus_rls_obj_rli_lfn or
globus_rls_obj_rli_lrc).
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
LRC, and str2.s2 empty, and rc will be the result code indicating
existence.
globus_result_t globus_rls_client_rli_get_lrc (globus_rls_handle_t * h,
char * lfn, int * offset, int reslimit, globus_list_t ** str2_list)
Return LRCs mapped to LFN in the RLI database. Parameters:
h Handle connected to an RLS server.
lfn LFN whose list of LRCs is desired.
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 LRCs that lfn maps to. Each list datum will be a
globus_rls_string2_t structure. s1 will be the LFN, and s2 the LRC
it maps to. str2_list should be freed with
globus_rls_client_free_list().
Return values:
GLOBUS_SUCCESS List of LRCs that map to lfn in str2_list. See Query
Results.
globus_result_t globus_rls_client_rli_get_lrc_bulk (globus_rls_handle_t *
h, globus_list_t * lfnlist, globus_list_t ** str2bulk_list)
Bulk return LRCs mapped to LFN in the RLI 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 LRC it maps to, and rc will be the result code from the
query.
globus_result_t globus_rls_client_rli_get_lrc_wc (globus_rls_handle_t * h,
char * lfn_pattern, globus_rls_pattern_t type, int * offset, int
reslimit, globus_list_t ** str2_list)
Return LRCs mapped to wildcarded LFN in the RLI 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 LRCs that map to lfn_pattern. Each list datum
will be a globus_rls_string2_t. s1 will be the LFN, and s2 the LRC
it maps to. str2_list should be freed with
globus_rls_client_free_list().
Return values:
GLOBUS_SUCCESS List of LRCs that map to lfn_pattern in str2_list.
See Query Results.
globus_result_t globus_rls_client_rli_sender_list (globus_rls_handle_t * h,
globus_list_t ** senderinfo_list)
Get list of servers updating this RLI server. Similar to
globus_rls_client_rli_get_part() except no partition information is
returned.
Parameters:
h Handle connected to an RLS server.
senderinfo_list Datums in senderinfo_list will be of type
globus_rls_sender_info_t. senderinfo_list should be freed with
globus_rls_client_free_list().
Return values:
GLOBUS_SUCCESS List of LRCs updating RLI added to senderinfo_list.
globus_result_t globus_rls_client_rli_lrc_list (globus_rls_handle_t * h,
globus_list_t ** lrcinfo_list)
Deprecated, use globus_rls_client_rli_sender_list(). Parameters:
h Handle connected to an RLS server.
lrcinfo_list Datums in lrcinfo_list will be of type
globus_rls_lrc_info_t. lrcinfo_list should be freed with
globus_rls_client_free_list().
Return values:
GLOBUS_SUCCESS List of LRCs updating RLI added to lrcinfo_list.
globus_result_t globus_rls_client_rli_mapping_exists (globus_rls_handle_t *
h, char * lfn, char * lrc)
Check if a mapping exists in the RLI database. Parameters:
h Handle connected to an RLS server.
lfn LFN of mapping.
lrc LRC of mapping.
Return values:
GLOBUS_SUCCESS Mapping exists.
globus_result_t globus_rls_client_rli_rli_add (globus_rls_handle_t * h,
char * rli_url, char * pattern)
RLI 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.
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 RLI
database.
globus_result_t globus_rls_client_rli_rli_delete (globus_rls_handle_t * h,
char * rli_url, char * pattern)
Delete an entry from the RLI rli/partition tables. Parameters:
h Handle connected to an RLS server.
rli_url URL of RLI server to remove from RLI 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_rli_rli_get_part (globus_rls_handle_t *
h, char * rli_url, char * pattern, globus_list_t ** str2_list)
Get RLI update partitions from RLI 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_rli_rli_list (globus_rls_handle_t * h,
globus_list_t ** rliinfo_list)
Return URLs of RLIs that RLI sends updates to. Parameters:
h Handle connected to an RLS server.
rliinfo_list List of RLIs updated by this RLI 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.