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