forked from mirrors/linux
		
	 fae198935c
			
		
	
	
		fae198935c
		
	
	
	
	
		
			
			A subsequent commit will introduce "dh" wrapping templates of the form "ffdhe2048(dh)", "ffdhe3072(dh)" and so on in order to provide built-in support for the well-known safe-prime ffdhe group parameters specified in RFC 7919. Those templates' ->set_secret() will wrap the inner "dh" implementation's ->set_secret() and set the ->p and ->g group parameters as appropriate on the way inwards. More specifically, - A ffdheXYZ(dh) user would call crypto_dh_encode() on a struct dh instance having ->p == ->g == NULL as well as ->p_size == ->g_size == 0 and pass the resulting buffer to the outer ->set_secret(). - This outer ->set_secret() would then decode the struct dh via crypto_dh_decode_key(), set ->p, ->g, ->p_size as well as ->g_size as appropriate for the group in question and encode the struct dh again before passing it further down to the inner "dh"'s ->set_secret(). The problem is that crypto_dh_decode_key() implements some basic checks which would reject parameter sets with ->p_size == 0 and thus, the ffdheXYZ templates' ->set_secret() cannot use it as-is for decoding the passed buffer. As the inner "dh"'s ->set_secret() will eventually conduct said checks on the final parameter set anyway, the outer ->set_secret() really only needs the decoding functionality. Split out the pure struct dh decoding part from crypto_dh_decode_key() into the new __crypto_dh_decode_key(). __crypto_dh_decode_key() gets defined in crypto/dh_helper.c, but will have to get called from crypto/dh.c and thus, its declaration must be somehow made available to the latter. Strictly speaking, __crypto_dh_decode_key() is internal to the dh_generic module, yet it would be a bit over the top to introduce a new header like e.g. include/crypto/internal/dh.h containing just a single prototype. Add the __crypto_dh_decode_key() declaration to include/crypto/dh.h instead. Provide a proper kernel-doc annotation, even though __crypto_dh_decode_key() is purposedly not on the function list specified in Documentation/crypto/api-kpp.rst. Signed-off-by: Nicolai Stange <nstange@suse.de> Reviewed-by: Hannes Reinecke <hare@suse.de> Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
		
			
				
	
	
		
			120 lines
		
	
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			120 lines
		
	
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| // SPDX-License-Identifier: GPL-2.0-or-later
 | |
| /*
 | |
|  * Copyright (c) 2016, Intel Corporation
 | |
|  * Authors: Salvatore Benedetto <salvatore.benedetto@intel.com>
 | |
|  */
 | |
| #include <linux/kernel.h>
 | |
| #include <linux/export.h>
 | |
| #include <linux/err.h>
 | |
| #include <linux/string.h>
 | |
| #include <crypto/dh.h>
 | |
| #include <crypto/kpp.h>
 | |
| 
 | |
| #define DH_KPP_SECRET_MIN_SIZE (sizeof(struct kpp_secret) + 3 * sizeof(int))
 | |
| 
 | |
| static inline u8 *dh_pack_data(u8 *dst, u8 *end, const void *src, size_t size)
 | |
| {
 | |
| 	if (!dst || size > end - dst)
 | |
| 		return NULL;
 | |
| 	memcpy(dst, src, size);
 | |
| 	return dst + size;
 | |
| }
 | |
| 
 | |
| static inline const u8 *dh_unpack_data(void *dst, const void *src, size_t size)
 | |
| {
 | |
| 	memcpy(dst, src, size);
 | |
| 	return src + size;
 | |
| }
 | |
| 
 | |
| static inline unsigned int dh_data_size(const struct dh *p)
 | |
| {
 | |
| 	return p->key_size + p->p_size + p->g_size;
 | |
| }
 | |
| 
 | |
| unsigned int crypto_dh_key_len(const struct dh *p)
 | |
| {
 | |
| 	return DH_KPP_SECRET_MIN_SIZE + dh_data_size(p);
 | |
| }
 | |
