5 Author: Pekka Riikonen <priikone@poseidon.pspt.fi>
7 Copyright (C) 1997 - 2001 Pekka Riikonen
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
27 Default SILC cipher object to represent any cipher. The function
28 pointers are the stub functions for each implemented cipher. Following
29 short description of the fields:
33 Logical name of the cipher.
37 Block size of the cipher.
41 Length of the key of the cipher (in bits).
49 bool (*set_key)(void *, const unsigned char *, uint32);
50 bool (*set_key_with_string)(void *, const unsigned char *, uint32);
51 bool (*encrypt)(void *, const unsigned char *, unsigned char *,
52 uint32, unsigned char *);
53 bool (*decrypt)(void *, const unsigned char *, unsigned char *,
54 uint32, unsigned char *);
55 uint32 (*context_len)();
58 #define SILC_CIPHER_MAX_IV_SIZE 16
60 /* The main SilcCipher structure. Use SilcCipher instead of SilcCipherStruct.
61 Also remember that SilcCipher is a pointer. */
62 typedef struct SilcCipherStruct {
63 SilcCipherObject *cipher;
65 unsigned char iv[SILC_CIPHER_MAX_IV_SIZE];
67 void (*set_iv)(struct SilcCipherStruct *, const unsigned char *);
68 void (*get_iv)(struct SilcCipherStruct *, unsigned char *);
69 uint32 (*get_key_len)(struct SilcCipherStruct *);
70 uint32 (*get_block_len)(struct SilcCipherStruct *);
73 /* Marks for all ciphers in silc. This can be used in silc_cipher_unregister
74 to unregister all ciphers at once. */
75 #define SILC_ALL_CIPHERS ((SilcCipherObject *)1)
77 /* Static list of ciphers for silc_cipher_register_default(). */
78 extern SilcCipherObject silc_default_ciphers[];
80 /* Default cipher in the SILC protocol */
81 #define SILC_DEFAULT_CIPHER "aes-256-cbc"
85 /* Function names in SILC Crypto modules. The name of the cipher
86 is appended into these names and used to the get correct symbol out
87 of the module. All SILC Crypto API compliant modules must support
88 these function names (use macros below to assure this). */
89 #define SILC_CIPHER_SIM_SET_KEY "set_key"
90 #define SILC_CIPHER_SIM_SET_KEY_WITH_STRING "set_key_with_string"
91 #define SILC_CIPHER_SIM_ENCRYPT_CBC "encrypt_cbc"
92 #define SILC_CIPHER_SIM_DECRYPT_CBC "decrypt_cbc"
93 #define SILC_CIPHER_SIM_CONTEXT_LEN "context_len"
95 /* These macros can be used to implement the SILC Crypto API and to avoid
96 errors in the API these macros should be used always. */
97 #define SILC_CIPHER_API_SET_KEY(cipher) \
98 bool silc_##cipher##_set_key(void *context, \
99 const unsigned char *key, \
101 #define SILC_CIPHER_API_SET_KEY_WITH_STRING(cipher) \
102 bool silc_##cipher##_set_key_with_string(void *context, \
103 const unsigned char *string, \
105 #define SILC_CIPHER_API_ENCRYPT_CBC(cipher) \
106 bool silc_##cipher##_encrypt_cbc(void *context, \
107 const unsigned char *src, \
108 unsigned char *dst, \
111 #define SILC_CIPHER_API_DECRYPT_CBC(cipher) \
112 bool silc_##cipher##_decrypt_cbc(void *context, \
113 const unsigned char *src, \
114 unsigned char *dst, \
117 #define SILC_CIPHER_API_CONTEXT_LEN(cipher) \
118 uint32 silc_##cipher##_context_len()
121 bool silc_cipher_register(SilcCipherObject *cipher);
122 bool silc_cipher_unregister(SilcCipherObject *cipher);
123 bool silc_cipher_register_default(void);
124 bool silc_cipher_alloc(const unsigned char *name, SilcCipher *new_cipher);
125 void silc_cipher_free(SilcCipher cipher);
126 bool silc_cipher_is_supported(const unsigned char *name);
127 char *silc_cipher_get_supported(void);
128 bool silc_cipher_encrypt(SilcCipher cipher, const unsigned char *src,
129 unsigned char *dst, uint32 len,
131 bool silc_cipher_decrypt(SilcCipher cipher, const unsigned char *src,
132 unsigned char *dst, uint32 len,
134 bool silc_cipher_set_key(SilcCipher cipher, const unsigned char *key,
136 void silc_cipher_set_iv(SilcCipher cipher, const unsigned char *iv);
137 void silc_cipher_get_iv(SilcCipher cipher, unsigned char *iv);
138 uint32 silc_cipher_get_key_len(SilcCipher cipher);
139 uint32 silc_cipher_get_block_len(SilcCipher cipher);