libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
type Specifies type of search (see
io_query()).
qual Qualifiers for search. More than one may be specified by bitwise "ORing" values into
qual. Defined values are:
Q_SW Software is associated with the I/O tree node.
Q_HW Hardware is associated with I/O tree node.
Q_PSEUDO Is a pseudo device driver.
Q_DEVSW Has switch table entry points.
Q_SUBTREE On I/O tree searches, return entire subtree under matching node.
Q_NEW Newly found hardware.
Q_TRANS Allows transparent nodes to be returned.
Q_CONSOLE Matches console device.
Q_DUMP Matches dump devices.
Q_BOOT Matches boot device.
Q_ROOT Matches root filesystem devices.
Q_SWAP Matches swap devices.
Q_SAVE_CONF I/O tree node information saved in ioconfig files. (See iocon-
fig(4)).
key A string corresponding to a defined query field. For
io_search_array(), this is a
NULL terminated array of strings.
IO_MAX_SEARCH_KEYS
is the maximum array size.
dat A pointer to data to match for query field indicated in key. There must be a dat given
for every listed key.
IO_MAX_DATA_SIZE
is the maximum data size.
Return Value
token - Upon success.
NULL - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_ACCESS]
[IO_E_DCONF_OPEN]
[IO_E_KEY_TOKEN_DEF]
[IO_E_MATCH]
[IO_E_MEM_ALLOC]
[IO_E_PARM]
[IO_E_SYSCALL]
libIO FUNCTION
Name
io_search_array_batch() - retrieves an array of token matching the search
Synopsis
io_search_array_batch (io_token_t token, int type, int qual,
char *key[],void *dat[],io_token_t *ret_token);
Description
This routine is an enhancement of io_search_array(), it returns an array of tokens.
Arguments
token Token returned by previous call to
io_search(), or NULL if first search.
type Specifies type of search (see
io_query()).
qual Qualifier for search (see
io_search()).
key[] An array of query field string.
HP-UX 11i Version 3: September 2010 − 11 − Hewlett-Packard Company 11