Puts the device under test in the DIAGNOSE state.
#include <diag/diag.h> int diagex_cfg_state ( device_name ) char *device_name;
The diagex_cfg_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 diagex_initial_state to put the changed devices back to their original states.
The global variable diag_cfg_errno will be set to the return value of the method invoked for the device.
| Parameter | Description |
|---|---|
| device_name | Name of the device under test. |
The diagex_cfg_state subroutine returns one of the following values:
| Return Code | Description |
|---|---|
| 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. |