Blame lib/range.c

Packit aea12f
/*
Packit aea12f
 * Copyright (C) 2012 INRIA Paris-Rocquencourt
Packit aea12f
 *
Packit aea12f
 * Author: Alfredo Pironti
Packit aea12f
 *
Packit aea12f
 * This file is part of GnuTLS.
Packit aea12f
 *
Packit aea12f
 * The GnuTLS is free software; you can redistribute it and/or
Packit aea12f
 * modify it under the terms of the GNU Lesser General Public License
Packit aea12f
 * as published by the Free Software Foundation; either version 2.1 of
Packit aea12f
 * the License, or (at your option) any later version.
Packit aea12f
 *
Packit aea12f
 * This library is distributed in the hope that it will be useful, but
Packit aea12f
 * WITHOUT ANY WARRANTY; without even the implied warranty of
Packit aea12f
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit aea12f
 * Lesser General Public License for more details.
Packit aea12f
 *
Packit aea12f
 * You should have received a copy of the GNU Lesser General Public License
Packit aea12f
 * along with this program.  If not, see <https://www.gnu.org/licenses/>
Packit aea12f
 *
Packit aea12f
 */
Packit aea12f
Packit aea12f
#include "gnutls_int.h"
Packit aea12f
#include "errors.h"
Packit aea12f
#include "algorithms.h"
Packit aea12f
#include "constate.h"
Packit aea12f
#include "record.h"
Packit aea12f
Packit aea12f
static void
Packit aea12f
_gnutls_set_range(gnutls_range_st * dst, const size_t low,
Packit aea12f
		  const size_t high)
Packit aea12f
{
Packit aea12f
	dst->low = low;
Packit aea12f
	dst->high = high;
Packit aea12f
	return;
Packit aea12f
}
Packit aea12f
Packit aea12f
/*
Packit aea12f
 * Returns how much LH pad we can put in this fragment, given we'll
Packit aea12f
 * put at least data_length bytes of user data.
Packit aea12f
 */
Packit aea12f
static ssize_t
Packit aea12f
_gnutls_range_max_lh_pad(gnutls_session_t session, ssize_t data_length,
Packit aea12f
			 ssize_t max_frag)
Packit aea12f
{
Packit aea12f
	int ret;
Packit aea12f
	ssize_t max_pad;
Packit aea12f
	unsigned int fixed_pad;
Packit aea12f
	record_parameters_st *record_params;
Packit aea12f
	ssize_t this_pad;
Packit aea12f
	ssize_t block_size;
Packit aea12f
	ssize_t tag_size, overflow;
Packit aea12f
	const version_entry_st *vers = get_version(session);
Packit aea12f
Packit aea12f
	if (unlikely(vers == NULL))
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
Packit aea12f
Packit aea12f
	ret =
Packit aea12f
	    _gnutls_epoch_get(session, EPOCH_WRITE_CURRENT,
Packit aea12f
			      &record_params);
Packit aea12f
	if (ret < 0) {
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);
Packit aea12f
	}
Packit aea12f
Packit aea12f
	if (!vers->tls13_sem && record_params->write.is_aead) /* not yet ready */
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
Packit aea12f
Packit aea12f
	if (vers->tls13_sem) {
Packit aea12f
		max_pad = max_record_send_size(session, record_params);
Packit aea12f
		fixed_pad = 2;
Packit aea12f
	} else {
Packit aea12f
		max_pad = MAX_PAD_SIZE;
Packit aea12f
		fixed_pad = 1;
Packit aea12f
	}
Packit aea12f
Packit aea12f
	this_pad = MIN(max_pad, max_frag - data_length);
Packit aea12f
Packit aea12f
	block_size = _gnutls_cipher_get_block_size(record_params->cipher);
Packit aea12f
	tag_size =
Packit aea12f
	    _gnutls_auth_cipher_tag_len(&record_params->write.
Packit aea12f
					ctx.tls12);
