Manual Pages for UNIX Operating System command usage for man di_instance

Device Information Library Functions    di_binding_name(3DEVINFO)



NAME
     di_binding_name, di_bus_addr, di_compatible_names, di_devid,
     di_driver_name, di_driver_ops, di_driver_major, di_instance,
     di_nodeid, di_node_name - return libdevinfo node information

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

     char *di_binding_name(di_node_t node);


     char *di_bus_addr(di_node_t node);


     int di_compatible_names(di_node_t node, char **names);


     ddi_devid_t di_devid(di_node_t node);


     char *di_driver_name(di_node_t node);


     uint_t di_driver_ops(di_node_t node);


     int di_driver_major(di_node_t node);


     int di_instance(di_node_t node);


     int di_nodeid(di_node_t node);


     char *di_node_name(di_node_t node);


PARAMETERS
     names    The address of a pointer.


     node     A  handle to a device  node.


DESCRIPTION
     These functions extract information associated with a device
     node.

RETURN VALUES




SunOS 5.11          Last change: 22 Mar 2004                    1






Device Information Library Functions    di_binding_name(3DEVINFO)



     The di_binding_name() function  returns  a  pointer  to  the
     binding  name. The binding name is the name used by the sys-
     tem to select a driver for the device.


     The di_bus_addr() function returns  a  pointer  to  a  null-
     terminated  string  containing  the assigned bus address for
     the device. NULL is returned if a bus address has  not  been
     assigned to the device. A zero-length string may be returned
     and is considered a valid bus address.


     The return value of di_compatible_names() is the  number  of
     compatible names. names is updated to point to a buffer con-
     tained within the snapshot. The buffer contains a concatena-
     tion of null-terminated strings, for example:

       /0/0.../0



     See the  discussion  of  generic  names  in  Writing  Device
     Drivers  for  a description of how compatible names are used
     by Solaris to achieve driver binding for the node.


     The di_devid() function returns the device ID for  node,  if
     it  is  registered.  Otherwise,  a null pointer is returned.
     Interfaces in the libdevid(3LIB)  library  may  be  used  to
     manipulate  the  handle  to  the device id. This function is
     obsolete and might be removed from a future Solaris release.
     Applications should use the "devid" property instead.


     The di_driver_name() function returns the name of the driver
     bound  to  the  node. A null pointer is returned if  node is
     not bound to any driver.


     The di_driver_ops() function returns a bit array of   device
     driver  entry  points that are supported by the driver bound
     to this node. Possible bit fields supported  by  the  driver
     are DI_CB_OPS, DI_BUS_OPS, DI_STREAM_OPS.


     The di_driver_major()  function  returns  the  major  number
     associated  with  the  driver  bound to node. If there is no
     driver bound to the node, this function returns -1.


     The di_instance() function returns the  instance  number  of
     the  device.  A value of -1 indicates an instance number has



SunOS 5.11          Last change: 22 Mar 2004                    2






Device Information Library Functions    di_binding_name(3DEVINFO)



     not been assigned to the device by the system.


     The di_nodeid() function returns  the type of device,  which
     may    be    one   of   the   following   possible   values:
     DI_PSEUDO_NODEID, DI_PROM_NODEID,  and  DI_SID_NODEID.  Dev-
     ices  of  type DI_PROM_NODEID may have additional properties
     that     are     defined     by      the      PROM.      See
     di_prom_prop_data(3DEVINFO)                              and
     di_prom_prop_lookup_bytes(3DEVINFO).


     The di_node_name() function returns a  pointer  to  a  null-
     terminated string containing the node name.

EXAMPLES
     See di_init(3DEVINFO) for an example  demonstrating  typical
     use of these functions.

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



     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed (di_devid() is obsolete)|
    |_____________________________|___________________________________|
    | MT-Level                    | Safe                              |
    |_____________________________|___________________________________|


SEE ALSO
     di_init(3DEVINFO),                   di_prom_init(3DEVINFO),
     di_prom_prop_data(3DEVINFO),
     di_prom_prop_lookup_bytes(3DEVINFO),         libdevid(3LIB),
     libdevinfo(3LIB), attributes(5)


     Writing Device Drivers













SunOS 5.11          Last change: 22 Mar 2004                    3