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

l
libIO(3X) libIO(3X)
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 map-
ping.
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,
732 Hewlett-Packard Company − 14 − HP-UX 11i Version 3: February 2007