1ddi_fm_service_impact(9F)Kernel Functions for Driversddi_fm_service_impact(9F)
2
3
4
6 ddi_fm_service_impact - report the impact of an error
7
9 #include <sys/ddifm.h>
10
11 void ddi_fm_service_impact(dev_info_t *dip, int *impact);
12
13
15 Solaris DDI specific (Solaris DDI)
16
18 dip Pointer to the dev_info structure
19
20
21 impact Impact of error
22
23
25 The following service impact values are accepted by ddi_fm_ser‐
26 vice_impact():
27
28 DDI_SERVICE_LOST The service provided by the device is
29 unavailable due to an error. The operational
30 state of the device will transition to
31 DEVI_DEVICE_DOWN.
32
33
34 DDI_SERVICE_DEGRADED The driver is unable to provide normal ser‐
35 vice, but it can provide a partial or
36 degraded level of service. The driver might
37 have to make repeated attempts to perform an
38 operation before it succeeds, or it may be
39 running at less than its configured speed. A
40 driver may use this value to indicate that an
41 alternative device should be used if avail‐
42 able, but that it can continue operation if
43 no alternative exists. The operational state
44 of the device will transition to
45 DEVI_DEVICE_DEGRADED.
46
47
48 DDI_SERVICE_RESTORED The service provided by the device has been
49 restored. The operational state of the device
50 will transition to its pre-error condition
51 state and DEVI_DEVICE_DOWN or
52 DEVI_DEVICE_DEGRADED is removed.
53
54
55 DDI_SERVICE_UNAFFECTED The service provided by the device was unaf‐
56 fected by the error.
57
58
60 The ddi_fm_service_impact() function can be called from user, kernel,
61 or high-level interrupt context.
62
64 See attributes(5) for descriptions of the following attributes:
65
66
67
68
69 ┌─────────────────────────────┬─────────────────────────────┐
70 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
71 ├─────────────────────────────┼─────────────────────────────┤
72 │Interface Stability │Committed │
73 └─────────────────────────────┴─────────────────────────────┘
74
76 fmd(1M), attributes(5), ddi_fm_ereport_post(9F), pci_ereport_post(9F)
77
78
79
80SunOS 5.11 14 May 2007 ddi_fm_service_impact(9F)