// SPDX-License-Identifier: GPL-2.0-only/* * Simple encoder primitives for ASN.1 BER/DER/CER * * Copyright (C) 2019 James.Bottomley@HansenPartnership.com */ #include <linux/asn1_encoder.h>#include <linux/bug.h>#include <linux/string.h>#include <linux/module.h> /** * asn1_encode_integer() - encode positive integer to ASN.1 * @data: pointer to the pointer to the data * @end_data: end of data pointer, points one beyond last usable byte in @data * @integer: integer to be encoded * * This is a simplified encoder: it only currently does * positive integers, but it should be simple enough to add the * negative case if a use comes along. */unsigned char *asn1_encode_integer(unsigned char *data, const unsigned char *end_data, s64 integer){ int data_len = end_data - data; unsigned char *d = &data[2]; bool found = false; int i; if (WARN(integer < 0, "BUG: integer encode only supports positive integers")) return ERR_PTR(-EINVAL); if (IS_ERR(data)) return data; /* need at least 3 bytes for tag, length and integer encoding */ if (data_len < 3) return ERR_PTR(-EINVAL); /* remaining length where at d (the start of the integer encoding) */ data_len -= 2; data[0] = _tag(UNIV, PRIM, INT); if (integer == 0) { *d++ = 0; goto out; } for (i = sizeof(integer); i > 0 ; i--) { int byte = integer >> (8 * (i - 1)); if (!found && byte == 0) continue; /* * for a positive number the first byte must have bit * 7 clear in two's complement (otherwise it's a * negative number) so prepend a leading zero if * that's not the case */ if (!found && (byte & 0x80)) { /* * no check needed here, we already know we * have len >= 1 */ *d++ = 0; data_len--; } found = true; if (data_len == 0) return ERR_PTR(-EINVAL); *d++ = byte; data_len--; } out: data[1] = d - data - 2; return d;}EXPORT_SYMBOL_GPL(asn1_encode_integer); /* calculate the base 128 digit values setting the top bit of the first octet */static int asn1_encode_oid_digit(unsigned char **_data, int *data_len, u32 oid){ unsigned char *data = *_data; int start = 7 + 7 + 7 + 7; int ret = 0; if (*data_len < 1) return -EINVAL; /* quick case */ if (oid == 0) { *data++ = 0x80; (*data_len)--; goto out; } while (oid >> start == 0) start -= 7; while (start > 0 && *data_len > 0) { u8 byte; byte = oid >> start; oid = oid - (byte << start); start -= 7; byte |= 0x80; *data++ = byte; (*data_len)--; } if (*data_len > 0) { *data++ = oid; (*data_len)--; } else { ret = -EINVAL; } out: *_data = data; return ret;} /** * asn1_encode_oid() - encode an oid to ASN.1 * @data: position to begin encoding at * @end_data: end of data pointer, points one beyond last usable byte in @data * @oid: array of oids * @oid_len: length of oid array * * this encodes an OID up to ASN.1 when presented as an array of OID values */unsigned char *asn1_encode_oid(unsigned char *data, const unsigned char *end_data, u32 oid[], int oid_len){ int data_len = end_data - data; unsigned char *d = data + 2; int i, ret; if (WARN(oid_len < 2, "OID must have at least two elements")) return ERR_PTR(-EINVAL); if (WARN(oid_len > 32, "OID is too large")) return ERR_PTR(-EINVAL); if (IS_ERR(data)) return data; /* need at least 3 bytes for tag, length and OID encoding */ if (data_len < 3) return ERR_PTR(-EINVAL); data[0] = _tag(UNIV, PRIM, OID); *d++ = oid[0] * 40 + oid[1]; data_len -= 3; for (i = 2; i < oid_len; i++) { ret = asn1_encode_oid_digit(&d, &data_len, oid[i]); if (ret < 0) return ERR_PTR(ret); } data[1] = d - data - 2; return d;}EXPORT_SYMBOL_GPL(asn1_encode_oid); /** * asn1_encode_length() - encode a length to follow an ASN.1 tag * @data: pointer to encode at * @data_len: pointer to remaining length (adjusted by routine) * @len: length to encode * * This routine can encode lengths up to 65535 using the ASN.1 rules. * It will accept a negative length and place a zero length tag * instead (to keep the ASN.1 valid). This convention allows other * encoder primitives to accept negative lengths as singalling the * sequence will be re-encoded when the length is known. */static int asn1_encode_length(unsigned char **data, int *data_len, int len){ if (*data_len < 1) return -EINVAL; if (len < 0) { *((*data)++) = 0; (*data_len)--; return 0; } if (len <= 0x7f) { *((*data)++) = len; (*data_len)--; return 0; } if (*data_len < 2) return -EINVAL; if (len <= 0xff) { *((*data)++) = 0x81; *((*data)++) = len & 0xff; *data_len -= 2; return 0; } if (*data_len < 3) return -EINVAL; if (len <= 0xffff) { *((*data)++) = 0x82; *((*data)++) = (len >> 8) & 0xff; *((*data)++) = len & 0xff; *data_len -= 3; return 0; } if (WARN(len > 0xffffff, "ASN.1 length can't be > 0xffffff")) return -EINVAL; if (*data_len < 4) return -EINVAL; *((*data)++) = 0x83; *((*data)++) = (len >> 16) & 0xff; *((*data)++) = (len >> 8) & 0xff; *((*data)++) = len & 0xff; *data_len -= 4; return 0;} /** * asn1_encode_tag() - add a tag for optional or explicit value * @data: pointer to place tag at * @end_data: end of data pointer, points one beyond last usable byte in @data * @tag: tag to be placed * @string: the data to be tagged * @len: the length of the data to be tagged * * Note this currently only handles short form tags < 31. * * Standard usage is to pass in a @tag, @string and @length and the * @string will be ASN.1 encoded with @tag and placed into @data. If * the encoding would put data past @end_data then an error is * returned, otherwise a pointer to a position one beyond the encoding * is returned. * * To encode in place pass a NULL @string and -1 for @len and the * maximum allowable beginning and end of the data; all this will do * is add the current maximum length and update the data pointer to * the place where the tag contents should be placed is returned. The * data should be copied in by the calling routine which should then * repeat the prior statement but now with the known length. In order * to avoid having to keep both before and after pointers, the repeat * expects to be called with @data pointing to where the first encode * returned it and still NULL for @string but the real length in @len. */unsigned char *asn1_encode_tag(unsigned char *data, const unsigned char *end_data, u32 tag, const unsigned char *string, int len){ int data_len = end_data - data; int ret; if (WARN(tag > 30, "ASN.1 tag can't be > 30")) return ERR_PTR(-EINVAL); if (!string && WARN(len > 127, "BUG: recode tag is too big (>127)")) return ERR_PTR(-EINVAL); if (IS_ERR(data)) return data; if (!string && len > 0) { /* * we're recoding, so move back to the start of the * tag and install a dummy length because the real * data_len should be NULL */ data -= 2; data_len = 2; } if (data_len < 2) return ERR_PTR(-EINVAL); *(data++) = _tagn(CONT, CONS, tag); data_len--; ret = asn1_encode_length(&data, &data_len, len); if (ret < 0) return ERR_PTR(ret); if (!string) return data; if (data_len < len) return ERR_PTR(-EINVAL); memcpy(data, string, len); data += len; return data;}EXPORT_SYMBOL_GPL(asn1_encode_tag); /** * asn1_encode_octet_string() - encode an ASN.1 OCTET STRING * @data: pointer to encode at * @end_data: end of data pointer, points one beyond last usable byte in @data * @string: string to be encoded * @len: length of string * * Note ASN.1 octet strings may contain zeros, so the length is obligatory. */unsigned char *asn1_encode_octet_string(unsigned char *data, const unsigned char *end_data, const unsigned char *string, u32 len){ int data_len = end_data - data; int ret; if (IS_ERR(data)) return data; /* need minimum of 2 bytes for tag and length of zero length string */ if (data_len < 2) return ERR_PTR(-EINVAL); *(data++) = _tag(UNIV, PRIM, OTS); data_len--; ret = asn1_encode_length(&data, &data_len, len); if (ret) return ERR_PTR(ret); if (data_len < len) return ERR_PTR(-EINVAL); memcpy(data, string, len); data += len; return data;}EXPORT_SYMBOL_GPL(asn1_encode_octet_string); /** * asn1_encode_sequence() - wrap a byte stream in an ASN.1 SEQUENCE * @data: pointer to encode at * @end_data: end of data pointer, points one beyond last usable byte in @data * @seq: data to be encoded as a sequence * @len: length of the data to be encoded as a sequence * * Fill in a sequence. To encode in place, pass NULL for @seq and -1 * for @len; then call again once the length is known (still with NULL * for @seq). In order to avoid having to keep both before and after * pointers, the repeat expects to be called with @data pointing to * where the first encode placed it. */unsigned char *asn1_encode_sequence(unsigned char *data, const unsigned char *end_data, const unsigned char *seq, int len){ int data_len = end_data - data; int ret; if (!seq && WARN(len > 127, "BUG: recode sequence is too big (>127)")) return ERR_PTR(-EINVAL); if (IS_ERR(data)) return data; if (!seq && len >= 0) { /* * we're recoding, so move back to the start of the * sequence and install a dummy length because the * real length should be NULL */ data -= 2; data_len = 2; } if (data_len < 2) return ERR_PTR(-EINVAL); *(data++) = _tag(UNIV, CONS, SEQ); data_len--; ret = asn1_encode_length(&data, &data_len, len); if (ret) return ERR_PTR(ret); if (!seq) return data; if (data_len < len) return ERR_PTR(-EINVAL); memcpy(data, seq, len); data += len; return data;}EXPORT_SYMBOL_GPL(asn1_encode_sequence); /** * asn1_encode_boolean() - encode a boolean value to ASN.1 * @data: pointer to encode at * @end_data: end of data pointer, points one beyond last usable byte in @data * @val: the boolean true/false value */unsigned char *asn1_encode_boolean(unsigned char *data, const unsigned char *end_data, bool val){ int data_len = end_data - data; if (IS_ERR(data)) return data; /* booleans are 3 bytes: tag, length == 1 and value == 0 or 1 */ if (data_len < 3) return ERR_PTR(-EINVAL); *(data++) = _tag(UNIV, PRIM, BOOL); data_len--; asn1_encode_length(&data, &data_len, 1); if (val) *(data++) = 1; else *(data++) = 0; return data;}EXPORT_SYMBOL_GPL(asn1_encode_boolean); MODULE_DESCRIPTION("Simple encoder primitives for ASN.1 BER/DER/CER");MODULE_LICENSE("GPL");
// SPDX-License-Identifier: GPL-2.0-only
/*
* Simple encoder primitives for ASN.1 BER/DER/CER
*
* Copyright (C) 2019 James.Bottomley@HansenPartnership.com
*/
#include <linux/asn1_encoder.h>
#include <linux/bug.h>
#include <linux/string.h>
#include <linux/module.h>
/**
* asn1_encode_integer() - encode positive integer to ASN.1
* @data: pointer to the pointer to the data
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @integer: integer to be encoded
*
* This is a simplified encoder: it only currently does
* positive integers, but it should be simple enough to add the
* negative case if a use comes along.
*/
unsigned char *
asn1_encode_integer(unsigned char *data, const unsigned char *end_data,
s64 integer)
{
int data_len = end_data - data;
unsigned char *d = &data[2];
bool found = false;
int i;
if (WARN(integer < 0,
"BUG: integer encode only supports positive integers"))
return ERR_PTR(-EINVAL);
if (IS_ERR(data))
return data;
/* need at least 3 bytes for tag, length and integer encoding */
if (data_len < 3)
return ERR_PTR(-EINVAL);
/* remaining length where at d (the start of the integer encoding) */
data_len -= 2;
data[0] = _tag(UNIV, PRIM, INT);
if (integer == 0) {
*d++ = 0;
goto out;
}
for (i = sizeof(integer); i > 0 ; i--) {
int byte = integer >> (8 * (i - 1));
if (!found && byte == 0)
continue;
/*
* for a positive number the first byte must have bit
* 7 clear in two's complement (otherwise it's a
* negative number) so prepend a leading zero if
* that's not the case
*/
if (!found && (byte & 0x80)) {
/*
* no check needed here, we already know we
* have len >= 1
*/
*d++ = 0;
data_len--;
}
found = true;
if (data_len == 0)
return ERR_PTR(-EINVAL);
*d++ = byte;
data_len--;
}
out:
data[1] = d - data - 2;
return d;
}
EXPORT_SYMBOL_GPL(asn1_encode_integer);
/* calculate the base 128 digit values setting the top bit of the first octet */
static int asn1_encode_oid_digit(unsigned char **_data, int *data_len, u32 oid)
{
unsigned char *data = *_data;
int start = 7 + 7 + 7 + 7;
int ret = 0;
if (*data_len < 1)
return -EINVAL;
/* quick case */
if (oid == 0) {
*data++ = 0x80;
(*data_len)--;
goto out;
}
while (oid >> start == 0)
start -= 7;
while (start > 0 && *data_len > 0) {
u8 byte;
byte = oid >> start;
oid = oid - (byte << start);
start -= 7;
byte |= 0x80;
*data++ = byte;
(*data_len)--;
}
if (*data_len > 0) {
*data++ = oid;
(*data_len)--;
} else {
ret = -EINVAL;
}
out:
*_data = data;
return ret;
}
/**
* asn1_encode_oid() - encode an oid to ASN.1
* @data: position to begin encoding at
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @oid: array of oids
* @oid_len: length of oid array
*
* this encodes an OID up to ASN.1 when presented as an array of OID values
*/
unsigned char *
asn1_encode_oid(unsigned char *data, const unsigned char *end_data,
u32 oid[], int oid_len)
{
int data_len = end_data - data;
unsigned char *d = data + 2;
int i, ret;
if (WARN(oid_len < 2, "OID must have at least two elements"))
return ERR_PTR(-EINVAL);
if (WARN(oid_len > 32, "OID is too large"))
return ERR_PTR(-EINVAL);
if (IS_ERR(data))
return data;
/* need at least 3 bytes for tag, length and OID encoding */
if (data_len < 3)
return ERR_PTR(-EINVAL);
data[0] = _tag(UNIV, PRIM, OID);
*d++ = oid[0] * 40 + oid[1];
data_len -= 3;
for (i = 2; i < oid_len; i++) {
ret = asn1_encode_oid_digit(&d, &data_len, oid[i]);
if (ret < 0)
return ERR_PTR(ret);
}
data[1] = d - data - 2;
return d;
}
EXPORT_SYMBOL_GPL(asn1_encode_oid);
/**
* asn1_encode_length() - encode a length to follow an ASN.1 tag
* @data: pointer to encode at
* @data_len: pointer to remaining length (adjusted by routine)
* @len: length to encode
*
* This routine can encode lengths up to 65535 using the ASN.1 rules.
* It will accept a negative length and place a zero length tag
* instead (to keep the ASN.1 valid). This convention allows other
* encoder primitives to accept negative lengths as singalling the
* sequence will be re-encoded when the length is known.
*/
static int asn1_encode_length(unsigned char **data, int *data_len, int len)
{
if (*data_len < 1)
return -EINVAL;
if (len < 0) {
*((*data)++) = 0;
(*data_len)--;
return 0;
}
if (len <= 0x7f) {
*((*data)++) = len;
(*data_len)--;
return 0;
}
if (*data_len < 2)
return -EINVAL;
if (len <= 0xff) {
*((*data)++) = 0x81;
*((*data)++) = len & 0xff;
*data_len -= 2;
return 0;
}
if (*data_len < 3)
return -EINVAL;
if (len <= 0xffff) {
*((*data)++) = 0x82;
*((*data)++) = (len >> 8) & 0xff;
*((*data)++) = len & 0xff;
*data_len -= 3;
return 0;
}
if (WARN(len > 0xffffff, "ASN.1 length can't be > 0xffffff"))
return -EINVAL;
if (*data_len < 4)
return -EINVAL;
*((*data)++) = 0x83;
*((*data)++) = (len >> 16) & 0xff;
*((*data)++) = (len >> 8) & 0xff;
*((*data)++) = len & 0xff;
*data_len -= 4;
return 0;
}
/**
* asn1_encode_tag() - add a tag for optional or explicit value
* @data: pointer to place tag at
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @tag: tag to be placed
* @string: the data to be tagged
* @len: the length of the data to be tagged
*
* Note this currently only handles short form tags < 31.
*
* Standard usage is to pass in a @tag, @string and @length and the
* @string will be ASN.1 encoded with @tag and placed into @data. If
* the encoding would put data past @end_data then an error is
* returned, otherwise a pointer to a position one beyond the encoding
* is returned.
*
* To encode in place pass a NULL @string and -1 for @len and the
* maximum allowable beginning and end of the data; all this will do
* is add the current maximum length and update the data pointer to
* the place where the tag contents should be placed is returned. The
* data should be copied in by the calling routine which should then
* repeat the prior statement but now with the known length. In order
* to avoid having to keep both before and after pointers, the repeat
* expects to be called with @data pointing to where the first encode
* returned it and still NULL for @string but the real length in @len.
*/
unsigned char *
asn1_encode_tag(unsigned char *data, const unsigned char *end_data,
u32 tag, const unsigned char *string, int len)
{
int data_len = end_data - data;
int ret;
if (WARN(tag > 30, "ASN.1 tag can't be > 30"))
return ERR_PTR(-EINVAL);
if (!string && WARN(len > 127,
"BUG: recode tag is too big (>127)"))
return ERR_PTR(-EINVAL);
if (IS_ERR(data))
return data;
if (!string && len > 0) {
/*
* we're recoding, so move back to the start of the
* tag and install a dummy length because the real
* data_len should be NULL
*/
data -= 2;
data_len = 2;
}
if (data_len < 2)
return ERR_PTR(-EINVAL);
*(data++) = _tagn(CONT, CONS, tag);
data_len--;
ret = asn1_encode_length(&data, &data_len, len);
if (ret < 0)
return ERR_PTR(ret);
if (!string)
return data;
if (data_len < len)
return ERR_PTR(-EINVAL);
memcpy(data, string, len);
data += len;
return data;
}
EXPORT_SYMBOL_GPL(asn1_encode_tag);
/**
* asn1_encode_octet_string() - encode an ASN.1 OCTET STRING
* @data: pointer to encode at
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @string: string to be encoded
* @len: length of string
*
* Note ASN.1 octet strings may contain zeros, so the length is obligatory.
*/
unsigned char *
asn1_encode_octet_string(unsigned char *data,
const unsigned char *end_data,
const unsigned char *string, u32 len)
{
int data_len = end_data - data;
int ret;
if (IS_ERR(data))
return data;
/* need minimum of 2 bytes for tag and length of zero length string */
if (data_len < 2)
return ERR_PTR(-EINVAL);
*(data++) = _tag(UNIV, PRIM, OTS);
data_len--;
ret = asn1_encode_length(&data, &data_len, len);
if (ret)
return ERR_PTR(ret);
if (data_len < len)
return ERR_PTR(-EINVAL);
memcpy(data, string, len);
data += len;
return data;
}
EXPORT_SYMBOL_GPL(asn1_encode_octet_string);
/**
* asn1_encode_sequence() - wrap a byte stream in an ASN.1 SEQUENCE
* @data: pointer to encode at
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @seq: data to be encoded as a sequence
* @len: length of the data to be encoded as a sequence
*
* Fill in a sequence. To encode in place, pass NULL for @seq and -1
* for @len; then call again once the length is known (still with NULL
* for @seq). In order to avoid having to keep both before and after
* pointers, the repeat expects to be called with @data pointing to
* where the first encode placed it.
*/
unsigned char *
asn1_encode_sequence(unsigned char *data, const unsigned char *end_data,
const unsigned char *seq, int len)
{
int data_len = end_data - data;
int ret;
if (!seq && WARN(len > 127,
"BUG: recode sequence is too big (>127)"))
return ERR_PTR(-EINVAL);
if (IS_ERR(data))
return data;
if (!seq && len >= 0) {
/*
* we're recoding, so move back to the start of the
* sequence and install a dummy length because the
* real length should be NULL
*/
data -= 2;
data_len = 2;
}
if (data_len < 2)
return ERR_PTR(-EINVAL);
*(data++) = _tag(UNIV, CONS, SEQ);
data_len--;
ret = asn1_encode_length(&data, &data_len, len);
if (ret)
return ERR_PTR(ret);
if (!seq)
return data;
if (data_len < len)
return ERR_PTR(-EINVAL);
memcpy(data, seq, len);
data += len;
return data;
}
EXPORT_SYMBOL_GPL(asn1_encode_sequence);
/**
* asn1_encode_boolean() - encode a boolean value to ASN.1
* @data: pointer to encode at
* @end_data: end of data pointer, points one beyond last usable byte in @data
* @val: the boolean true/false value
*/
unsigned char *
asn1_encode_boolean(unsigned char *data, const unsigned char *end_data,
bool val)
{
int data_len = end_data - data;
if (IS_ERR(data))
return data;
/* booleans are 3 bytes: tag, length == 1 and value == 0 or 1 */
if (data_len < 3)
return ERR_PTR(-EINVAL);
*(data++) = _tag(UNIV, PRIM, BOOL);
data_len--;
asn1_encode_length(&data, &data_len, 1);
if (val)
*(data++) = 1;
else
*(data++) = 0;
return data;
}
EXPORT_SYMBOL_GPL(asn1_encode_boolean);
MODULE_DESCRIPTION("Simple encoder primitives for ASN.1 BER/DER/CER");
MODULE_LICENSE("GPL");