dlpi_set_timeout(3dlpi) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

dlpi_set_timeout(3dlpi)

Data Link Provider Interface Library Functions         dlpi_set_timeout(3DLPI)



NAME
       dlpi_set_timeout - set DLPI handle timeout interval

SYNOPSIS
       cc [ flag ... ] file ... -ldlpi [ library ... ]
       #include <libdlpi.h>

       int dlpi_set_timeout(dlpi_handle_t dh, int sec);

DESCRIPTION
       The  dlpi_set_timeout()  function sets the timeout interval to sec sec‐
       onds 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  acknowl‐
       edgment  before  returning DLPI_ETIMEDOUT. Except for dlpi_recv(3DLPI),
       which has a timeout argument, any function that is documented to return
       DLPI_ETIMEDOUT 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 dlpi_set_timeout(), and allow libdlpi  to  use
       its  default  timeout  value.  The default timeout value is intended to
       ensure that DLPI_ETIMEDOUT will only be returned if the DLPI  link  has
       truly  become  unresponsive.  The  default timeout value is intended to
       ensure that DLPI_ETIMEDOUT 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 dlpi_set_timeout(). However,  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  DLPI_DEF_TIMEOUT,  the  default  timeout value is
       restored.

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

ERRORS
       DLPI_EINHANDLE    Invalid DLPI handle


ATTRIBUTES
       See attributes(7) for description of the following attributes:


       tab()  box; lw(2.75i) |lw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe


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



Oracle Solaris 11.4               21 Aug 2007          dlpi_set_timeout(3DLPI)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3