Kernel Functions for Drivers            ddifmserviceimpact(9F)



NAME
     ddifmserviceimpact - report the impact of an error

SYNOPSIS
     #include 

     void ddifmserviceimpact(devinfot *dip, int *impact);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

PARAMETERS
     dip       Pointer to the devinfo structure


     impact    Impact of error


DESCRIPTION
     The  following  service  impact  values  are   accepted   by
     ddifmserviceimpact():

     DISERVICELOST          The service provided by the device
                               is  unavailable  due  to an error.
                               The operational state of the  dev-
                               ice     will     transition     to
                               DEVIDEVICEDOWN.


     DISERVICEDEGRADED      The driver is  unable  to  provide
                               normal service, but it can provide
                               a partial  or  degraded  level  of
                               service.  The driver might have to
                               make repeated attempts to  perform
                               an  operation  before it succeeds,
                               or it may be running at less  than
                               its configured speed. A driver may
                               use this value to indicate that an
                               alternative  device should be used
                               if available, but that it can con-
                               tinue  operation if no alternative
                               exists. The operational  state  of
                               the   device  will  transition  to
                               DEVIDEVICEDEGRADED.


     DISERVICERESTORED      The service provided by the device
                               has been restored. The operational
                               state of the device  will  transi-
                               tion  to  its  pre-error condition
                               state  and   DEVIDEVICEDOWN   or



SunOS 5.11          Last change: 14 May 2007                    1






Kernel Functions for Drivers            ddifmserviceimpact(9F)



                               DEVIDEVICEDEGRADED is removed.


     DISERVICEUNAFECTED    The service provided by the device
                               was unaffected by the error.


CONTEXT
     The ddifmserviceimpact()  function  can  be  called  from
     user, kernel, or high-level interrupt context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    


SEE ALSO
     fmd(1M),       attributes(5),       ddifmereportpost(9F),
     pciereportpost(9F)




























SunOS 5.11          Last change: 14 May 2007                    2