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

l
libIO(3X) libIO(3X)
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.
[IO_E_NODE_PARM] Node already exists or parameter error detected.
[IO_E_OPER_FAIL] Operation failed.
[IO_E_OPEN_FLAG] Invalid open flag.
[IO_E_PARM] Parameter error.
[IO_E_PATH_STR] String does not represent a valid path.
[IO_E_SYSCALL] System call error.
[IO_E_UNEXPECTED] Unexpected error.
[IO_E_WOULDBLOCK] The call would block in the kernel.
MULTITHREAD USAGE
The
libIO APIs are not thread-safe.
WARNINGS
Many APIs in libIO are release specific. These APIs may be removed or have its meaning changed in
future releases of HP-UX.
AUTHOR
libIO was developed by HP.
HP-UX 11i Version 3: February 2007 − 23 − Hewlett-Packard Company 741