Manual Pages for UNIX Operating System command usage for man ddi_dev_is_sid

Kernel Functions for Drivers                   ddi_dev_is_sid(9F)



NAME
     ddi_dev_is_sid - tell whether a device is self-identifying

SYNOPSIS
     #include 
     #include 
     #include 



     int ddi_dev_is_sid(dev_info_t *dip);


INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI).

PARAMETERS
     dip    A pointer to the device's dev_info structure.


DESCRIPTION
     The ddi_dev_is_sid() function tells the caller  whether  the
     device described by dip is self-identifying, that is, a dev-
     ice that can unequivocally tell the system that  it  exists.
     This  is  useful  for  drivers  that  support  both  a self-
     identifying as well as a non-self-identifying variants of  a
     device (and therefore must be probed).

RETURN VALUES
     DDI_SUCCESS    Device is self-identifying.


     DDI_FAILURE    Device is not self-identifying.


CONTEXT
     The ddi_dev_is_sid()  function  can  be  called  from  user,
     interrupt, or kernel context.

EXAMPLES
       1   ...
       2   int
       3   bz_probe(dev_info_t *dip)
       4   {
       5    ...
       6    if (ddi_dev_is_sid(dip) == DDI_SUCCESS) {
       7         /*
       8          * This is the self-identifying version (OpenBoot).
       9          * No need to probe for it because we know it is there.
       10         * The existence of dip && ddi_dev_is_sid() proves this.
       11         */
       12             return (DDI_PROBE_DONTCARE);



SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                   ddi_dev_is_sid(9F)



       13   }
       14   /*
       15    * Not a self-identifying variant of the device. Now we have to
       16    * do some work to see whether it is really attached to the
       17    * system.
       18    */
       19  ...


SEE ALSO
     probe(9E) Writing Device Drivers












































SunOS 5.11          Last change: 16 Jan 2006                    2