ddi_report_dev(9f) [sunos man page]

ddi_report_dev(9F)					   Kernel Functions for Drivers 					ddi_report_dev(9F)

NAME

       ddi_report_dev - announce a device

SYNOPSIS

       #include <sys/conf.h>
       #include <sys/ddi.h>
       #include <sys/sunddi.h>

       void ddi_report_dev(dev_info_t *dip);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

PARAMETERS

       dip	a pointer the device's dev_info structure.

DESCRIPTION

       ddi_report_dev()  prints a banner at boot time,	announcing the device pointed to by dip. The banner is always placed in the system logfile
       (displayed by dmesg(1M)), but is only displayed on the console if the system was booted with the verbose (-v) argument.

CONTEXT

       ddi_report_dev() can be called from user context.

SEE ALSO

       dmesg(1M), kernel(1M)

       Writing Device Drivers

SunOS 5.10							    7 Jun 1993							ddi_report_dev(9F)

ddi_dev_is_sid(9F)					   Kernel Functions for Drivers 					ddi_dev_is_sid(9F)

NAME

       ddi_dev_is_sid - tell whether a device is self-identifying

SYNOPSIS

       #include <sys/conf.h>
       #include <sys/ddi.h>
       #include <sys/sunddi.h>

       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

       ddi_dev_is_sid()  tells	the  caller whether the device described by dip is self-identifying, that is, a device 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

       ddi_dev_is_sid() can be called from user or interrupt 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);
       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.10							    24 Oct 1991 						ddi_dev_is_sid(9F)