pdiag_restore_multifunc_state
Purpose
Restores a device and its children to their initial state before testing.
Syntax
#include <sys/pdiag_def.h>
int32 pdiag_restore_multifunc_state (char *device_instance, int eeh_activate)
Description
The pdiag_restore_multifunc_state subroutine puts the device, and its children if necessary, back to the original state before the pdiag_diagnose_multifunc_state routine was called.
This function is platform-implementation specific. Its main purpose is to make sure that the target device is back in its original state before diagnostic functions were performed on the device and the Enhanced Error handling (EEH) option is returned to the state originally encountered. If the device is already in the correct state, this function should return a successful status. If an error occurs, this function should return a non-zero.
The diag_cfg_errno global variable will be set to the return value of the method invoked for the device.
Parameters
| Parameter | Description |
|---|---|
| device_instance | Name of device under test. |
| eeh_activate |
|
Return Value
The pdiag_restore_multifunc_state function returns one of the following values:
| Return Value | Description |
|---|---|
| 0 | Successful return |
| -1 | Software error |
| 1 | Error returned from device method. The diag_cfg_errno variable contains the error code from the device method. Refer to the/usr/include/cf.h file. The E_FINDCHILD and E_NEWCHILD values are not failures. |
| -2 | Hardware error |