Packit aea12f
	switch (_gnutls_cipher_type(record_params->cipher)) {
Packit aea12f
	case CIPHER_AEAD:
Packit aea12f
	case CIPHER_STREAM:
Packit aea12f
		return this_pad;
Packit aea12f
Packit aea12f
	case CIPHER_BLOCK:
Packit aea12f
		overflow =
Packit aea12f
		    (data_length + this_pad + tag_size +
Packit aea12f
		     fixed_pad) % block_size;
Packit aea12f
		if (overflow > this_pad) {
Packit aea12f
			return this_pad;
Packit aea12f
		} else {
Packit aea12f
			return this_pad - overflow;
Packit aea12f
		}
Packit aea12f
	default:
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
Packit aea12f
	}
Packit aea12f
}
Packit aea12f
Packit aea12f
/**
Packit aea12f
 * gnutls_record_can_use_length_hiding:
Packit aea12f
 * @session: is a #gnutls_session_t type.
Packit aea12f
 *
Packit aea12f
 * If the session supports length-hiding padding, you can
Packit aea12f
 * invoke gnutls_record_send_range() to send a message whose
Packit aea12f
 * length is hidden in the given range. If the session does not
Packit aea12f
 * support length hiding padding, you can use the standard
Packit aea12f
 * gnutls_record_send() function, or gnutls_record_send_range()
Packit aea12f
 * making sure that the range is the same as the length of the
Packit aea12f
 * message you are trying to send.
Packit aea12f
 *
Packit aea12f
 * Returns: true (1) if the current session supports length-hiding
Packit aea12f
 * padding, false (0) if the current session does not.
Packit aea12f
 **/
Packit aea12f
unsigned gnutls_record_can_use_length_hiding(gnutls_session_t session)
Packit aea12f
{
Packit aea12f
	int ret;
Packit aea12f
	record_parameters_st *record_params;
Packit aea12f
	const version_entry_st *vers = get_version(session);
Packit aea12f
Packit aea12f
	if (unlikely(vers == NULL))
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
Packit aea12f
Packit aea12f
	if (vers->tls13_sem)
Packit aea12f
		return 1;
Packit aea12f
Packit aea12f
#ifdef ENABLE_SSL3
Packit aea12f
	if (vers->id == GNUTLS_SSL3)
Packit aea12f
		return 0;
Packit aea12f
#endif
Packit aea12f
Packit aea12f
	ret =
Packit aea12f
	    _gnutls_epoch_get(session, EPOCH_WRITE_CURRENT,
Packit aea12f
			      &record_params);
Packit aea12f
	if (ret < 0) {
Packit aea12f
		return 0;
Packit aea12f
	}
Packit aea12f
Packit aea12f
	switch (_gnutls_cipher_type(record_params->cipher)) {
Packit aea12f
	case CIPHER_BLOCK:
Packit aea12f
		return 1;
Packit aea12f
	case CIPHER_STREAM:
Packit aea12f
	case CIPHER_AEAD:
Packit aea12f
	default:
Packit aea12f
		return 0;
Packit aea12f
	}
Packit aea12f
}
Packit aea12f
Packit aea12f
/**
Packit aea12f
 * gnutls_range_split:
Packit aea12f
 * @session: is a #gnutls_session_t type
Packit aea12f
 * @orig: is the original range provided by the user
Packit aea12f
 * @next: is the returned range that can be conveyed in a TLS record
Packit aea12f
 * @remainder: is the returned remaining range
Packit aea12f
 *
Packit aea12f
 * This function should be used when it is required to hide the length
Packit aea12f
 * of very long data that cannot be directly provided to gnutls_record_send_range().
Packit aea12f
 * In that case this function should be called with the desired length
Packit aea12f
 * hiding range in @orig. The returned @next value should then be used in
Packit aea12f
 * the next call to gnutls_record_send_range() with the partial data.
Packit aea12f
 * That process should be repeated until @remainder is (0,0).
Packit aea12f
 *
Packit aea12f
 * Returns: 0 in case splitting succeeds, non zero in case of error.
Packit aea12f
 * Note that @orig is not changed, while the values of @next
Packit aea12f
 * and @remainder are modified to store the resulting values.
Packit aea12f
 */
