@deftypefun {void} {gnutls_transport_set_pull_timeout_function} (gnutls_session_t @var{session}, gnutls_pull_timeout_func @var{func})

@var{session}: is a @code{gnutls_session_t}  type.

@var{func}: a callback function

This is the function where you set a function for gnutls to know

whether data are ready to be received. It should wait for data a

given time frame in milliseconds. The callback should return 0 on 

timeout, a positive number if data can be received, and -1 on error.

You'll need to override this function if @code{select()}  is not suitable

for the provided transport calls.

As with @code{select()} , if the timeout value is zero the callback should return

zero if no data are immediately available. The special value

@code{GNUTLS_INDEFINITE_TIMEOUT}  indicates that the callback should wait indefinitely

for data.

 @code{gnutls_pull_timeout_func} is of the form,

int (*gnutls_pull_timeout_func)(gnutls_transport_ptr_t, unsigned int ms);

This callback is necessary when @code{gnutls_handshake_set_timeout()}  or 

@code{gnutls_record_set_timeout()}  are set, under TLS1.3 and for enforcing the DTLS

mode timeouts when in blocking mode.

For compatibility with future GnuTLS versions this callback must be set when

a custom pull function is registered. The callback will not be used when the

session is in TLS mode with non-blocking sockets. That is, when @code{GNUTLS_NONBLOCK} 

is specified for a TLS session in @code{gnutls_init()} .

The helper function @code{gnutls_system_recv_timeout()}  is provided to

simplify writing callbacks. 

@strong{Since:} 3.0

@end deftypefun