Restores resource and children to their initial state before testing.
#include <sys/pdiag_def.h> int32 pdiag_restore_state ( char *device_instance )
The pdiag_restore_state subroutine puts the device, and its children if necessary, back to the original state before the pdiag_diagnose_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. If the device is already in the correct state, then this function should return successful status. If an error occurs, then this function should return non-zero.
| device_instance | Name of the device under test. |
The pdiag_restore_state subroutine returns one of the following values:
| 0 | Successful return. |
| -1 | Software error. |
| 4 | Device cannot be restored to DEFINE state. |
| 5 | Device cannot be restored to AVAILABLE state. |
| 6 | Child device cannot be restored to original state. |