Data Link Provider Interface Library Functions     dlpifd(3DLPI)



NAME
     dlpifd - get DLPI file descriptor

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

     int dlpifd(dlpihandlet dh);


DESCRIPTION
     The dlpifd() function returns the integer  file  descriptor
     that can be used to directly operate on the open DLPI stream
     associated with the DLPI handle dh. This file descriptor can
     be used to perform non-DLPI operations that do not alter the
     state of the DLPI stream, such as waiting for an event using
     poll(2),  or  pushing  and  configuring  additional  STREAMS
     modules, such as pfmod(7M). If DLPI operations are  directly
     performed  on  the  file  descriptor, or a STREAMS module is
     pushed that alters the message-passing interface  such  that
     DLPI  operations  can no longer be issued, future operations
     on dh might not behave as documented.


     The returned file descriptor is managed by libdlpi(3LIB) and
     the descriptor must not be closed.

RETURN VALUES
     The function returns the integer file descriptor  associated
     with the DLPI handle dh. If dh is invalid, -1 is returned.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     poll(2), libdlpi(3LIB), attributes(5), dlpi(7P), pfmod(7M)







SunOS 5.11          Last change: 15 Jun 2007                    1