1gnutls_heartbeat_ping(3)            gnutls            gnutls_heartbeat_ping(3)
2
3
4

NAME

6       gnutls_heartbeat_ping - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_heartbeat_ping(gnutls_session_t  session, size_t data_size,
12       unsigned int max_tries, unsigned int flags);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t structure.
17
18       size_t data_size
19                   is the length of the ping payload.
20
21       unsigned int max_tries
22                   if flags is GNUTLS_HEARTBEAT_WAIT then this sets the number
23                   of  retransmissions.  Use  zero for indefinite (until time‐
24                   out).
25
26       unsigned int flags
27                   if GNUTLS_HEARTBEAT_WAIT then  wait  for  pong  or  timeout
28                   instead of returning immediately.
29

DESCRIPTION

31       This  function  sends  a  ping  to  the  peer.  If the  flags is set to
32       GNUTLS_HEARTBEAT_WAIT then it waits for a reply from the peer.
33
34       Note that it is highly recommended to use this function with  the  flag
35       GNUTLS_HEARTBEAT_WAIT,  or you need to handle retransmissions and time‐
36       outs manually.
37

RETURNS

39       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
40

SINCE

42       3.1.2
43

REPORTING BUGS

45       Report bugs to <bugs@gnutls.org>.
46       Home page: http://www.gnutls.org
47
48
50       Copyright © 2001-2014 Free Software Foundation, Inc..
51       Copying and distribution of this file, with  or  without  modification,
52       are  permitted  in  any  medium  without royalty provided the copyright
53       notice and this notice are preserved.
54

SEE ALSO

56       The full documentation for gnutls is maintained as  a  Texinfo  manual.
57       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
58       visit
59
60       http://www.gnutls.org/manual/
61
62gnutls                              3.3.29            gnutls_heartbeat_ping(3)
Impressum