xref: /openbmc/linux/net/tls/tls.h (revision 9b68f30b)
1 /*
2  * Copyright (c) 2016 Tom Herbert <tom@herbertland.com>
3  * Copyright (c) 2016-2017, Mellanox Technologies. All rights reserved.
4  * Copyright (c) 2016-2017, Dave Watson <davejwatson@fb.com>. All rights reserved.
5  *
6  * This software is available to you under a choice of one of two
7  * licenses.  You may choose to be licensed under the terms of the GNU
8  * General Public License (GPL) Version 2, available from the file
9  * COPYING in the main directory of this source tree, or the
10  * OpenIB.org BSD license below:
11  *
12  *     Redistribution and use in source and binary forms, with or
13  *     without modification, are permitted provided that the following
14  *     conditions are met:
15  *
16  *      - Redistributions of source code must retain the above
17  *        copyright notice, this list of conditions and the following
18  *        disclaimer.
19  *
20  *      - Redistributions in binary form must reproduce the above
21  *        copyright notice, this list of conditions and the following
22  *        disclaimer in the documentation and/or other materials
23  *        provided with the distribution.
24  *
25  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
29  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
30  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
31  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
32  * SOFTWARE.
33  */
34 
35 #ifndef _TLS_INT_H
36 #define _TLS_INT_H
37 
38 #include <asm/byteorder.h>
39 #include <linux/types.h>
40 #include <linux/skmsg.h>
41 #include <net/tls.h>
42 
43 #define TLS_PAGE_ORDER	(min_t(unsigned int, PAGE_ALLOC_COSTLY_ORDER,	\
44 			       TLS_MAX_PAYLOAD_SIZE >> PAGE_SHIFT))
45 
46 #define __TLS_INC_STATS(net, field)				\
47 	__SNMP_INC_STATS((net)->mib.tls_statistics, field)
48 #define TLS_INC_STATS(net, field)				\
49 	SNMP_INC_STATS((net)->mib.tls_statistics, field)
50 #define TLS_DEC_STATS(net, field)				\
51 	SNMP_DEC_STATS((net)->mib.tls_statistics, field)
52 
53 /* TLS records are maintained in 'struct tls_rec'. It stores the memory pages
54  * allocated or mapped for each TLS record. After encryption, the records are
55  * stores in a linked list.
56  */
57 struct tls_rec {
58 	struct list_head list;
59 	int tx_ready;
60 	int tx_flags;
61 
62 	struct sk_msg msg_plaintext;
63 	struct sk_msg msg_encrypted;
64 
65 	/* AAD | msg_plaintext.sg.data | sg_tag */
66 	struct scatterlist sg_aead_in[2];
67 	/* AAD | msg_encrypted.sg.data (data contains overhead for hdr & iv & tag) */
68 	struct scatterlist sg_aead_out[2];
69 
70 	char content_type;
71 	struct scatterlist sg_content_type;
72 
73 	struct sock *sk;
74 
75 	char aad_space[TLS_AAD_SPACE_SIZE];
76 	u8 iv_data[MAX_IV_SIZE];
77 	struct aead_request aead_req;
78 	u8 aead_req_ctx[];
79 };
80 
81 int __net_init tls_proc_init(struct net *net);
82 void __net_exit tls_proc_fini(struct net *net);
83 
84 struct tls_context *tls_ctx_create(struct sock *sk);
85 void tls_ctx_free(struct sock *sk, struct tls_context *ctx);
86 void update_sk_prot(struct sock *sk, struct tls_context *ctx);
87 
88 int wait_on_pending_writer(struct sock *sk, long *timeo);
89 int tls_sk_query(struct sock *sk, int optname, char __user *optval,
90 		 int __user *optlen);
91 int tls_sk_attach(struct sock *sk, int optname, char __user *optval,
92 		  unsigned int optlen);
93 void tls_err_abort(struct sock *sk, int err);
94 
95 int tls_set_sw_offload(struct sock *sk, struct tls_context *ctx, int tx);
96 void tls_update_rx_zc_capable(struct tls_context *tls_ctx);
97 void tls_sw_strparser_arm(struct sock *sk, struct tls_context *ctx);
98 void tls_sw_strparser_done(struct tls_context *tls_ctx);
99 int tls_sw_sendmsg(struct sock *sk, struct msghdr *msg, size_t size);
100 int tls_sw_sendpage_locked(struct sock *sk, struct page *page,
101 			   int offset, size_t size, int flags);
102 int tls_sw_sendpage(struct sock *sk, struct page *page,
103 		    int offset, size_t size, int flags);
104 void tls_sw_cancel_work_tx(struct tls_context *tls_ctx);
105 void tls_sw_release_resources_tx(struct sock *sk);
106 void tls_sw_free_ctx_tx(struct tls_context *tls_ctx);
107 void tls_sw_free_resources_rx(struct sock *sk);
108 void tls_sw_release_resources_rx(struct sock *sk);
109 void tls_sw_free_ctx_rx(struct tls_context *tls_ctx);
110 int tls_sw_recvmsg(struct sock *sk, struct msghdr *msg, size_t len,
111 		   int flags, int *addr_len);
112 bool tls_sw_sock_is_readable(struct sock *sk);
113 ssize_t tls_sw_splice_read(struct socket *sock, loff_t *ppos,
114 			   struct pipe_inode_info *pipe,
115 			   size_t len, unsigned int flags);
116 
117 int tls_device_sendmsg(struct sock *sk, struct msghdr *msg, size_t size);
118 int tls_device_sendpage(struct sock *sk, struct page *page,
119 			int offset, size_t size, int flags);
120 int tls_tx_records(struct sock *sk, int flags);
121 
122 void tls_sw_write_space(struct sock *sk, struct tls_context *ctx);
123 void tls_device_write_space(struct sock *sk, struct tls_context *ctx);
124 
125 int tls_process_cmsg(struct sock *sk, struct msghdr *msg,
126 		     unsigned char *record_type);
127 int decrypt_skb(struct sock *sk, struct scatterlist *sgout);
128 
129 int tls_sw_fallback_init(struct sock *sk,
130 			 struct tls_offload_context_tx *offload_ctx,
131 			 struct tls_crypto_info *crypto_info);
132 
133 int tls_strp_dev_init(void);
134 void tls_strp_dev_exit(void);
135 
136 void tls_strp_done(struct tls_strparser *strp);
137 void tls_strp_stop(struct tls_strparser *strp);
138 int tls_strp_init(struct tls_strparser *strp, struct sock *sk);
139 void tls_strp_data_ready(struct tls_strparser *strp);
140 
141 void tls_strp_check_rcv(struct tls_strparser *strp);
142 void tls_strp_msg_done(struct tls_strparser *strp);
143 
144 int tls_rx_msg_size(struct tls_strparser *strp, struct sk_buff *skb);
145 void tls_rx_msg_ready(struct tls_strparser *strp);
146 
147 void tls_strp_msg_load(struct tls_strparser *strp, bool force_refresh);
148 int tls_strp_msg_cow(struct tls_sw_context_rx *ctx);
149 struct sk_buff *tls_strp_msg_detach(struct tls_sw_context_rx *ctx);
150 int tls_strp_msg_hold(struct tls_strparser *strp, struct sk_buff_head *dst);
151 
152 static inline struct tls_msg *tls_msg(struct sk_buff *skb)
153 {
154 	struct sk_skb_cb *scb = (struct sk_skb_cb *)skb->cb;
155 
156 	return &scb->tls;
157 }
158 
159 static inline struct sk_buff *tls_strp_msg(struct tls_sw_context_rx *ctx)
160 {
161 	DEBUG_NET_WARN_ON_ONCE(!ctx->strp.msg_ready || !ctx->strp.anchor->len);
162 	return ctx->strp.anchor;
163 }
164 
165 static inline bool tls_strp_msg_ready(struct tls_sw_context_rx *ctx)
166 {
167 	return ctx->strp.msg_ready;
168 }
169 
170 static inline bool tls_strp_msg_mixed_decrypted(struct tls_sw_context_rx *ctx)
171 {
172 	return ctx->strp.mixed_decrypted;
173 }
174 
175 #ifdef CONFIG_TLS_DEVICE
176 int tls_device_init(void);
177 void tls_device_cleanup(void);
178 int tls_set_device_offload(struct sock *sk, struct tls_context *ctx);
179 void tls_device_free_resources_tx(struct sock *sk);
180 int tls_set_device_offload_rx(struct sock *sk, struct tls_context *ctx);
181 void tls_device_offload_cleanup_rx(struct sock *sk);
182 void tls_device_rx_resync_new_rec(struct sock *sk, u32 rcd_len, u32 seq);
183 int tls_device_decrypted(struct sock *sk, struct tls_context *tls_ctx);
184 #else
185 static inline int tls_device_init(void) { return 0; }
186 static inline void tls_device_cleanup(void) {}
187 
188 static inline int
189 tls_set_device_offload(struct sock *sk, struct tls_context *ctx)
190 {
191 	return -EOPNOTSUPP;
192 }
193 
194 static inline void tls_device_free_resources_tx(struct sock *sk) {}
195 
196 static inline int
197 tls_set_device_offload_rx(struct sock *sk, struct tls_context *ctx)
198 {
199 	return -EOPNOTSUPP;
200 }
201 
202 static inline void tls_device_offload_cleanup_rx(struct sock *sk) {}
203 static inline void
204 tls_device_rx_resync_new_rec(struct sock *sk, u32 rcd_len, u32 seq) {}
205 
206 static inline int
207 tls_device_decrypted(struct sock *sk, struct tls_context *tls_ctx)
208 {
209 	return 0;
210 }
211 #endif
212 
213 int tls_push_sg(struct sock *sk, struct tls_context *ctx,
214 		struct scatterlist *sg, u16 first_offset,
215 		int flags);
216 int tls_push_partial_record(struct sock *sk, struct tls_context *ctx,
217 			    int flags);
218 void tls_free_partial_record(struct sock *sk, struct tls_context *ctx);
219 
220 static inline bool tls_is_partially_sent_record(struct tls_context *ctx)
221 {
222 	return !!ctx->partially_sent_record;
223 }
224 
225 static inline bool tls_is_pending_open_record(struct tls_context *tls_ctx)
226 {
227 	return tls_ctx->pending_open_record_frags;
228 }
229 
230 static inline bool tls_bigint_increment(unsigned char *seq, int len)
231 {
232 	int i;
233 
234 	for (i = len - 1; i >= 0; i--) {
235 		++seq[i];
236 		if (seq[i] != 0)
237 			break;
238 	}
239 
240 	return (i == -1);
241 }
242 
243 static inline void tls_bigint_subtract(unsigned char *seq, int  n)
244 {
245 	u64 rcd_sn;
246 	__be64 *p;
247 
248 	BUILD_BUG_ON(TLS_MAX_REC_SEQ_SIZE != 8);
249 
250 	p = (__be64 *)seq;
251 	rcd_sn = be64_to_cpu(*p);
252 	*p = cpu_to_be64(rcd_sn - n);
253 }
254 
255 static inline void
256 tls_advance_record_sn(struct sock *sk, struct tls_prot_info *prot,
257 		      struct cipher_context *ctx)
258 {
259 	if (tls_bigint_increment(ctx->rec_seq, prot->rec_seq_size))
260 		tls_err_abort(sk, -EBADMSG);
261 
262 	if (prot->version != TLS_1_3_VERSION &&
263 	    prot->cipher_type != TLS_CIPHER_CHACHA20_POLY1305)
264 		tls_bigint_increment(ctx->iv + prot->salt_size,
265 				     prot->iv_size);
266 }
267 
268 static inline void
269 tls_xor_iv_with_seq(struct tls_prot_info *prot, char *iv, char *seq)
270 {
271 	int i;
272 
273 	if (prot->version == TLS_1_3_VERSION ||
274 	    prot->cipher_type == TLS_CIPHER_CHACHA20_POLY1305) {
275 		for (i = 0; i < 8; i++)
276 			iv[i + 4] ^= seq[i];
277 	}
278 }
279 
280 static inline void
281 tls_fill_prepend(struct tls_context *ctx, char *buf, size_t plaintext_len,
282 		 unsigned char record_type)
283 {
284 	struct tls_prot_info *prot = &ctx->prot_info;
285 	size_t pkt_len, iv_size = prot->iv_size;
286 
287 	pkt_len = plaintext_len + prot->tag_size;
288 	if (prot->version != TLS_1_3_VERSION &&
289 	    prot->cipher_type != TLS_CIPHER_CHACHA20_POLY1305) {
290 		pkt_len += iv_size;
291 
292 		memcpy(buf + TLS_NONCE_OFFSET,
293 		       ctx->tx.iv + prot->salt_size, iv_size);
294 	}
295 
296 	/* we cover nonce explicit here as well, so buf should be of
297 	 * size KTLS_DTLS_HEADER_SIZE + KTLS_DTLS_NONCE_EXPLICIT_SIZE
298 	 */
299 	buf[0] = prot->version == TLS_1_3_VERSION ?
300 		   TLS_RECORD_TYPE_DATA : record_type;
301 	/* Note that VERSION must be TLS_1_2 for both TLS1.2 and TLS1.3 */
302 	buf[1] = TLS_1_2_VERSION_MINOR;
303 	buf[2] = TLS_1_2_VERSION_MAJOR;
304 	/* we can use IV for nonce explicit according to spec */
305 	buf[3] = pkt_len >> 8;
306 	buf[4] = pkt_len & 0xFF;
307 }
308 
309 static inline
310 void tls_make_aad(char *buf, size_t size, char *record_sequence,
311 		  unsigned char record_type, struct tls_prot_info *prot)
312 {
313 	if (prot->version != TLS_1_3_VERSION) {
314 		memcpy(buf, record_sequence, prot->rec_seq_size);
315 		buf += 8;
316 	} else {
317 		size += prot->tag_size;
318 	}
319 
320 	buf[0] = prot->version == TLS_1_3_VERSION ?
321 		  TLS_RECORD_TYPE_DATA : record_type;
322 	buf[1] = TLS_1_2_VERSION_MAJOR;
323 	buf[2] = TLS_1_2_VERSION_MINOR;
324 	buf[3] = size >> 8;
325 	buf[4] = size & 0xFF;
326 }
327 
328 #endif
329