libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
Arguments
token Token returned by previous call to
io_search().
type Specifies type (see
io_query()
).
key Query field string.
dat Query field data.
Return Value
See Return Value section of
io_query_array()
.
Errors
See the Errors section of
io_query_array()
.
libIO FUNCTION
Name
io_query_array()
- gets information (multiple fields) about a token
Synopsis
int io_query_array(io_token_t token, int type,
int nkeys, char *key[], void *ptr[]);
Description
This routine is an enhancement to io_query(). It returns multiple fields for a token at one time.
Arguments
token Token returned by previous call to
io_search().
type Type of query (see
io_query()).
nkeys Number of keys in the query.
key[ ] An array of query field string.
ptr [ ] An array of corresponding query field data.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_OPEN]
[IO_E_DCONF_ACCESS]
[IO_E_PARM]
[IO_E_SYSCALL]
libIO FUNCTION
Name
io_search(), io_search_array() - searches I/O subsystem and system data structures
Synopsis
io_token_t io_search(io_token_t token, int type, int qual,
char *key1, void *dat1, char *key2, void *dat2,...,
char *keyN, void *datN,NULL);
io_token_t io_search_array(io_token_t token, int type, int qual,
char *key[], void *dat[]);
Description
This function is used to search for I/O system information. The token returned corresponds to an entry in
the I/O tree or one of the other tables which can be specified in type. The token can be used with the
io_query() command to obtain information about the token.
Arguments
token Token returned by a previous call to
io_search(), or NULL if first search.
10 Hewlett-Packard Company 10 HP-UX 11i Version 3: September 2010