blob: 32aeef7528ee741471c70217598f012820b0e832 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001PRELIMINARY
2SYNOPSIS
3 #include <sys/ tls.h>
4 int *tls_query_connection_info (object ob)
5
6DESCRIPTION
7 If <ob> does not have a TLS connection or if the connection
8 is still being set-up, or if <ob> is not interactive, the efun
9 returns 0.
10
11 If <ob> has a TLS connection, tls_query_connection_info()
12 returns an array that contains some parameters of <ob>'s
13 connection:
14
15 int|string [TLS_CIPHER]: the cipher used
16 int [TLS_COMP]: the compression used
17 int [TLS_KX]: the key-exchange used
18 int [TLS_MAC]: the digest algorithm used
19 int|string [TLS_PROT]: the protocol used
20
21 To translate these numbers into strings, <tls.h> offers a
22 number of macros:
23
24 TLS_xxx_TABLE: a literal array of strings describing the
25 value in question.
26 TLS_xxx_NAME(x): a macro translating the numeric result
27 value into a string.
28
29 xxx: CIPHER, COMP, KX, MAC, PROT
30
31HISTORY
32 Introduced in LDMud 3.3.474 and following, backported to 3.2.11.
33
34SEE ALSO
35 tls_init_connection(E), tls_deinit_connection(E), tls_error(E),
36 tls_query_connection_state(E), tls_available(E),
37 tls_check_certificate(E), tls_refresh_certs(E)