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

l
libIO(3X) libIO(3X)
2) Count will be set to the real count of io_token_t to be returned,
3) The API will return
IO_ERROR,
4)
io_errno will be set to IO_E_BUF_TOO_SMALL
.
In this case, the caller needs to allocate a bigger buffer after recalculating it
using:
(sizeof(io_token_t)*count)
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_NODE_NOEXIST]
[IO_E_SYSCALL]
[IO_E_BUF_TOO_SMALL]
[IO_E_MEM_ALLOC]
libIO FUNCTION
Name
io_is_hwpath_legacy()
- determines if the given hardware path is of legacy or agile form
Synopsis
int io_is_hwpath_legacy(char *path);
Description
This API accepts a hardware path in string format and determines whether it is a legacy path or agile
hardware path.
Arguments
path A pointer to a string representing a hardware path.
Return Value
IO_HWPATH_NEW - If the path is an agile path.
IO_HWPATH_LEGACY
- If the path is a legacy path.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_OPEN]
[IO_E_PARM]
[IO_E_SYSCALL]
[IO_E_PATH_STR]
[IO_E_NODE_NOEXIST]
libIO FUNCTION
Name
io_get_node_relation() - retrieves a relative of a given node token
Synopsis
int io_get_node_relation(io_token_t node, int relationship,
uint64_t addr, io_token_t *relative);
Description
This API is called to get the relative of the I/O node specified by node. The parameter relationship indi-
cates what kind of relative. Valid values are:
HP-UX 11i Version 3: February 2007 − 15 − Hewlett-Packard Company 733