MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 1 | SYNOPSIS |
Zesstra | d59c389 | 2019-11-28 20:53:39 +0100 | [diff] [blame] | 2 | #include <tls.h> |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 3 | |
| 4 | string hmac(int method, string key, string arg ) |
Zesstra | d59c389 | 2019-11-28 20:53:39 +0100 | [diff] [blame] | 5 | string hmac(int method, string key, bytes arg ) |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 6 | string hmac(int method, string key, int * arg ) |
Zesstra | d59c389 | 2019-11-28 20:53:39 +0100 | [diff] [blame] | 7 | string hmac(int method, bytes key, string arg ) |
| 8 | string hmac(int method, bytes key, bytes arg ) |
| 9 | string hmac(int method, bytes key, int * arg ) |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 10 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 11 | DESCRIPTION |
| 12 | Calculate the Hashed Message Authenication Code for <arg> based |
| 13 | on the digest <method> and the password <key>. Return the HMAC. |
| 14 | Any strings given as <key> or <arg> are converted to a UTF-8 |
| 15 | byte sequence before being used. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 16 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 17 | <method> is one of the TLS_HASH_ constants defined in tls.h; not |
| 18 | all recognized methods may be supported for a given driven: |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 19 | |
| 20 | TLS_HASH_SHA1 (1) |
| 21 | TLS_HASH_SHA224 (2) |
| 22 | TLS_HASH_SHA256 (3) |
| 23 | TLS_HASH_SHA384 (4) |
| 24 | TLS_HASH_SHA512 (5) |
| 25 | TLS_HASH_MD5 (6) |
| 26 | TLS_HASH_RIPEMD160 (7) |
| 27 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 28 | If the driver is compiled without OpenSSL or GCrypt support |
| 29 | an error is thrown. |
Zesstra | d59c389 | 2019-11-28 20:53:39 +0100 | [diff] [blame] | 30 | |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 31 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 32 | EXAMPLES |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 33 | string s; |
| 34 | |
| 35 | s = hmac(TLS_HASH_SHA1, "secret", "Hello"); |
| 36 | s = hmac(TLS_HASH_SHA1, "secret", ({ 'H', 'e', 'l', 'l', 'o' }) ) |
| 37 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 38 | HISTORY |
| 39 | Introduced in LDMud 3.3.714. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 40 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 41 | SEE ALSO |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 42 | crypt(E), md5(E), md5_crypt(E), sha1(E), hmac(E) |