Home

di_prom_init (3devinfo) manual page

Table of Contents

Name

di_prom_init, di_prom_fini - create and destroy a handle to the PROM device information

Synopsis

cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h>

di_prom_handle_t di_prom_init(void);

void di_prom_fini(di_prom_handle_t ph);

Parameters

ph
Handle to prom returned by di_prom_init().

Description

For device nodes whose nodeid value is DI_PROM_NODEID (see di_nodeid(3DEVINFO) ), additional properties can be retrieved from the PROM. The di_prom_init() function returns a handle that is used to retrieve such properties. This handle is passed to di_prom_prop_lookup_bytes(3DEVINFO) and di_prom_prop_next(3DEVINFO) .

The di_prom_fini() function destroys the handle and all handles to the PROM device information obtained from that handle.

Return Values

Upon successful completion, di_prom_init() returns a handle. Otherwise, DI_PROM_HANDLE_NIL is returned and errno is set to indicate the error.

Errors

The di_prom_init() sets errno function to any error code that can also be set by openprom(7D) or malloc(3C) .

Attributes

See attributes(5) for descriptions of the following attributes:

tab() allbox; cw(2.750000i)| cw(2.750000i) lw(2.750000i) lw(2.750000i). ATTRIBUTE TYPEATTRIBUTE VALUE Interface StabilityEvolving MT-LevelSafe

See Also

di_nodeid(3DEVINFO) ,
di_prom_prop_next(3DEVINFO) , di_prom_prop_lookup_bytes(3DEVINFO) , libdevinfo(3LIB) , malloc(3C) , attributes(5) , openprom(7D)

Table of Contents