libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
Return Value
IO_TOKEN_NEW -Ifdev_t is of an agile node.
IO_TOKEN_LEGACY
-Ifdev_t is of a legacy node.
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]
libIO FUNCTION
Name
io_get_legacy_mode()
- returns the state of legacy mode
Synopsis
int io_get_legacy_mode (unsigned int *mode)
Description
This API is called to retrieve the state of legacy mode. The value returned in the argument mode will
specify if the legacy mode is currently enabled or disabled (see rmsf(1M) and insf (1M)).
Arguments
mode A pointer to an unsigned integer.
1 Value set if legacy mode is enabled.
0 Value set if the legacy mode is disabled.
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_FUNC_NOT_SUPPORTED]
libIO FUNCTION
Name
io_get_mapping() - returns a mapping between a given node and other I/O nodes
Synopsis
int io_get_mapping(io_token_t node, io_map_type_t map_type,
int *count, io_token_t *token_arry);
Description
This API is called to retrieve the node or nodes mapped to a given node token.
Given a legacy token with a map_type of
IO_LEGACY_2_NEW, the routine will return an agile token
mapped to it.
Given an agile token with a map_type of
IO_NEW_2_LEGACY, the routine will return one or more legacy
token(s).
Given a LUN token with a map_type of
IO_LUN_2_LUNPATH, the routine will return one or more lun-
path token(s) mapped to it.
Likewise, if given a lunpath token and a map_type of
IO_LUNPATH_2_LUN, a LUN token will be
returned.
Arguments
node A node token to which mappings will be returned.
map_type Possible values are:
IO_LEGACY_2_NEW
Obtains the agile node token from the given legacy token. This is a one to one
14 Hewlett-Packard Company − 14 − HP-UX 11i Version 3: September 2010