Packit aea12f
int
Packit aea12f
gnutls_range_split(gnutls_session_t session,
Packit aea12f
		   const gnutls_range_st * orig,
Packit aea12f
		   gnutls_range_st * next, gnutls_range_st * remainder)
Packit aea12f
{
Packit aea12f
	int ret;
Packit aea12f
	ssize_t max_frag;
Packit aea12f
	ssize_t orig_low = (ssize_t) orig->low;
Packit aea12f
	ssize_t orig_high = (ssize_t) orig->high;
Packit aea12f
	record_parameters_st *record_params;
Packit aea12f
Packit aea12f
	ret =
Packit aea12f
	    _gnutls_epoch_get(session, EPOCH_WRITE_CURRENT,
Packit aea12f
			      &record_params);
Packit aea12f
	if (ret < 0)
Packit aea12f
		return gnutls_assert_val(ret);
Packit aea12f
Packit aea12f
	max_frag = max_record_send_size(session, record_params);
Packit aea12f
Packit aea12f
	if (orig_high == orig_low) {
Packit aea12f
		int length = MIN(orig_high, max_frag);
Packit aea12f
		int rem = orig_high - length;
Packit aea12f
		_gnutls_set_range(next, length, length);
Packit aea12f
		_gnutls_set_range(remainder, rem, rem);
Packit aea12f
Packit aea12f
		return 0;
Packit aea12f
	} else {
Packit aea12f
		if (orig_low >= max_frag) {
Packit aea12f
			_gnutls_set_range(next, max_frag, max_frag);
Packit aea12f
			_gnutls_set_range(remainder, orig_low - max_frag,
Packit aea12f
					  orig_high - max_frag);
Packit aea12f
		} else {
Packit aea12f
			ret =
Packit aea12f
			    _gnutls_range_max_lh_pad(session, orig_low,
Packit aea12f
						     max_frag);
Packit aea12f
			if (ret < 0)
Packit aea12f
				return gnutls_assert_val(ret);
Packit aea12f
Packit aea12f
			ssize_t this_pad = MIN(ret, orig_high - orig_low);
Packit aea12f
Packit aea12f
			_gnutls_set_range(next, orig_low,
Packit aea12f
					  orig_low + this_pad);
Packit aea12f
			_gnutls_set_range(remainder, 0,
Packit aea12f
					  orig_high - (orig_low +
Packit aea12f
						       this_pad));
Packit aea12f
		}
Packit aea12f
Packit aea12f
		return 0;
Packit aea12f
	}
Packit aea12f
}
Packit aea12f
Packit aea12f
static size_t
Packit aea12f
_gnutls_range_fragment(size_t data_size, gnutls_range_st cur,
Packit aea12f
		       gnutls_range_st next)
Packit aea12f
{
Packit aea12f
	return MIN(cur.high, data_size - next.low);
Packit aea12f
}
Packit aea12f
Packit aea12f
/**
Packit aea12f
 * gnutls_record_send_range:
Packit aea12f
 * @session: is a #gnutls_session_t type.
Packit aea12f
 * @data: contains the data to send.
Packit aea12f
 * @data_size: is the length of the data.
Packit aea12f
 * @range: is the range of lengths in which the real data length must be hidden.
Packit aea12f
 *
Packit aea12f
 * This function operates like gnutls_record_send() but, while
Packit aea12f
 * gnutls_record_send() adds minimal padding to each TLS record,
Packit aea12f
 * this function uses the TLS extra-padding feature to conceal the real
Packit aea12f
 * data size within the range of lengths provided.
Packit aea12f
 * Some TLS sessions do not support extra padding (e.g. stream ciphers in standard
Packit aea12f
 * TLS or SSL3 sessions). To know whether the current session supports extra
Packit aea12f
 * padding, and hence length hiding, use the gnutls_record_can_use_length_hiding()
Packit aea12f
 * function.
Packit aea12f
 *
Packit aea12f
 * Note: This function currently is limited to blocking sockets.
Packit aea12f
 *
Packit aea12f
 * Returns: The number of bytes sent (that is data_size in a successful invocation),
Packit aea12f
 * or a negative error code.
Packit aea12f
 **/
