Looks up information in a Global Location Broker (GLB) or Local Location Broker (LLB) database.
void lb_$lookup_range (object, object_type, object_interface, location, lookup_handle) void lb_$lookup_range (location_length, max_results, num_results, results, status) uuid_$t *object; uuid_$t *object_type; uuid_$t *object_interface; socket_$addr_t *location; unsigned long location_length; lb_$lookup_handle_t *lookup_handle; unsigned long max_results; unsigned long *num_results; lb_$entry_t results [ ]; status_$t *status;
The lb_$lookup_range routine returns database entries that contain matching object, obj_type, and obj_interface identifiers. A value of uuid_$nil in any of these input parameters acts as a wildcard and matches all values in the corresponding entry field. You can include wild cards in any combination of these parameters.
The lb_$lookup_interface routine cannot return more than the number of matching entries specified by the max_results parameter at one time. The lookup_handle parameter directs this routine to do sequential lookup calls to find all matching entries.
Notes:
- The Location Broker does not prevent modification of the database between lookup calls, which can cause the locations of entries relative to a value of the lookup_handle parameter value to change. If multiple calls are made to find all matching results in the database, the returned information may skip or duplicate entries from the database.
- The results of a single lookup call can possibly skip or duplicate entries. This can occur if the size of the results exceeds the size of a remote procedure call (RPC) packet (64KB).
Input |
---|
Input/Output |
---|
Output |
---|
To look up information in the GLB database about the change_if interface to the proc_db2 object (which is of the proc_db type), enter:
lb_$lookup_range (&proc_db2_id, &proc_db_id, &change_if_id, glb, 0, &lookup_handle, 10, &num_results, results, &st);
The name glb is defined elsewhere as a null pointer. The results parameter is a 10-element array of the lb_$entry_t type.
This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.
Remote Procedure Call (RPC) Runtime Library (NCS) in AIX Version 4.3 Communications Programming Concepts.