summaryrefslogtreecommitdiffstats
path: root/doc/functions/gnutls_ciphersuite_get
blob: 045649c1b42e1bf3e25f39296e0e13a7ef776942 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
@deftypefun {const char *} {gnutls_ciphersuite_get} (gnutls_session_t @var{session})
@var{session}: is a @code{gnutls_session_t}  type.

Get the canonical name of negotiated TLS ciphersuite.  The names
returned by this function match the IANA registry, with one
exception:

TLS_DHE_DSS_RC4_128_SHA @{ 0x00, 0x66 @}

which is reserved for compatibility.

To get a detailed description of the current ciphersuite, it is
recommended to use @code{gnutls_session_get_desc()} .

@strong{Returns:} a string that contains the canonical name of a TLS ciphersuite,
or @code{NULL}  if the handshake is not completed.

@strong{Since:} 3.7.4
@end deftypefun