| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame^] | 1 | PRELIMINARY |
| 2 | SYNOPSIS |
| 3 | #include <sys/ tls.h> |
| 4 | int *tls_query_connection_info (object ob) |
| 5 | |
| 6 | DESCRIPTION |
| 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 | |
| 31 | HISTORY |
| 32 | Introduced in LDMud 3.3.474 and following, backported to 3.2.11. |
| 33 | |
| 34 | SEE 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) |