]> asedeno.scripts.mit.edu Git - PuTTY.git/blob - ssh.h
b999c665236ea99ce766b1c421655d59c18e483e
[PuTTY.git] / ssh.h
1 #include <string.h>
2
3 /*
4  * Useful thing.
5  */
6 #ifndef lenof
7 #define lenof(x) ( (sizeof((x))) / (sizeof(*(x))))
8 #endif
9
10 #define SSH_CIPHER_IDEA         1
11 #define SSH_CIPHER_DES          2
12 #define SSH_CIPHER_3DES         3
13 #define SSH_CIPHER_BLOWFISH     6
14
15 #ifdef MSCRYPTOAPI
16 #define APIEXTRA 8
17 #else
18 #define APIEXTRA 0
19 #endif
20
21 /*
22  * A Bignum is stored as a sequence of `unsigned short' words. The
23  * first tells how many remain; the remaining ones are digits, LS
24  * first.
25  */
26 typedef unsigned short *Bignum;
27
28 struct RSAKey {
29     int bits;
30     int bytes;
31 #ifdef MSCRYPTOAPI
32     unsigned long exponent;
33     unsigned char *modulus;
34 #else
35     Bignum modulus;
36     Bignum exponent;
37     Bignum private_exponent;
38 #endif
39     char *comment;
40 };
41
42 struct RSAAux {
43     Bignum p;
44     Bignum q;
45     Bignum iqmp;
46 };
47
48 int makekey(unsigned char *data, struct RSAKey *result,
49             unsigned char **keystr, int order);
50 int makeprivate(unsigned char *data, struct RSAKey *result);
51 void rsaencrypt(unsigned char *data, int length, struct RSAKey *key);
52 Bignum rsadecrypt(Bignum input, struct RSAKey *key);
53 void rsasign(unsigned char *data, int length, struct RSAKey *key);
54 void rsasanitise(struct RSAKey *key);
55 int rsastr_len(struct RSAKey *key);
56 void rsastr_fmt(char *str, struct RSAKey *key);
57 void rsa_fingerprint(char *str, int len, struct RSAKey *key);
58 void freersakey(struct RSAKey *key);
59
60 typedef unsigned int word32;
61 typedef unsigned int uint32;
62
63 unsigned long crc32(const void *s, size_t len);
64
65 typedef struct {
66     uint32 h[4];
67 } MD5_Core_State;
68
69 struct MD5Context {
70 #ifdef MSCRYPTOAPI
71     unsigned long hHash;
72 #else
73     MD5_Core_State core;
74     unsigned char block[64];
75     int blkused;
76     uint32 lenhi, lenlo;
77 #endif
78 };
79
80 void MD5Init(struct MD5Context *context);
81 void MD5Update(struct MD5Context *context, unsigned char const *buf,
82                unsigned len);
83 void MD5Final(unsigned char digest[16], struct MD5Context *context);
84
85 typedef struct {
86     uint32 h[5];
87     unsigned char block[64];
88     int blkused;
89     uint32 lenhi, lenlo;
90 } SHA_State;
91
92 void SHA_Init(SHA_State *s);
93 void SHA_Bytes(SHA_State *s, void *p, int len);
94 void SHA_Final(SHA_State *s, unsigned char *output);
95 void SHA_Simple(void *p, int len, unsigned char *output);
96
97 struct ssh_cipher {
98     void (*sesskey)(unsigned char *key);   /* for ssh 1 */
99     void (*setcsiv)(unsigned char *key);   /* for ssh 2 */
100     void (*setcskey)(unsigned char *key);   /* for ssh 2 */
101     void (*setsciv)(unsigned char *key);   /* for ssh 2 */
102     void (*setsckey)(unsigned char *key);   /* for ssh 2 */
103     void (*encrypt)(unsigned char *blk, int len);
104     void (*decrypt)(unsigned char *blk, int len);
105     char *name;
106     int blksize;
107 };
108
109 struct ssh_mac {
110     void (*setcskey)(unsigned char *key);
111     void (*setsckey)(unsigned char *key);
112     void (*generate)(unsigned char *blk, int len, unsigned long seq);
113     int (*verify)(unsigned char *blk, int len, unsigned long seq);
114     char *name;
115     int len;
116 };
117
118 struct ssh_kex {
119     /*
120      * Plugging in another KEX algorithm requires structural chaos,
121      * so it's hard to abstract them into nice little structures
122      * like this. Hence, for the moment, this is just a
123      * placeholder. I claim justification in the fact that OpenSSH
124      * does this too :-)
125      */
126     char *name;
127 };
128
129 struct ssh_signkey {
130     void *(*newkey)(char *data, int len);
131     void (*freekey)(void *key);
132     char *(*fmtkey)(void *key);
133     char *(*fingerprint)(void *key);
134     int (*verifysig)(void *key, char *sig, int siglen,
135                      char *data, int datalen);
136     int (*sign)(void *key, char *sig, int siglen,
137                 char *data, int datalen);
138     char *name;
139     char *keytype;                     /* for host key cache */
140 };
141
142 struct ssh_compress {
143     char *name;
144     void (*compress_init)(void);
145     int (*compress)(unsigned char *block, int len,
146                     unsigned char **outblock, int *outlen);
147     void (*decompress_init)(void);
148     int (*decompress)(unsigned char *block, int len,
149                       unsigned char **outblock, int *outlen);
150 };
151
152 #ifndef MSCRYPTOAPI
153 void SHATransform(word32 *digest, word32 *data);
154 #endif
155
156 int random_byte(void);
157 void random_add_noise(void *noise, int length);
158 void random_add_heavynoise(void *noise, int length);
159
160 void logevent (char *);
161
162 Bignum newbn(int length);
163 Bignum copybn(Bignum b);
164 Bignum bignum_from_short(unsigned short n);
165 void freebn(Bignum b);
166 Bignum modpow(Bignum base, Bignum exp, Bignum mod);
167 Bignum modmul(Bignum a, Bignum b, Bignum mod);
168 void decbn(Bignum n);
169 extern Bignum Zero, One;
170 int ssh1_read_bignum(unsigned char *data, Bignum *result);
171 int ssh1_bignum_bitcount(Bignum bn);
172 int ssh1_bignum_length(Bignum bn);
173 int bignum_byte(Bignum bn, int i);
174 int bignum_bit(Bignum bn, int i);
175 void bignum_set_bit(Bignum bn, int i, int value);
176 int ssh1_write_bignum(void *data, Bignum bn);
177 Bignum biggcd(Bignum a, Bignum b);
178 unsigned short bignum_mod_short(Bignum number, unsigned short modulus);
179 Bignum bignum_add_long(Bignum number, unsigned long addend);
180 Bignum bigmul(Bignum a, Bignum b);
181 Bignum modinv(Bignum number, Bignum modulus);
182 Bignum bignum_rshift(Bignum number, int shift);
183 int bignum_cmp(Bignum a, Bignum b);
184 char *bignum_decimal(Bignum x);
185
186 Bignum dh_create_e(void);
187 Bignum dh_find_K(Bignum f);
188
189 int loadrsakey(char *filename, struct RSAKey *key, struct RSAAux *aux,
190                char *passphrase);
191 int rsakey_encrypted(char *filename, char **comment);
192
193 int saversakey(char *filename, struct RSAKey *key, struct RSAAux *aux,
194                char *passphrase);
195
196 void des3_decrypt_pubkey(unsigned char *key,
197                          unsigned char *blk, int len);
198 void des3_encrypt_pubkey(unsigned char *key,
199                          unsigned char *blk, int len);
200
201 /*
202  * For progress updates in the key generation utility.
203  */
204 typedef void (*progfn_t)(void *param, int phase, int progress);
205
206 int rsa_generate(struct RSAKey *key, struct RSAAux *aux, int bits,
207                  progfn_t pfn, void *pfnparam);
208 Bignum primegen(int bits, int modulus, int residue,
209                 int phase, progfn_t pfn, void *pfnparam);
210
211 /*
212  * zlib compression.
213  */
214 void zlib_compress_init(void);
215 void zlib_decompress_init(void);
216 int zlib_compress_block(unsigned char *block, int len,
217                         unsigned char **outblock, int *outlen);
218 int zlib_decompress_block(unsigned char *block, int len,
219                           unsigned char **outblock, int *outlen);