[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Understanding the Diagnostic Subsystem for AIX



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.

Return Value

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.

[ Previous | Next | Contents | Home | Search ]