HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

l
libIO(3X) libIO(3X)
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.
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.
728 Hewlett-Packard Company − 10 − HP-UX 11i Version 3: February 2007