Puts the device under test into the correct state for testing.
#include <sys/pdiag_def.h> int32 pdiag_diagnose_state ( char *device_instance )
The pdiag_diagnose_state subroutine unconfigures the device, and its children if necessary, to set the device into the DIAGNOSE state. Original states of all devices changed will be saved. Use pdiag_restore_state to put the changed devices back to their original states.
This function is platform-implementation specific. Its main purpose is to make sure that the target device is in the correct state for diagnostic purposes. If the device is already in a diagnostic state, or any state allowed by the operating system for this purpose, then this function should return successful status. If an error occurs, then this function should return a non-zero.
The global variable diag_cfg_errno will be set to the return value of the method invoked for the device.
| device_instance | Name of the device under test. |
The pdiag_diagnose_state subroutine returns one of the following values:
| 0 | Successful return. |
| -1 | Software error. |
| 1 | Child device cannot be unconfigured. |
| 2 | Device cannot be unconfigured. |
| 3 | Device cannot be put into DIAGNOSE state. |