Manual Pages for UNIX Operating System command usage for man di_prom_fini

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 

     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  attri-
     butes:












SunOS 5.11           Last change: 1 Dec 1998                    1






Device Information Library Functions       di_prom_init(3DEVINFO)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | 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), openprom(7D)










































SunOS 5.11           Last change: 1 Dec 1998                    2