Content-type: text/html Man page of di_prom_init

di_prom_init

Section: Device Information Library Functions (3DEVINFO)
Updated: 1 Dec 1998
Index Return to Main 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:

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)


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:19 GMT, October 02, 2010