1  /*
2   * TLSv1 Record Protocol
3   * Copyright (c) 2006-2011, Jouni Malinen <j@w1.fi>
4   *
5   * This software may be distributed under the terms of the BSD license.
6   * See README for more details.
7   */
8  
9  #ifndef TLSV1_RECORD_H
10  #define TLSV1_RECORD_H
11  
12  #include "crypto/crypto.h"
13  
14  #define TLS_MAX_WRITE_MAC_SECRET_LEN 32
15  #define TLS_MAX_WRITE_KEY_LEN 32
16  #define TLS_MAX_IV_LEN 16
17  #define TLS_MAX_KEY_BLOCK_LEN (2 * (TLS_MAX_WRITE_MAC_SECRET_LEN + \
18  				    TLS_MAX_WRITE_KEY_LEN + TLS_MAX_IV_LEN))
19  
20  #define TLS_SEQ_NUM_LEN 8
21  #define TLS_RECORD_HEADER_LEN 5
22  
23  /* ContentType */
24  enum {
25  	TLS_CONTENT_TYPE_CHANGE_CIPHER_SPEC = 20,
26  	TLS_CONTENT_TYPE_ALERT = 21,
27  	TLS_CONTENT_TYPE_HANDSHAKE = 22,
28  	TLS_CONTENT_TYPE_APPLICATION_DATA = 23
29  };
30  
31  struct tlsv1_record_layer {
32  	u16 tls_version;
33  
34  	u8 write_mac_secret[TLS_MAX_WRITE_MAC_SECRET_LEN];
35  	u8 read_mac_secret[TLS_MAX_WRITE_MAC_SECRET_LEN];
36  	u8 write_key[TLS_MAX_WRITE_KEY_LEN];
37  	u8 read_key[TLS_MAX_WRITE_KEY_LEN];
38  	u8 write_iv[TLS_MAX_IV_LEN];
39  	u8 read_iv[TLS_MAX_IV_LEN];
40  
41  	size_t hash_size;
42  	size_t key_material_len;
43  	size_t iv_size; /* also block_size */
44  
45  	enum crypto_hash_alg hash_alg;
46  	enum crypto_cipher_alg cipher_alg;
47  
48  	u8 write_seq_num[TLS_SEQ_NUM_LEN];
49  	u8 read_seq_num[TLS_SEQ_NUM_LEN];
50  
51  	u16 cipher_suite;
52  	u16 write_cipher_suite;
53  	u16 read_cipher_suite;
54  
55  	struct crypto_cipher *write_cbc;
56  	struct crypto_cipher *read_cbc;
57  };
58  
59  
60  int tlsv1_record_set_cipher_suite(struct tlsv1_record_layer *rl,
61  				  u16 cipher_suite);
62  int tlsv1_record_change_write_cipher(struct tlsv1_record_layer *rl);
63  int tlsv1_record_change_read_cipher(struct tlsv1_record_layer *rl);
64  int tlsv1_record_send(struct tlsv1_record_layer *rl, u8 content_type, u8 *buf,
65  		      size_t buf_size, const u8 *payload, size_t payload_len,
66  		      size_t *out_len);
67  int tlsv1_record_receive(struct tlsv1_record_layer *rl,
68  			 const u8 *in_data, size_t in_len,
69  			 u8 *out_data, size_t *out_len, u8 *alert);
70  
71  #endif /* TLSV1_RECORD_H */
72