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

l
libIO(3X) libIO(3X)
NAME
libIO: io_block_to_char_dsf(), io_block_to_raw(), io_char_to_block_dsf(), io_dev_to_node(),
io_dev_to_options(), io_end(), io_error, io_get_devs(), io_get_legacy_mode(), io_get_mapping(),
io_get_node_relation(), io_hw_compare(), io_hw_compare_ext(), io_hw_path_to_node(), io_hw_path_to_str(),
io_init(), io_init_hw_path(), io_is_hwpath_legacy(), io_is_legacy_dev(), io_is_legacy_token(),
io_is_option_set(), io_legacy_to_new_dev(), io_legacy_to_new_dsf(), io_legacy_to_new_hwpath(), io_mkdev(),
io_mkdev_ext(), io_new_to_legacy_devs(), io_new_to_legacy_dsfs(), io_new_to_legacy_hwpath(),
io_node_to_hw_path(), io_query(), io_query_array(), io_query_batch(), io_raw_to_block(), io_search(),
io_search_array(), io_search_array_batch(), io_str_to_hw_path(), io_strerror(), - interface for interacting
with kernel I/O subsystem
SYNOPSIS
#include <sys/libIO.h>
Remarks
Each function in NAME is described in its own libIO FUNCTION section below.
DESCRIPTION
The
libIO library provides APIs to access the I/O subsystem through the dev_config driver. This
manpage describes each libIO API and the associated data structures.
The Errors section under each API lists the possible io_errno values that is set when the API fails. The
LIBIO_ERRORS section at the end of the manpage provides an explanation of each error value.
To use the libIO library, libIO.so (for Itanium(R)-based systems) or
libIO.sl (for PA-RISC sys-
tems), the program must link it using
-lIO.
I/O Subsystem Terms
The following are some common I/O subsystem terminologies and structures used in this manpage.
I/O node or token A handle used for uniquely identifying an object in I/O subsystem (represented
by io_token_t ).
I/O tree A kernel data structure representation for a group of I/O nodes.
io_errno An extern variable used to store the libIO specific error number when a
libIO API fails. The usage is similar to errno (see errno(2)).
dev_t See mknod(5).
leg_hw_path_t A data structure for storing hardware paths used for releases prior to HP-UX 11i
V3. This structure has only 14 elements of type unsigned char.
hw_path_t A data structure for storing hardware paths used for HP-UX 11i V3 and later
releases. This structure can have up to 64 elements of type hw_addr_t .
LibIO APIs
Here are the libIO APIs provided for HP-UX 11i V3.
io_block_to_char_dsf()
Maps a block device special file to character device special file
io_block_to_raw() Returns the character dev_t of the given block dev_t
io_char_to_block_dsf()
Maps a character device special file to block device special file
io_dev_to_node() Converts a dev_t to token
io_dev_to_options() Returns the device options of a given dev_t and dev_type
io_end() Terminates a connection with the dev_config driver
io_error() Provides libIO error messages
io_get_devs() Returns the dev_ts of a given node
io_get_legacy_mode() Returns the state of legacy mode
io_get_mapping() Returns a mapping between a given node and other I/O nodes
io_get_node_relation() Retrieve a relative of a given node token
io_hw_compare() Compares two pre-HP-UX 11i V3 hardware path structures
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 719