Using the HP-UX libIO Library

io_hw_path_to_node()
Each node can be uniquely identified by a hardware path. This routine returns the
token for the specified hardware path. The synopsis of the function is:
io_token_t io_hw_path_to_node(hw_path_t *path);
io_node_to_hwpath()
This routine assigns path with the full hardware path of the given node. The
synopsis of the function is:
int io_node_to_hw_path(io_token_t node, hw_path_t *path);
io_hw_path_to_str()
This routine converts the absolute path specified by hw_path to the string pointed to
by str. str must have enough space (a h/w path can have a string length of
MAX_HW_PATH_LEN) to hold the converted string. If hw_path is NULL, no data is
transferred, and the length of the string is returned. The synopsis of the function is:
int io_hw_path_to_str(char *str,hw_path_t *path);
io_str_to_hw_path()
This routine converts a string representing the hardware path to the hw_path_t
structure. It takes as input a string representing a path and allocates hw_path with
the full hardware path. The synopsis of the function is:
int io_str_to_hw_path(char *str, hw_path_t *path);
io_is_hw_path_legacy()
This routine accepts a hardware path in string format and determines whether it is a
legacy hardware path or agile hardware path. The function prototype for this routine
is:
int io_is_hwpath_legacy(char *path);