|
cctools
|
Go to the source code of this file.
Enumerations | |
| enum | catalog_update_flags_t { CATALOG_UPDATE_BACKGROUND =1, CATALOG_UPDATE_CONDITIONAL =2 } |
| Catalog update control flags. More... | |
Functions | |
| struct catalog_query * | catalog_query_create (const char *hosts, struct jx *filter_expr, time_t stoptime) |
| Create a catalog query. More... | |
| struct jx * | catalog_query_read (struct catalog_query *q, time_t stoptime) |
| Read the next object from a query. More... | |
| void | catalog_query_delete (struct catalog_query *q) |
| Delete a completed query object. More... | |
| int | catalog_query_send_update (const char *hosts, const char *text, catalog_update_flags_t flags) |
| Send update text to the given hosts hosts is a comma delimited list of hosts, each of which can be host or host:port. More... | |
Query the global catalog server for server descriptions.
Catalog update control flags.
These control the behavior of catalog_query_send_update
| Enumerator | |
|---|---|
| CATALOG_UPDATE_BACKGROUND | Send update via a background process if TCP is selected. |
| CATALOG_UPDATE_CONDITIONAL | Fail if UDP is selected and update is too large to send. |
| struct catalog_query* catalog_query_create | ( | const char * | hosts, |
| struct jx * | filter_expr, | ||
| time_t | stoptime | ||
| ) |
Create a catalog query.
Connects to a catalog server, issues a query, and waits for the results. The caller may specify a specific catalog host and port. If none is given, then the environment variables CATALOG_HOST and CATALOG_PORT will be consulted. If neither is set, the system will contact chirp.cse.nd.edu on port 9097.
| hosts | A comma delimited list of catalog servers to query, or null for the default server. |
| filter_expr | An optional expression to filter the results in JX syntax. A null pointer indicates no filter. |
| stoptime | The absolute time at which to abort. |
| struct jx* catalog_query_read | ( | struct catalog_query * | q, |
| time_t | stoptime | ||
| ) |
Read the next object from a query.
Returns the next jx expressions from the issued query. The caller may use jx_lookup_string, jx_lookup_integer and related functions to manipulate the object, and then must call jx_delete when done.
| q | A query created by catalog_query_create. |
| stoptime | The absolute time at which to abort. |
| void catalog_query_delete | ( | struct catalog_query * | q | ) |
Delete a completed query object.
| q | The query to delete. |
| int catalog_query_send_update | ( | const char * | hosts, |
| const char * | text, | ||
| catalog_update_flags_t | flags | ||
| ) |
Send update text to the given hosts hosts is a comma delimited list of hosts, each of which can be host or host:port.
| hosts | A list of hosts to which to send updates |
| text | String to send |
| flags | Any combination of CATALOG_UPDATE |