DI_PROM_INIT(3DEVINFO) Device Information Library Functions
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(4D) or
malloc(3C).
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
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
DI_PROM_INIT(3DEVINFO)