libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
mapping.
IO_NEW_2_LEGACY
Obtains the legacy node token from the given agile node token. This can be a one
to many mapping.
IO_LUN_2_LUNPATH
Obtains the lunpath token from the given lun node token. This can be a one to
many mapping.
IO_LUNPATH_2_LUN
Obtains the lun node token from the given lunpath token. This mapping is a one
to one mapping.
token_arry Possible values are:
INPUT:
A pointer to an array of io_token_t
. Recommended size is:
(sizeof(io_token_t)*10)
OUTPUT:
The io_token_t (s) returned will be copied into this array.
count The values are:
INPUT:
Number of tokens to be returned in the token_array .
10 is the recommended for the initial count.
OUTPUT:
Number of actual io_token_t (s) in the returned token_array . If the array is not
big enough:
1) No token will be returned,
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);
HP-UX 11i Version 3: September 2010 − 15 − Hewlett-Packard Company 15