man/man9f/ddi_fm_service_impact.9f

         te
 Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 ddi_fm_service_impact 9F "14 May 2007" "SunOS 5.11" "Kernel Functions for Drivers"
 NAME
ddi_fm_service_impact - report the impact of an error
 SYNOPSIS

#include <sys/ddifm.h>

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 error


 DESCRIPTION

The following service impact values are accepted by
ddi_fm_service_impact():

DDI_SERVICE_LOST

The service provided by the device is unavailable due to an error. The
operational state of the device will transition to DEVI_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 used if available, but that it can continue operation if no
alternative exists. The operational state of the device will transition to
DEVI_DEVICE_DEGRADED.


DDI_SERVICE_RESTORED

The service provided by the device has been restored. The operational state of
the device will transition to its pre-error condition state and
DEVI_DEVICE_DOWN or 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 attributes:


ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityCommitted


 SEE ALSO

fmd(1M), attributes(5), ddi_fm_ereport_post(9F),
pci_ereport_post(9F)