Device Information Library Functions   dipathbusaddr(3DEVINFO)



NAME
     dipathbusaddr,   dipathclientnode,   dipathinstance,
     dipathnodename, dipathphcinode, dipathstate - return
     libdevinfo path node information

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

     char *dipathbusaddr(dipatht path);


     dinodet dipathclientnode(dipatht path);


     int dipathinstance(dipatht path);


     char *dipathnodename(dipatht path);


     dinodet dipathphcinode(dipatht path);


     dipathstatet dipathstate(dipatht path);


PARAMETERS
     path    The handle to a path  node  in  a  diinit(3DEVINFO)
             snapshot.


DESCRIPTION
     These functions extract information associated with  a  path
     node.

RETURN VALUES
     The dipathbusaddr() function returns a string  represent-
     ing  the  pHCI child path node's unit-address. This function
     is the dipatht peer of dibusaddr(3DEVINFO).


     The dipathclientnode() function returns the dinodet  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, DINODENIL is returned and
     errno is set to ENOTSUP.


     The dipathnodename() function  returns  a  pointer  to  a
     null-terminated  string  containing the path node name. This
     function is the dipatht peer of dinodename(3DEVINFO).



SunOS 5.11          Last change: 15 May 2008                    1






Device Information Library Functions   dipathbusaddr(3DEVINFO)



     The dipathinstance() function returns the instance  number
     associated  with  the given path node.  A path node instance
     is persistent across attach(9E)/detach(9E)and device  recon-
     figurations, but not across reboot.  A path node instance is
     unrelated to a device node diinstance(3DEVINFO).


     The dipathphcinode() function returns  the  dinodet  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,  DINODENIL is returned and errno is set to
     ENOTSUP.


     The dipathstate() function returns the  state  of  an  I/O
     path. This function may return one of the following values:

     DIPATHSTATEONLINE

         Identifies that the pathinfo node  is  online  and  I/O
         requests can be routed through this path.


     DIPATHSTATEOFLINE

         Identifies that the pathinfo node is in offline state.


     DIPATHSTATEFAULT

         Identifies that the pathinfo node is in  faulted  state
         and not ready for I/O operations.


     DIPATHSTATESTANDBY

         Identifies that the pathinfo node is in  standby  state
         and not ready for I/O operations.


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












SunOS 5.11          Last change: 15 May 2008                    2






Device Information Library Functions   dipathbusaddr(3DEVINFO)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     dibusaddr(3DEVINFO),              didevfspath(3DEVINFO),
     diinit(3DEVINFO),                    diinstance(3DEVINFO),
     dinodename(3DEVINFO),  dipathclientnextpath(3DEVINFO),
     dipathpropnext(3DEVINFO),   dipathpropbytes(3DEVINFO),
     dipathproplookupbytes(3DEVINFO),
     dipathpropnext(3DEVINFO), libdevinfo(3LIB), attributes(5)


     Writing Device Drivers




































SunOS 5.11          Last change: 15 May 2008                    3