| DI_PROM_INIT(3DEVINFO) | Device Information Library Functions | DI_PROM_INIT(3DEVINFO) |
di_prom_init, di_prom_fini - create and destroy a handle to the PROM device information
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);
ph
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.
Upon successful completion, di_prom_init() returns a handle. Otherwise, DI_PROM_HANDLE_NIL is returned and errno is set to indicate the error.
The di_prom_init() sets errno function to any error code that can also be set by openprom(4D) or malloc(3C).
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Interface Stability | Evolving |
| MT-Level | Safe |
malloc(3C), di_nodeid(3DEVINFO), di_prom_prop_lookup_bytes(3DEVINFO), di_prom_prop_next(3DEVINFO), libdevinfo(3LIB), openprom(4D), attributes(7)
| December 1, 1998 | OmniOS |