libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
with the returned count value. and needs to call the API again with the
new buffer and count values.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_OPEN]
[IO_E_PARM]
[IO_E_DCONF_ACCESS]
[IO_E_SYSCALL]
[IO_BUF_TOO_SMALL]
[IO_E_MEM_ALLOC]
libIO FUNCTION
Name
io_init_hw_path()
- initializes the hardware path with the passed flags argument
Synopsis
int io_init_hw_path(hw_path_t *hw_path, int flags);
Description
This API initializes the hardware path structure hw_path_t according to the specified flags argument.
IO_TREE_LEGACY should be passed as flags value when initializing a legacy hardware path. See
intro (7). Zero can be passed as flags value for all other cases.
Arguments
hw_path Pointer to hardware path structure.
flags The flags field of the hardware path.
The valid flags are 0 and
IO_TREE_LEGACY
.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR -Otherwise.
Errors
None.
LIBIO_ERRORS
The following describes the
io_errno values, which are set after a libIO API failure.
[IO_E_BUF_TOO_SMALL] User buffer too small.
[IO_E_DCONF_ACCESS]
/dev/config permission denied.
[IO_E_DCONF_NOEXIST]
/dev/config does not exist.
[IO_E_DCONF_OPEN]
/dev/config is not open.
[IO_E_DYN_MAJOR]: Dynamic major not defined for specified node.
[IO_E_FUNC_NOT_SUPPORTED]
Functionality not supported.
[IO_E_KEY_TOKEN_DEF] Key is undefined for specified token, or token is NULL.
[IO_E_MATCH] No match found.
[IO_E_MEM_ALLOC] Unable to allocate memory.
[IO_E_NO_LCK] Another IO event is in progress.
[IO_E_NODE_DESTROY] Not able to destroy specified node or a descendent of node.
[IO_E_NODE_NOEXIST] I/O tree node does not exist.
HP-UX 11i Version 3: September 2010 − 23 − Hewlett-Packard Company 23