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_ACCESS]
[IO_E_DCONF_OPEN]
[IO_E_NODE_NOEXIST]
[IO_E_PARM]
[IO_E_SYSCALL]
libIO FUNCTION
Name
io_node_to_hw_path()
- converts token to a hardware path
Synopsis
int io_node_to_hw_path(io_token_t node,hw_path_t *hw_path);
Description
io_node_to_hw_path()
fills hw_path with the hardware path of the given node.
Arguments
node Token corresponding to I/O node.
hw_path Hardware path of node.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_ACCESS]
[IO_E_DCONF_OPEN]
[IO_E_NODE_NOEXIST]
[IO_E_SYSCALL]
libIO FUNCTION
Name
io_query() - gets information about a token
Synopsis
int io_query(io_token_t token,int type,char *key,void *ptr);
Description
io_query() is used to get information about a token previously obtained by a call to io_search()
.
The data corresponding to key is copied to the buffer pointed to by ptr. key must be one of the strings
known to the I/O subsystem. Note that not all keys are defined for all queries. If ptr is NULL, then
io_query() just returns the number of bytes which would have been copied. See the examples in
io_search() .
It is the users responsibility to ensure that the buffer pointed to by ptr is large enough to contain the
requested information.
Arguments
token Token returned by a call to
io_search() .
type Specifies type of query.
Only one should be specified. The defined values are:
S_IOTREE Causes a query of the I/O tree.
S_IOTREE_EXT Causes a query of the agile I/O tree.
S_BDEVSW Causes a query of a block device switch table.
S_CDEVSW Causes a query of a character device switch table.
726 Hewlett-Packard Company − 8 − HP-UX 11i Version 3: February 2007