Data Link Provider Interface Library Functions
                                          dlpisettimeout(3DLPI)



NAME
     dlpisettimeout - set DLPI handle timeout interval

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

     int dlpisettimeout(dlpihandlet dh, int sec);


DESCRIPTION
     The dlpisettimeout() function sets the timeout interval to
     sec  seconds  on  DLPI  handle  dh.  This timeout is used by
     libdlpi(3LIB) functions that require explicit acknowledgment
     from  the  associated  DLPI  link,  and bounds the number of
     seconds that a function  will  wait  for  an  acknowledgment
     before      returning     DLPIETIMEDOUT.     Except     for
     dlpirecv(3DLPI), which has a timeout argument, any function
     that  is  documented to return DLPIETIMEDOUT can take up to
     the timeout interval to complete.


     Callers that do not require an upper bound on  timeouts  are
     strongly  encouraged  to  never call dlpisettimeout(), and
     allow libdlpi to use its default timeout value. The  default
     timeout value is intended to ensure that DLPIETIMEDOUT will
     only be returned if the DLPI link has truly become unrespon-
     sive.  The  default timeout value is intended to ensure that
     DLPIETIMEDOUT will be returned only if the  DLPI  link  has
     truly become unresponsive.


     Callers that do require an explicit upper bound can  specify
     that  value at any time by calling dlpisettimeout().  How-
     ever, note that values  less  than  5  seconds  may  trigger
     spurious  failures  on  certain DLPI links and systems under
     high load, and thus are discouraged.  Attempts  to  set  the
     timeout value to less than 1 second will fail.


     If sec is set to DLPIDEFTIMEOUT, the default timeout value
     is restored.

RETURN VALUES
     Upon success, DLPISUCES is returned.  Otherwise,  a  DLPI
     error value is returned.

ERORS
     DLPIEINHANDLE    Invalid DLPI handle





SunOS 5.11          Last change: 21 Aug 2007                    1






Data Link Provider Interface Library Functions
                                          dlpisettimeout(3DLPI)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     libdlpi(3LIB), attributes(5)





































SunOS 5.11          Last change: 21 Aug 2007                    2






Data Link Provider Interface Library Functions
                                          dlpisettimeout(3DLPI)






















































SunOS 5.11          Last change: 21 Aug 2007                    3