Query: di_prom_init
OS: opensolaris
Section: 3devinfo
Links: opensolaris man pages all man pages
Forums: forum home forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
di_prom_init(3DEVINFO) Device Information Library Functions di_prom_init(3DEVINFO)NAMEdi_prom_init, di_prom_fini - create and destroy a handle to the PROM device informationSYNOPSIScc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> di_prom_handle_t di_prom_init(void); void di_prom_fini(di_prom_handle_t ph);PARAMETERSph Handle to prom returned by di_prom_init().DESCRIPTIONFor 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 VALUESUpon successful completion, di_prom_init() returns a handle. Otherwise, DI_PROM_HANDLE_NIL is returned and errno is set to indicate the error.ERRORSThe di_prom_init() sets errno function to any error code that can also be set by openprom(7D) or malloc(3C).ATTRIBUTESSee attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+SEE ALSOdi_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)