eeh_enable_slot Kernel Service

Purpose

This service enables a slot for the EEH operations.

Syntax

#include <sys/eeh.h>

long eeh_enable_slot(handle)
eeh_handle_t handle;

Parameters

Item Description
handle EEH handle obtained from theeeh_init kernel service

Description

This service enables EEH operation on a slot so that when certain errors occur on a PCI bus, the slot will freeze (that is, PIO and DMA are disabled, which prevents potential system crash, data corruption, and so on). This service can only be called by the single-function adapter drivers. If the service fails for hardware or firmware reasons, an error is logged.

Multifunction drivers call this service indirectly via eeh_init_multifunc(). It fails with EEH_FAIL if called directly by a multifunction driver.

The macro EEH_ENABLE_SLOT(handle) is provided for device drivers to call this service.

Execution Environment

This kernel service can be called from the process or interrupt environment.

Return Values

Item Description
EEH_SUCC Slot successfully enabled
EEH_FAIL Unable to enable the slot