| EXPORT_SYMBOL_GPL(crypto_dh_key_len);
 | |
| 
 | |
| int crypto_dh_encode_key(char *buf, unsigned int len, const struct dh *params)
 | |
| {
 | |
| 	u8 *ptr = buf;
 | |
| 	u8 * const end = ptr + len;
 | |
| 	struct kpp_secret secret = {
 | |
| 		.type = CRYPTO_KPP_SECRET_TYPE_DH,
 | |
| 		.len = len
 | |
| 	};
 | |
| 
 | |
| 	if (unlikely(!len))
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	ptr = dh_pack_data(ptr, end, &secret, sizeof(secret));
 | |
| 	ptr = dh_pack_data(ptr, end, ¶ms->key_size,
 | |
| 			   sizeof(params->key_size));
 | |
| 	ptr = dh_pack_data(ptr, end, ¶ms->p_size, sizeof(params->p_size));
 | |
| 	ptr = dh_pack_data(ptr, end, ¶ms->g_size, sizeof(params->g_size));
 | |
| 	ptr = dh_pack_data(ptr, end, params->key, params->key_size);
 | |
| 	ptr = dh_pack_data(ptr, end, params->p, params->p_size);
 | |
| 	ptr = dh_pack_data(ptr, end, params->g, params->g_size);
 | |
| 	if (ptr != end)
 | |
| 		return -EINVAL;
 | |
| 	return 0;
 | |
| }
 | |
| EXPORT_SYMBOL_GPL(crypto_dh_encode_key);
 | |
| 
 | |
| int __crypto_dh_decode_key(const char *buf, unsigned int len, struct dh *params)
 | |
| {
 | |
| 	const u8 *ptr = buf;
 | |
| 	struct kpp_secret secret;
 | |
| 
 | |
| 	if (unlikely(!buf || len < DH_KPP_SECRET_MIN_SIZE))
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	ptr = dh_unpack_data(&secret, ptr, sizeof(secret));
 | |
| 	if (secret.type != CRYPTO_KPP_SECRET_TYPE_DH)
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	ptr = dh_unpack_data(¶ms->key_size, ptr, sizeof(params->key_size));
 | |
| 	ptr = dh_unpack_data(¶ms->p_size, ptr, sizeof(params->p_size));
 | |
| 	ptr = dh_unpack_data(¶ms->g_size, ptr, sizeof(params->g_size));
 | |
| 	if (secret.len != crypto_dh_key_len(params))
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	/* Don't allocate memory. Set pointers to data within
 | |
| 	 * the given buffer
 | |
| 	 */
 | |
| 	params->key = (void *)ptr;
 | |
| 	params->p = (void *)(ptr + params->key_size);
 | |
| 	params->g = (void *)(ptr + params->key_size + params->p_size);
 | |
| 
 | |
| 	return 0;
 | |
| }
 | |
| 
 | |
| int crypto_dh_decode_key(const char *buf, unsigned int len, struct dh *params)
 | |
| {
 | |
| 	int err;
 | |
| 
 | |
| 	err = __crypto_dh_decode_key(buf, len, params);
 | |
| 	if (err)
 | |
| 		return err;
 | |
| 
 | |
| 	/*
 | |
| 	 * Don't permit the buffer for 'key' or 'g' to be larger than 'p', since
 | |
| 	 * some drivers assume otherwise.
 | |
| 	 */
 | |
| 	if (params->key_size > params->p_size ||
 | |
| 	    params->g_size > params->p_size)
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	/*
 | |
| 	 * Don't permit 'p' to be 0.  It's not a prime number, and it's subject
 | |
| 	 * to corner cases such as 'mod 0' being undefined or
 | |
| 	 * crypto_kpp_maxsize() returning 0.
 | |
| 	 */
 | |
| 	if (memchr_inv(params->p, 0, params->p_size) == NULL)
 | |
| 		return -EINVAL;
 | |
| 
 | |
| 	return 0;
 | |
| }
 | |
| EXPORT_SYMBOL_GPL(crypto_dh_decode_key);
 |