globus_rls_client_queryresult(3) [debian man page]
Query Results(3) globus rls client Query Results(3) NAME
Query Results - Data Structures struct globus_rls_attribute_object_t globus_rls_client_lrc_attr_search() returns a list of these structures which include the object name (LFN or PFN) and attribute value found by the query. struct globus_rls_string2_t String pair result. struct globus_rls_string2_bulk_t String pair result with return code, returned by bulk query operations. Functions globus_result_t globus_rls_client_free_list (globus_list_t *list) Detailed Description List results are returned as globus_list_t's, list datums depend on the type of query (eg globus_rls_string2_t, globus_rls_attribute_t, etc). A list result should be freed with globus_rls_client_free_list() when it's no longer needed. RLS supports limiting the number of results returned by a single query using an offset and reslimit. The offset specifies which result to begin with, reslimit specifies how many results to return. Offset should begin at 0 to retrieve all records. If reslimit is 0 then all results are returned at once, unless the server has a limit on results configured. If NULL is passed as the offset argument then the API will repeatedly call the query function until are results are retrieved. The following are equivalent examples of how to print the lfn,pfn pairs returned by globus_rls_client_lrc_get_lfn(): globus_list_t *str2_list; globus_list_t *p; globus_rls_string2_t *str2; // Retrieve all results, API will handle looping through partial results // if the server has a limit configured. Error handling has been omitted. globus_rls_client_lrc_get_lfn(h, "somepfn", NULL, 0, &str2_list); for (p = str2_list; p; p = globus_list_rest(p)) { str2 = (globus_rls_string2_t *) globus_list_first(p); printf("lfn: %s pfn:%s0, str2->s1, str2->s2); } globus_rls_client_free_list(str2_list); // This code fragment retrieves results 5 at a time. Note offset is set // to -1 when the server has no more results to return. int offset = 0; while (globus_rls_client_lrc_get_lfn(h, "somepfn", &offset, 5, &str2_list) == GLOBUS_SUCCESS) { for (p = str2_list; p; p = globus_list_rest(p)) { str2 = (globus_rls_string2_t *) globus_list_first(p); printf("lfn: %s pfn:%s0, str2->s1, str2->s2); } globus_rls_client_free_list(str2_list); if (offset == -1) break; } .fi Function Documentation globus_result_t globus_rls_client_free_list (globus_list_t *list) Free result list returned by one of the query functions. Parameters: list List returned by one of the query functions. Return values: GLOBUS_SUCCESS List and contents successfully freed. Author Generated automatically by Doxygen for globus rls client from the source code. Version 5.2 Wed Jan 25 2012 Query Results(3)
Check Out this Related Man Page
globus-rls-admin(8) System Manager's Manual globus-rls-admin(8) NAME
globus-rls-admin - Replica Location Service Administration SYNOPSIS
globus-rls-admin -A|-a|-C option value|-c option|-D|-d|-e|-p|-q|-r|-S|-s|-t timeout|-u|-v [ rli ] [ pattern ] [ server ] DESCRIPTION
The program globus-rls-admin performs administrative operations on a RLS server (see globus-rls-server(8)). OPTIONS
-A Add rli to list of RLI servers updated by an LRC server using Bloom filters. Note that partitions are not supported with Bloom fil- ters, the LRC server maintains one Bloom filter for all LFNs in its database, which is sent to all RLI servers configured to receive Bloom filter updates with this option. -a Add rli and optionally pattern to the list of RLI servers that the LRC server sends updates to (using a list of LFNs). If pattern is specified then only LFNs matching it will be sent to rli. If rli is added with no patterns, then it is sent all updates. Pat- tern matching is done using standard Unix file globbing (see fnmatch(3) or sh(1)). -C option value Set server option to value. Note this does not update the configuration file, the next time the server is restarted the configura- tion change will be lost. -c option Retrieve configuration value for specified option from server. If option is "all" then all options are retrieved. -D Remove rli and pattern from list of RLI servers that the RLI server sends updates to. If pattern is not specified then all entries for rli are removed. Note if all patterns are removed separately then rli is sent all updates. To stop any updates from being sent to rli do not specify pattern -d Remove rli and pattern from list of RLI servers that the LRC server sends updates to. If pattern is not specified then all entries for rli are removed. Note if all patterns are removed separately then rli is sent all updates. To stop any updates from being sent to rli do not specify pattern -e Clear LRC database. Removes all lfn,pfn mappings. -p Verifies that the server is responding. -q Cause RLS server to exit. -r Add rli and optionally pattern to the list of RLI servers that the RLI server sends updates to. If pattern is specified then only LFNs matching it will be sent to rli. If rli is added with no patterns, then it is sent all updates. Pattern matching is done using standard Unix file globbing (see fnmatch(3) or sh(1)). -S Show statistics and other information gathered by RLS server. Intended to be input into GRIS. -s Show list of RLI servers and patterns being sent updates by the LRC server. If rli or pattern are not specified they are considered wildcards. -t timeout Set timeout (in seconds) for RLS server requests. Default is 30 seconds. -u Cause LRC server to immediately start full softstate updates to any RLI servers previously added with the -a option. -v Show version and exit. SEE ALSO
globus-rls-server(8), globus_rls_client man pages 23 Apr 02 globus-rls-admin(8)