xref: /freebsd/crypto/openssh/sshbuf.c (revision ab40f58ccfe6c07ebefddc72f4661a52fe746353)
1 /*	$OpenBSD: sshbuf.c,v 1.11 2017/06/01 06:58:25 djm Exp $	*/
2 /*
3  * Copyright (c) 2011 Damien Miller
4  *
5  * Permission to use, copy, modify, and distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  */
17 
18 #define SSHBUF_INTERNAL
19 #include "includes.h"
20 
21 #include <sys/types.h>
22 #include <signal.h>
23 #include <stdlib.h>
24 #include <stdio.h>
25 #include <string.h>
26 
27 #include "ssherr.h"
28 #include "sshbuf.h"
29 #include "misc.h"
30 
31 static inline int
32 sshbuf_check_sanity(const struct sshbuf *buf)
33 {
34 	SSHBUF_TELL("sanity");
35 	if (__predict_false(buf == NULL ||
36 	    (!buf->readonly && buf->d != buf->cd) ||
37 	    buf->refcount < 1 || buf->refcount > SSHBUF_REFS_MAX ||
38 	    buf->cd == NULL ||
39 	    (buf->dont_free && (buf->readonly || buf->parent != NULL)) ||
40 	    buf->max_size > SSHBUF_SIZE_MAX ||
41 	    buf->alloc > buf->max_size ||
42 	    buf->size > buf->alloc ||
43 	    buf->off > buf->size)) {
44 		/* Do not try to recover from corrupted buffer internals */
45 		SSHBUF_DBG(("SSH_ERR_INTERNAL_ERROR"));
46 		signal(SIGSEGV, SIG_DFL);
47 		raise(SIGSEGV);
48 		return SSH_ERR_INTERNAL_ERROR;
49 	}
50 	return 0;
51 }
52 
53 static void
54 sshbuf_maybe_pack(struct sshbuf *buf, int force)
55 {
56 	SSHBUF_DBG(("force %d", force));
57 	SSHBUF_TELL("pre-pack");
58 	if (buf->off == 0 || buf->readonly || buf->refcount > 1)
59 		return;
60 	if (force ||
61 	    (buf->off >= SSHBUF_PACK_MIN && buf->off >= buf->size / 2)) {
62 		memmove(buf->d, buf->d + buf->off, buf->size - buf->off);
63 		buf->size -= buf->off;
64 		buf->off = 0;
65 		SSHBUF_TELL("packed");
66 	}
67 }
68 
69 struct sshbuf *
70 sshbuf_new(void)
71 {
72 	struct sshbuf *ret;
73 
74 	if ((ret = calloc(sizeof(*ret), 1)) == NULL)
75 		return NULL;
76 	ret->alloc = SSHBUF_SIZE_INIT;
77 	ret->max_size = SSHBUF_SIZE_MAX;
78 	ret->readonly = 0;
79 	ret->refcount = 1;
80 	ret->parent = NULL;
81 	if ((ret->cd = ret->d = calloc(1, ret->alloc)) == NULL) {
82 		free(ret);
83 		return NULL;
84 	}
85 	return ret;
86 }
87 
88 struct sshbuf *
89 sshbuf_from(const void *blob, size_t len)
90 {
91 	struct sshbuf *ret;
92 
93 	if (blob == NULL || len > SSHBUF_SIZE_MAX ||
94 	    (ret = calloc(sizeof(*ret), 1)) == NULL)
95 		return NULL;
96 	ret->alloc = ret->size = ret->max_size = len;
97 	ret->readonly = 1;
98 	ret->refcount = 1;
99 	ret->parent = NULL;
100 	ret->cd = blob;
101 	ret->d = NULL;
102 	return ret;
103 }
104 
105 int
106 sshbuf_set_parent(struct sshbuf *child, struct sshbuf *parent)
107 {
108 	int r;
109 
110 	if ((r = sshbuf_check_sanity(child)) != 0 ||
111 	    (r = sshbuf_check_sanity(parent)) != 0)
112 		return r;
113 	child->parent = parent;
114 	child->parent->refcount++;
115 	return 0;
116 }
117 
118 struct sshbuf *
119 sshbuf_fromb(struct sshbuf *buf)
120 {
121 	struct sshbuf *ret;
122 
123 	if (sshbuf_check_sanity(buf) != 0)
124 		return NULL;
125 	if ((ret = sshbuf_from(sshbuf_ptr(buf), sshbuf_len(buf))) == NULL)
126 		return NULL;
127 	if (sshbuf_set_parent(ret, buf) != 0) {
128 		sshbuf_free(ret);
129 		return NULL;
130 	}
131 	return ret;
132 }
133 
134 void
135 sshbuf_init(struct sshbuf *ret)
136 {
137 	explicit_bzero(ret, sizeof(*ret));
138 	ret->alloc = SSHBUF_SIZE_INIT;
139 	ret->max_size = SSHBUF_SIZE_MAX;
140 	ret->readonly = 0;
141 	ret->dont_free = 1;
142 	ret->refcount = 1;
143 	if ((ret->cd = ret->d = calloc(1, ret->alloc)) == NULL)
144 		ret->alloc = 0;
145 }
146 
147 void
148 sshbuf_free(struct sshbuf *buf)
149 {
150 	int dont_free = 0;
151 
152 	if (buf == NULL)
153 		return;
154 	/*
155 	 * The following will leak on insane buffers, but this is the safest
156 	 * course of action - an invalid pointer or already-freed pointer may
157 	 * have been passed to us and continuing to scribble over memory would
158 	 * be bad.
159 	 */
160 	if (sshbuf_check_sanity(buf) != 0)
161 		return;
162 	/*
163 	 * If we are a child, the free our parent to decrement its reference
164 	 * count and possibly free it.
165 	 */
166 	sshbuf_free(buf->parent);
167 	buf->parent = NULL;
168 	/*
169 	 * If we are a parent with still-extant children, then don't free just
170 	 * yet. The last child's call to sshbuf_free should decrement our
171 	 * refcount to 0 and trigger the actual free.
172 	 */
173 	buf->refcount--;
174 	if (buf->refcount > 0)
175 		return;
176 	dont_free = buf->dont_free;
177 	if (!buf->readonly) {
178 		explicit_bzero(buf->d, buf->alloc);
179 		free(buf->d);
180 	}
181 	explicit_bzero(buf, sizeof(*buf));
182 	if (!dont_free)
183 		free(buf);
184 }
185 
186 void
187 sshbuf_reset(struct sshbuf *buf)
188 {
189 	u_char *d;
190 
191 	if (buf->readonly || buf->refcount > 1) {
192 		/* Nonsensical. Just make buffer appear empty */
193 		buf->off = buf->size;
194 		return;
195 	}
196 	(void) sshbuf_check_sanity(buf);
197 	buf->off = buf->size = 0;
198 	if (buf->alloc != SSHBUF_SIZE_INIT) {
199 		if ((d = recallocarray(buf->d, buf->alloc, SSHBUF_SIZE_INIT,
200 		    1)) != NULL) {
201 			buf->cd = buf->d = d;
202 			buf->alloc = SSHBUF_SIZE_INIT;
203 		}
204 	}
205 	explicit_bzero(buf->d, SSHBUF_SIZE_INIT);
206 }
207 
208 size_t
209 sshbuf_max_size(const struct sshbuf *buf)
210 {
211 	return buf->max_size;
212 }
213 
214 size_t
215 sshbuf_alloc(const struct sshbuf *buf)
216 {
217 	return buf->alloc;
218 }
219 
220 const struct sshbuf *
221 sshbuf_parent(const struct sshbuf *buf)
222 {
223 	return buf->parent;
224 }
225 
226 u_int
227 sshbuf_refcount(const struct sshbuf *buf)
228 {
229 	return buf->refcount;
230 }
231 
232 int
233 sshbuf_set_max_size(struct sshbuf *buf, size_t max_size)
234 {
235 	size_t rlen;
236 	u_char *dp;
237 	int r;
238 
239 	SSHBUF_DBG(("set max buf = %p len = %zu", buf, max_size));
240 	if ((r = sshbuf_check_sanity(buf)) != 0)
241 		return r;
242 	if (max_size == buf->max_size)
243 		return 0;
244 	if (buf->readonly || buf->refcount > 1)
245 		return SSH_ERR_BUFFER_READ_ONLY;
246 	if (max_size > SSHBUF_SIZE_MAX)
247 		return SSH_ERR_NO_BUFFER_SPACE;
248 	/* pack and realloc if necessary */
249 	sshbuf_maybe_pack(buf, max_size < buf->size);
250 	if (max_size < buf->alloc && max_size > buf->size) {
251 		if (buf->size < SSHBUF_SIZE_INIT)
252 			rlen = SSHBUF_SIZE_INIT;
253 		else
254 			rlen = ROUNDUP(buf->size, SSHBUF_SIZE_INC);
255 		if (rlen > max_size)
256 			rlen = max_size;
257 		SSHBUF_DBG(("new alloc = %zu", rlen));
258 		if ((dp = recallocarray(buf->d, buf->alloc, rlen, 1)) == NULL)
259 			return SSH_ERR_ALLOC_FAIL;
260 		buf->cd = buf->d = dp;
261 		buf->alloc = rlen;
262 	}
263 	SSHBUF_TELL("new-max");
264 	if (max_size < buf->alloc)
265 		return SSH_ERR_NO_BUFFER_SPACE;
266 	buf->max_size = max_size;
267 	return 0;
268 }
269 
270 size_t
271 sshbuf_len(const struct sshbuf *buf)
272 {
273 	if (sshbuf_check_sanity(buf) != 0)
274 		return 0;
275 	return buf->size - buf->off;
276 }
277 
278 size_t
279 sshbuf_avail(const struct sshbuf *buf)
280 {
281 	if (sshbuf_check_sanity(buf) != 0 || buf->readonly || buf->refcount > 1)
282 		return 0;
283 	return buf->max_size - (buf->size - buf->off);
284 }
285 
286 const u_char *
287 sshbuf_ptr(const struct sshbuf *buf)
288 {
289 	if (sshbuf_check_sanity(buf) != 0)
290 		return NULL;
291 	return buf->cd + buf->off;
292 }
293 
294 u_char *
295 sshbuf_mutable_ptr(const struct sshbuf *buf)
296 {
297 	if (sshbuf_check_sanity(buf) != 0 || buf->readonly || buf->refcount > 1)
298 		return NULL;
299 	return buf->d + buf->off;
300 }
301 
302 int
303 sshbuf_check_reserve(const struct sshbuf *buf, size_t len)
304 {
305 	int r;
306 
307 	if ((r = sshbuf_check_sanity(buf)) != 0)
308 		return r;
309 	if (buf->readonly || buf->refcount > 1)
310 		return SSH_ERR_BUFFER_READ_ONLY;
311 	SSHBUF_TELL("check");
312 	/* Check that len is reasonable and that max_size + available < len */
313 	if (len > buf->max_size || buf->max_size - len < buf->size - buf->off)
314 		return SSH_ERR_NO_BUFFER_SPACE;
315 	return 0;
316 }
317 
318 int
319 sshbuf_allocate(struct sshbuf *buf, size_t len)
320 {
321 	size_t rlen, need;
322 	u_char *dp;
323 	int r;
324 
325 	SSHBUF_DBG(("allocate buf = %p len = %zu", buf, len));
326 	if ((r = sshbuf_check_reserve(buf, len)) != 0)
327 		return r;
328 	/*
329 	 * If the requested allocation appended would push us past max_size
330 	 * then pack the buffer, zeroing buf->off.
331 	 */
332 	sshbuf_maybe_pack(buf, buf->size + len > buf->max_size);
333 	SSHBUF_TELL("allocate");
334 	if (len + buf->size <= buf->alloc)
335 		return 0; /* already have it. */
336 
337 	/*
338 	 * Prefer to alloc in SSHBUF_SIZE_INC units, but
339 	 * allocate less if doing so would overflow max_size.
340 	 */
341 	need = len + buf->size - buf->alloc;
342 	rlen = ROUNDUP(buf->alloc + need, SSHBUF_SIZE_INC);
343 	SSHBUF_DBG(("need %zu initial rlen %zu", need, rlen));
344 	if (rlen > buf->max_size)
345 		rlen = buf->alloc + need;
346 	SSHBUF_DBG(("adjusted rlen %zu", rlen));
347 	if ((dp = recallocarray(buf->d, buf->alloc, rlen, 1)) == NULL) {
348 		SSHBUF_DBG(("realloc fail"));
349 		return SSH_ERR_ALLOC_FAIL;
350 	}
351 	buf->alloc = rlen;
352 	buf->cd = buf->d = dp;
353 	if ((r = sshbuf_check_reserve(buf, len)) < 0) {
354 		/* shouldn't fail */
355 		return r;
356 	}
357 	SSHBUF_TELL("done");
358 	return 0;
359 }
360 
361 int
362 sshbuf_reserve(struct sshbuf *buf, size_t len, u_char **dpp)
363 {
364 	u_char *dp;
365 	int r;
366 
367 	if (dpp != NULL)
368 		*dpp = NULL;
369 
370 	SSHBUF_DBG(("reserve buf = %p len = %zu", buf, len));
371 	if ((r = sshbuf_allocate(buf, len)) != 0)
372 		return r;
373 
374 	dp = buf->d + buf->size;
375 	buf->size += len;
376 	if (dpp != NULL)
377 		*dpp = dp;
378 	return 0;
379 }
380 
381 int
382 sshbuf_consume(struct sshbuf *buf, size_t len)
383 {
384 	int r;
385 
386 	SSHBUF_DBG(("len = %zu", len));
387 	if ((r = sshbuf_check_sanity(buf)) != 0)
388 		return r;
389 	if (len == 0)
390 		return 0;
391 	if (len > sshbuf_len(buf))
392 		return SSH_ERR_MESSAGE_INCOMPLETE;
393 	buf->off += len;
394 	/* deal with empty buffer */
395 	if (buf->off == buf->size)
396 		buf->off = buf->size = 0;
397 	SSHBUF_TELL("done");
398 	return 0;
399 }
400 
401 int
402 sshbuf_consume_end(struct sshbuf *buf, size_t len)
403 {
404 	int r;
405 
406 	SSHBUF_DBG(("len = %zu", len));
407 	if ((r = sshbuf_check_sanity(buf)) != 0)
408 		return r;
409 	if (len == 0)
410 		return 0;
411 	if (len > sshbuf_len(buf))
412 		return SSH_ERR_MESSAGE_INCOMPLETE;
413 	buf->size -= len;
414 	SSHBUF_TELL("done");
415 	return 0;
416 }
417 
418