di_prom_init(3DEVINFO)				       Device Information Library Functions				    di_prom_init(3DEVINFO)

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(3DEV-
       INFO) 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 TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.11							    1 Dec 1998						    di_prom_init(3DEVINFO)