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