Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_path_phci_next_path(3devinfo) [opensolaris man page]

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

NAME
di_path_client_next_path, di_path_phci_next_path - libdevinfo path node traversal functions SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> di_path_t di_path_client_next_path(di_node_t node node, di_path_t path); di_path_t di_path_phci_next_path(di_node_t node node, di_path_t path); PARAMETERS
node The handle to a device node in a di_init(3DEVINFO) snapshot. For di_path_client_next_path(), node must be a client device node. For di_path_phci_next_path(), node must be a pHCI device node. path DI_PATH_NIL, or the handle to a path node in a snapshot. DESCRIPTION
Each path node is an element in a pHCI-client matrix. The matrix is implemented by dual linked lists: one list links path nodes related to a common client head, and the other links path nodes related to a common pHCI head. The di_path_client_next_path() function is called on a multipathing 'client' device node, where a 'client' is the child of a vHCI device node, and is associated with a specific endpoint device identity (independent of physical paths). If the path argument is NULL, di_path_client_next_path() returns the first path node associated with the client. To walk all path nodes associated with a client, returned di_path_t values are fed back into di_path_client_next_path(), via the path argument, until a null path node is returned. For each path node, di_path_bus_addr(3DEVINFO) returns the pHCI child path node unit-address. The di_path_phci_next_path() function is called on a multipathing pHCI device node. If the path argument is NULL, di_path_phci_next_path() returns the first path node associated with the pHCI. To walk all path nodes associated with a pHCI, returned di_path_t values are fed back into di_path_phci_next_path(), via the path argument, until a null path node is returned. For each path node, di_path_client_node(3DEV- INFO) provides a pointer to the associated client device node. A device node can be a client device node of one multipathing class and a pHCI device node of another class. RETURN VALUES
Upon successful completion, a handle to the next path node is returned. Otherwise, DI_PATH_NIL is returned and errno is set to indicate the error. ERRORS
These functions will fail if: EINVAL One or more argument was invalid. ENOTSUP Path node information is not available in the snapshot. ENXIO The end of the path node list was reached. 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), di_path_bus_addr(3DEVINFO), di_path_client_node(3DEVINFO), libdevinfo(3LIB), attributes(5) Writing Device Drivers SunOS 5.11 15 May 2008 di_path_client_next_path(3DEVINFO)

Check Out this Related 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)
Man Page