Packit aea12f
ssize_t
Packit aea12f
gnutls_record_send_range(gnutls_session_t session, const void *data,
Packit aea12f
			 size_t data_size, const gnutls_range_st * range)
Packit aea12f
{
Packit aea12f
	size_t sent = 0;
Packit aea12f
	size_t next_fragment_length;
Packit aea12f
	ssize_t ret;
Packit aea12f
	gnutls_range_st cur_range, next_range;
Packit aea12f
Packit aea12f
	/* sanity check on range and data size */
Packit aea12f
	if (range->low > range->high ||
Packit aea12f
	    data_size < range->low || data_size > range->high) {
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);
Packit aea12f
	}
Packit aea12f
Packit aea12f
	ret = gnutls_record_can_use_length_hiding(session);
Packit aea12f
	if (ret == 0)
Packit aea12f
		return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);
Packit aea12f
Packit aea12f
	_gnutls_set_range(&cur_range, range->low, range->high);
Packit aea12f
Packit aea12f
	_gnutls_record_log
Packit aea12f
	    ("RANGE: Preparing message with size %d, range (%d,%d)\n",
Packit aea12f
	     (int) data_size, (int) range->low, (int) range->high);
Packit aea12f
Packit aea12f
	while (cur_range.high != 0) {
Packit aea12f
		ret =
Packit aea12f
		    gnutls_range_split(session, &cur_range, &cur_range,
Packit aea12f
				       &next_range);
Packit aea12f
		if (ret < 0) {
Packit aea12f
			return ret;	/* already gnutls_assert_val'd */
Packit aea12f
		}
Packit aea12f
Packit aea12f
		next_fragment_length =
Packit aea12f
		    _gnutls_range_fragment(data_size, cur_range,
Packit aea12f
					   next_range);
Packit aea12f
Packit aea12f
		_gnutls_record_log
Packit aea12f
		    ("RANGE: Next fragment size: %d (%d,%d); remaining range: (%d,%d)\n",
Packit aea12f
		     (int) next_fragment_length, (int) cur_range.low,
Packit aea12f
		     (int) cur_range.high, (int) next_range.low,
Packit aea12f
		     (int) next_range.high);
Packit aea12f
Packit aea12f
		ret =
Packit aea12f
		    _gnutls_send_tlen_int(session, GNUTLS_APPLICATION_DATA,
Packit aea12f
					  -1, EPOCH_WRITE_CURRENT,
Packit aea12f
					  &(((char *) data)[sent]),
Packit aea12f
					  next_fragment_length,
Packit aea12f
					  cur_range.high -
Packit aea12f
					  next_fragment_length,
Packit aea12f
					  MBUFFER_FLUSH);
Packit aea12f
Packit aea12f
		while (ret == GNUTLS_E_AGAIN
Packit aea12f
		       || ret == GNUTLS_E_INTERRUPTED) {
Packit aea12f
			ret =
Packit aea12f
			    _gnutls_send_tlen_int(session,
Packit aea12f
						  GNUTLS_APPLICATION_DATA,
Packit aea12f
						  -1, EPOCH_WRITE_CURRENT,
Packit aea12f
						  NULL, 0, 0,
Packit aea12f
						  MBUFFER_FLUSH);
Packit aea12f
		}
Packit aea12f
Packit aea12f
		if (ret < 0) {
Packit aea12f
			return gnutls_assert_val(ret);
Packit aea12f
		}
Packit aea12f
		if (ret != (ssize_t) next_fragment_length) {
Packit aea12f
			_gnutls_record_log
Packit aea12f
			    ("RANGE: ERROR: ret = %d; next_fragment_length = %d\n",
Packit aea12f
			     (int) ret, (int) next_fragment_length);
Packit aea12f
			return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
Packit aea12f
		}
Packit aea12f
		sent += next_fragment_length;
Packit aea12f
		data_size -= next_fragment_length;
Packit aea12f
		_gnutls_set_range(&cur_range, next_range.low,
Packit aea12f
				  next_range.high);
Packit aea12f
	}
Packit aea12f
Packit aea12f
	return sent;
Packit aea12f
}