1gnutls_session_key_update(3)        gnutls        gnutls_session_key_update(3)
2
3
4

NAME

6       gnutls_session_key_update - API function
7

SYNOPSIS

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

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t type.
17
18       unsigned flags
19                   zero of GNUTLS_KU_PEER
20

DESCRIPTION

22       This function will update/refresh the session keys when the TLS  proto‐
23       col  is  1.3 or better. The peer is notified of the update by sending a
24       message,  so   this   function   should   be   treated   similarly   to
25       gnutls_record_send()   --i.e.,   it   may   return   GNUTLS_E_AGAIN  or
26       GNUTLS_E_INTERRUPTED.
27
28       When this flag GNUTLS_KU_PEER is specified, this function  in  addition
29       to updating the local keys, will ask the peer to refresh its keys too.
30
31       If  the  negotiated version is not TLS 1.3 or better this function will
32       return GNUTLS_E_INVALID_REQUEST.
33

RETURNS

35       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
36

SINCE

38       3.6.3
39

REPORTING BUGS

41       Report bugs to <bugs@gnutls.org>.
42       Home page: https://www.gnutls.org
43
44

46       Copyright © 2001- Free Software Foundation, Inc., and others.
47       Copying and distribution of this file, with  or  without  modification,
48       are  permitted in any medium without royalty provided the copyright no‐
49       tice and this notice are preserved.
50

SEE ALSO

52       The full documentation for gnutls is maintained as  a  Texinfo  manual.
53       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
54       visit
55
56       https://www.gnutls.org/manual/
57
58gnutls                               3.7.6        gnutls_session_key_update(3)
Impressum