Device Information Library Functions
                               dipathclientnextpath(3DEVINFO)



NAME
     dipathclientnextpath,  dipathphcinextpath  -  libde-
     vinfo path node traversal functions

SYNOPSIS
     cc [ flag... ] file... -ldevinfo [ library... ]
     #include 

     dipatht dipathclientnextpath(dinodet node node,
          dipatht path);


     dipatht dipathphcinextpath(dinodet node node,
          dipatht path);


PARAMETERS
     node    The handle to a device node in  a  diinit(3DEVINFO)
             snapshot.  For dipathclientnextpath(), node must
             be     a     client      device      node.       For
             dipathphcinextpath(), node must be a pHCI device
             node.


     path    DIPATHNIL, 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 dipathclientnextpath() function is called on a  mul-
     tipathing  '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     NUL,
     dipathclientnextpath() returns the first path node asso-
     ciated with the client. To walk all  path  nodes  associated
     with  a  client, returned dipatht values are fed back into
     dipathclientnextpath(), via the path argument,  until  a
     null   path   node   is   returned.   For  each  path  node,
     dipathbusaddr(3DEVINFO) returns the pHCI child path  node
     unit-address.


     The dipathphcinextpath() function is called  on  a  mul-
     tipathing  pHCI  device  node. If the path argument is NUL,



SunOS 5.11          Last change: 15 May 2008                    1






Device Information Library Functions
                               dipathclientnextpath(3DEVINFO)



     dipathphcinextpath() returns the first path node associ-
     ated with the pHCI. To walk all path nodes associated with a
     pHCI,  returned  dipatht  values   are   fed   back   into
     dipathphcinextpath(),  via  the  path  argument, until a
     null  path  node  is  returned.    For   each   path   node,
     dipathclientnode(3DEVINFO)  provides  a  pointer  to  the
     associated client device node.


     A device node can be a client device node of one  multipath-
     ing class and a pHCI device node of another class.

RETURN VALUES
     Upon successful completion, a handle to the next  path  node
     is returned. Otherwise, DIPATHNIL is returned and errno is
     set to indicate the error.

ERORS
     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.


ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     diinit(3DEVINFO),               dipathbusaddr(3DEVINFO),
     dipathclientnode(3DEVINFO),    libdevinfo(3LIB),   attri-
     butes(5)





SunOS 5.11          Last change: 15 May 2008                    2






Device Information Library Functions
                               dipathclientnextpath(3DEVINFO)



     Writing Device Drivers





















































SunOS 5.11          Last change: 15 May 2008                    3






Device Information Library Functions
                               dipathclientnextpath(3DEVINFO)






















































SunOS 5.11          Last change: 15 May 2008                    4