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

diag_get_property

Purpose

Obtain property value from Common Hardware Reference Platform (CHRP) firmware for a resource.

Syntax

#include    <diag/diag.h>

char  *diag_get_property ( 
                                 char             *device_name,
                                 char             *property_name,
                                 int              *property_length)

Description

The diag_get_property subroutine searches the Open Firmware device tree to obtain the value of a property associated with the specified resource. The resource must be a valid ODM resource name with a corresponding Open Firmware device tree node. If the resource's corresponding node is not found in the Open Firmware device tree, or if the property value is not found, then a char *NULL is returned.

Parameters

device_name Pointer to a character string containing the logical name of the device.
property_name Pointer to a character string containing the property to find.
property_length Contains total number of characters pointed to by the return character value.

Return Value

Upon successful completion, a character string is returned containing the value (or values) of the property requested. Multiple values may be separated by a NULL value. If the resource is not valid, or the property value is not found, then a char *NULL is returned.

[ Previous | Next | Contents | Home | Search ]