Device Information Library Functions       diprominit(3DEVINFO)



NAME
     diprominit, dipromfini - create and destroy a handle  to
     the PROM device information

SYNOPSIS
     cc [ flag... ] file... -ldevinfo [ library... ]
     #include 

     dipromhandlet diprominit(void);


     void dipromfini(dipromhandlet  ph);


PARAMETERS
     ph    Handle to prom returned by diprominit().


DESCRIPTION
     For device nodes whose nodeid value is  DIPROMNODEID  (see
     dinodeid(3DEVINFO)), additional properties can be retrieved
     from the PROM. The diprominit() function returns a  handle
     that  is  used  to  retrieve such properties. This handle is
     passed    to     dipromproplookupbytes(3DEVINFO)     and
     diprompropnext(3DEVINFO).


     The dipromfini() function destroys  the  handle   and  all
     handles  to  the  PROM device information obtained from that
     handle.

RETURN VALUES
     Upon successful completion, diprominit() returns a handle.
     Otherwise,  DIPROMHANDLENIL  is returned and errno is set
     to indicate the error.

ERORS
     The diprominit() sets errno function  to  any  error  code
     that can also be set by openprom(7D) or malloc(3C).

ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:












SunOS 5.11           Last change: 1 Dec 1998                    1






Device Information Library Functions       diprominit(3DEVINFO)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     dinodeid(3DEVINFO),            diprompropnext(3DEVINFO),
     dipromproplookupbytes(3DEVINFO),       libdevinfo(3LIB),
     malloc(3C), attributes(5), openprom(7D)










































SunOS 5.11           Last change: 1 Dec 1998                    2