Kernel Functions for Drivers ddi_fm_service_impact(9F)
NAME
ddi_fm_service_impact - report the impact of an error
SYNOPSIS
#include
void ddi_fm_service_impact(dev_info_t *dip, int *impact);
INTERFACE LEVEL
Solaris DDI specific (Solaris DDI)PARAMETERS
dip Pointer to the dev_info structure
impact Impact of errorDESCRIPTION
The following service impact values are accepted byddi_fm_service_impact():
DDI_SERVICE_LOST The service provided by the device
is unavailable due to an error.The operational state of the dev-
ice will transition toDEVI_DEVICE_DOWN.
DDI_SERVICE_DEGRADED 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 usedif available, but that it can con-
tinue operation if no alternative exists. The operational state of the device will transition toDEVI_DEVICE_DEGRADED.
DDI_SERVICE_RESTORED The service provided by the device
has been restored. The operationalstate of the device will transi-
tion to its pre-error condition
state and DEVI_DEVICE_DOWN or
SunOS 5.11 Last change: 14 May 2007 1
Kernel Functions for Drivers ddi_fm_service_impact(9F)
DEVI_DEVICE_DEGRADED is removed.
DDI_SERVICE_UNAFFECTED The service provided by the device
was unaffected by the error.CONTEXT
The ddi_fm_service_impact() function can be called from
user, kernel, or high-level interrupt context.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
SEE ALSO
fmd(1M), attributes(5), ddi_fm_ereport_post(9F),
pci_ereport_post(9F)
SunOS 5.11 Last change: 14 May 2007 2