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

개요

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

dlpi_set_timeout(3dlpi)

dl...ut(3DLPI)  Data Link Provider Interface Library Functions  dl...ut(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 en‐
       couraged 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 re‐
       stored.

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                   dl...ut(3DLPI)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3