'\" te
.\" Copyright (c) 1998, Sun Microsystems, Inc.  All Rights Reserved
.TH di_prom_prop_data 3DEVINFO "1 Dec 1998" "SunOS 5.11" "Device Information Library Functions"
.SH NAME
di_prom_prop_data, di_prom_prop_next, di_prom_prop_name \- access PROM device information
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-ldevinfo\fR [ \fIlibrary\fR... ]
#include <libdevinfo.h>

\fBdi_prom_prop_t\fR \fBdi_prom_prop_next\fR(\fBdi_prom_handle_t\fR \fIph\fR, \fBdi_node_t\fR \fInode\fR,
     \fBdi_prom_prop_t\fR \fIprom_prop\fR);
.fi

.LP
.nf
\fBchar *\fR\fBdi_prom_prop_name\fR(\fBdi_prom_prop_t\fR \fIprom_prop\fR);
.fi

.LP
.nf
\fBint\fR \fBdi_prom_prop_data\fR(\fBdi_prom_prop_t\fR \fIprom_prop\fR, \fBuchar_t **\fR\fIprop_data\fR);
.fi

.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fInode\fR\fR
.ad
.RS 13n
.rt  
Handle to a device node in the snapshot of kernel device tree.
.RE

.sp
.ne 2
.mk
.na
\fB\fIph\fR\fR
.ad
.RS 13n
.rt  
\fBPROM\fR handle
.RE

.sp
.ne 2
.mk
.na
\fB\fIprom_prop\fR\fR
.ad
.RS 13n
.rt  
Handle to a \fBPROM\fR property.
.RE

.sp
.ne 2
.mk
.na
\fB\fIprop_data\fR\fR
.ad
.RS 13n
.rt  
Address of a pointer.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBdi_prom_prop_next()\fR function obtains a handle to the next property on the \fBPROM\fR property list associated with \fInode\fR. If \fIprom_prop\fR is \fBDI_PROM_PROP_NIL\fR, the first property associated with \fInode\fR is returned.
.sp
.LP
The \fBdi_prom_prop_name()\fR function returns the name of the \fIprom_prop\fR property.
.sp
.LP
The \fBdi_prom_prop_data()\fR function returns the value of the \fIprom_prop\fR property. The return value is a non-negative integer specifying the size in number of bytes in \fIprop_data\fR.
.sp
.LP
All memory allocated by these functions is managed by the library and must not be freed by the caller.
.SH RETURN VALUES
.sp
.LP
The \fBdi_prom_prop_data()\fR function returns the number of bytes in \fIprop_data\fR and \fIprop_data\fR is updated to point to a byte array containing the property value. If  0 is returned, the property is a boolean property and the existence of this property indicates the value is true.
.sp
.LP
The \fBdi_prom_prop_name()\fR function returns a pointer to a string that contains the name of \fIprom_prop\fR.
.sp
.LP
The \fBdi_prom_prop_next()\fR function returns a handle to the next \fBPROM\fR property. \fBDI_PROM_PROP_NIL\fR is returned if no additional properties exist.
.SH ERRORS
.sp
.LP
See \fBopenprom\fR(7D) for a description of possible errors.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelSafe
.TE

.SH SEE ALSO
.sp
.LP
\fBattributes\fR(5), \fBopenprom\fR(7D)
.sp
.LP
\fIWriting Device Drivers for Oracle Solaris 11.2\fR