xref: /freebsd/crypto/openssh/cipher.h (revision fed1ca4b719c56c930f2259d80663cd34be812bb)
1 /* $OpenBSD: cipher.h,v 1.48 2015/07/08 19:09:25 markus Exp $ */
2 
3 /*
4  * Author: Tatu Ylonen <ylo@cs.hut.fi>
5  * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
6  *                    All rights reserved
7  *
8  * As far as I am concerned, the code I have written for this software
9  * can be used freely for any purpose.  Any derived versions of this
10  * software must be clearly marked as such, and if the derived work is
11  * incompatible with the protocol description in the RFC file, it must be
12  * called by a name other than "ssh" or "Secure Shell".
13  *
14  * Copyright (c) 2000 Markus Friedl.  All rights reserved.
15  *
16  * Redistribution and use in source and binary forms, with or without
17  * modification, are permitted provided that the following conditions
18  * are met:
19  * 1. Redistributions of source code must retain the above copyright
20  *    notice, this list of conditions and the following disclaimer.
21  * 2. Redistributions in binary form must reproduce the above copyright
22  *    notice, this list of conditions and the following disclaimer in the
23  *    documentation and/or other materials provided with the distribution.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
26  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
27  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
28  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
29  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
30  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
34  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35  */
36 
37 #ifndef CIPHER_H
38 #define CIPHER_H
39 
40 #include <sys/types.h>
41 #include <openssl/evp.h>
42 #include "cipher-chachapoly.h"
43 #include "cipher-aesctr.h"
44 
45 /*
46  * Cipher types for SSH-1.  New types can be added, but old types should not
47  * be removed for compatibility.  The maximum allowed value is 31.
48  */
49 #define SSH_CIPHER_SSH2		-3
50 #define SSH_CIPHER_INVALID	-2	/* No valid cipher selected. */
51 #define SSH_CIPHER_NOT_SET	-1	/* None selected (invalid number). */
52 #define SSH_CIPHER_NONE		0	/* no encryption */
53 #define SSH_CIPHER_IDEA		1	/* IDEA CFB */
54 #define SSH_CIPHER_DES		2	/* DES CBC */
55 #define SSH_CIPHER_3DES		3	/* 3DES CBC */
56 #define SSH_CIPHER_BROKEN_TSS	4	/* TRI's Simple Stream encryption CBC */
57 #define SSH_CIPHER_BROKEN_RC4	5	/* Alleged RC4 */
58 #define SSH_CIPHER_BLOWFISH	6
59 #define SSH_CIPHER_RESERVED	7
60 #define SSH_CIPHER_MAX		31
61 
62 #define CIPHER_ENCRYPT		1
63 #define CIPHER_DECRYPT		0
64 
65 struct sshcipher;
66 struct sshcipher_ctx {
67 	int	plaintext;
68 	int	encrypt;
69 	EVP_CIPHER_CTX evp;
70 	struct chachapoly_ctx cp_ctx; /* XXX union with evp? */
71 	struct aesctr_ctx ac_ctx; /* XXX union with evp? */
72 	const struct sshcipher *cipher;
73 };
74 
75 u_int	 cipher_mask_ssh1(int);
76 const struct sshcipher *cipher_by_name(const char *);
77 const struct sshcipher *cipher_by_number(int);
78 int	 cipher_number(const char *);
79 char	*cipher_name(int);
80 const char *cipher_warning_message(const struct sshcipher_ctx *);
81 int	 ciphers_valid(const char *);
82 char	*cipher_alg_list(char, int);
83 int	 cipher_init(struct sshcipher_ctx *, const struct sshcipher *,
84     const u_char *, u_int, const u_char *, u_int, int);
85 int	 cipher_crypt(struct sshcipher_ctx *, u_int, u_char *, const u_char *,
86     u_int, u_int, u_int);
87 int	 cipher_get_length(struct sshcipher_ctx *, u_int *, u_int,
88     const u_char *, u_int);
89 int	 cipher_cleanup(struct sshcipher_ctx *);
90 int	 cipher_set_key_string(struct sshcipher_ctx *, const struct sshcipher *,
91     const char *, int);
92 u_int	 cipher_blocksize(const struct sshcipher *);
93 u_int	 cipher_keylen(const struct sshcipher *);
94 u_int	 cipher_seclen(const struct sshcipher *);
95 u_int	 cipher_authlen(const struct sshcipher *);
96 u_int	 cipher_ivlen(const struct sshcipher *);
97 u_int	 cipher_is_cbc(const struct sshcipher *);
98 
99 u_int	 cipher_get_number(const struct sshcipher *);
100 int	 cipher_get_keyiv(struct sshcipher_ctx *, u_char *, u_int);
101 int	 cipher_set_keyiv(struct sshcipher_ctx *, const u_char *);
102 int	 cipher_get_keyiv_len(const struct sshcipher_ctx *);
103 int	 cipher_get_keycontext(const struct sshcipher_ctx *, u_char *);
104 void	 cipher_set_keycontext(struct sshcipher_ctx *, const u_char *);
105 #endif				/* CIPHER_H */
106