ddi_dev_is_sid man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

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
       The  ddi_dev_is_sid()  function	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 driv‐
       ers that support both a self-identifying as well as a  non-self-identi‐
       fying 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);
	 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			  16 Jan 2006		    ddi_dev_is_sid(9F)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net