Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_path_client_node(3devinfo) [opensolaris man page]

di_path_bus_addr(3DEVINFO)			       Device Information Library Functions				di_path_bus_addr(3DEVINFO)

NAME
di_path_bus_addr, di_path_client_node, di_path_instance, di_path_node_name, di_path_phci_node, di_path_state - return libdevinfo path node information SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> char *di_path_bus_addr(di_path_t path); di_node_t di_path_client_node(di_path_t path); int di_path_instance(di_path_t path); char *di_path_node_name(di_path_t path); di_node_t di_path_phci_node(di_path_t path); di_path_state_t di_path_state(di_path_t path); PARAMETERS
path The handle to a path node in a di_init(3DEVINFO) snapshot. DESCRIPTION
These functions extract information associated with a path node. RETURN VALUES
The di_path_bus_addr() function returns a string representing the pHCI child path node's unit-address. This function is the di_path_t peer of di_bus_addr(3DEVINFO). The di_path_client_node() function returns the di_node_t of the 'client' device node associated with the given path node. If the client device node is not present in the current device tree snapshot, DI_NODE_NIL is returned and errno is set to ENOTSUP. The di_path_node_name() function returns a pointer to a null-terminated string containing the path node name. This function is the di_path_t peer of di_node_name(3DEVINFO). The di_path_instance() function returns the instance number associated with the given path node. A path node instance is persistent across attach(9E)/detach(9E)and device reconfigurations, but not across reboot. A path node instance is unrelated to a device node di_instance(3DEVINFO). The di_path_phci_node() function returns the di_node_t of the pHCI host adapter associated with the given path node. If the pHCI device node is not present in the current device tree snapshot, DI_NODE_NIL is returned and errno is set to ENOTSUP. The di_path_state() function returns the state of an I/O path. This function may return one of the following values: DI_PATH_STATE_ONLINE Identifies that the path_info node is online and I/O requests can be routed through this path. DI_PATH_STATE_OFFLINE Identifies that the path_info node is in offline state. DI_PATH_STATE_FAULT Identifies that the path_info node is in faulted state and not ready for I/O operations. DI_PATH_STATE_STANDBY Identifies that the path_info node is in standby state and not ready for I/O operations. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
di_bus_addr(3DEVINFO), di_devfs_path(3DEVINFO), di_init(3DEVINFO), di_instance(3DEVINFO), di_node_name(3DEVINFO), di_path_client_next_path(3DEVINFO), di_path_prop_next(3DEVINFO), di_path_prop_bytes(3DEVINFO), di_path_prop_lookup_bytes(3DEVINFO), di_path_prop_next(3DEVINFO), libdevinfo(3LIB), attributes(5) Writing Device Drivers SunOS 5.11 15 May 2008 di_path_bus_addr(3DEVINFO)

Check Out this Related Man Page

di_devfs_path(3DEVINFO) 			       Device Information Library Functions				   di_devfs_path(3DEVINFO)

NAME
di_devfs_path, di_devfs_minor_path, di_path_devfs_path, di_path_client_devfs_path, di_devfs_path_free - generate and free path names SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> char *di_devfs_path(di_node_t node); char *di_devfs_minor_path(di_minor_t minor); char *di_path_devfs_path(di_path_t path); char *di_path_client_devfs_path(di_path_t path); void di_devfs_path_free(char *path_buf); PARAMETERS
node The handle to a device node in a di_init(3DEVINFO) snapshot. minor The handle to a device minor node in a snapshot. path The handle to a device path node in a snapshot. path_buf A pointer returned by di_devfs_path(), di_devfs_minor_path(), di_path_devfs_path(), or di_path_client_devfs_path(). DESCRIPTION
The di_devfs_path() function generates the physical path of the device node specified by node. The di_devfs_minor_path() function generates the physical path of the device minor node specified by minor. The di_path_devfs_path() function generates the pHCI physical path to the device associated with the specified path node. The returned string is identical to the di_devfs_path() for the device had the device not been supported by multipath. The di_path_client_devfs_path() function generates the vHCI physical path of the multipath client device node associated with the device identity of the specified path node. The returned string is identical to the di_devfs_path() of the multipath client device node. The di_devfs_path_free() function frees memory that was allocated to store the path returned by di_devfs_path(), di_devfs_minor_path(), di_path_devfs_path(), and di_path_client_devfs_path(). The caller is responsible for freeing this memory by calling di_devfs_path_free(). RETURN VALUES
Upon successful completion, the di_devfs_path(), di_devfs_minor_path(), di_path_devfs_path(), and di_path_client_devfs_path() functions return a pointer to the string containing the path to a device node, a device minor node, or a device path node, respectively. Otherwise, they return NULL and errno is set to indicate the error. For a non-NULL return, the path will not have a "/devices" prefix. ERRORS
The di_devfs_path(), di_devfs_minor_path(), di_path_devfs_path(), and di_path_client_devfs_path() functions will fail if: EINVAL The node, minor, or path argument is not a valid handle. The di_devfs_path(), di_devfs_minor_path(), di_path_devfs_path(), and di_path_client_devfs_path() functions can also return any error value returned by malloc(3C). ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
di_init(3DEVINFO), libdevinfo(3LIB), malloc(3C), attributes(5) Writing Device Drivers SunOS 5.11 15 May 2008 di_devfs_path(3DEVINFO)
Man Page