diag_get_device_flag

Edit online

Purpose

Obtain device flag from residual data information.

Attention: This diagnostic library function has been removed in AIX® 5.2 but the information has been left in for reference.

Syntax


#include    <diag/diag.h>
#include    <sys/residual.h>

int  diag_get_device_flag (
                                 char            *device_name,
                                 long            *Flag)

Description

The diag_get_device_flagsubroutine searches residual data for an object matching the devicespecified by device_name. The value of the Flags field asdefined in the DEVICE_ID structure for the device is returned inthe Flag argument.

Implementation Specifics

POWER® processor-based

Parameters

Parameter Description
device_name Pointer to a character string containing the logical name of the device.
Flag Pointer to a long integer where the value of the Flag field in the DEVICE_ID structure as defined by sys/residual.h header file will be written.

Return Value

Upon successful completion, a 0 isreturned if the device flag information was retrieved successfully. If thediag_get_device_flag fails, a value of -1 is returned.