xref: /aosp_15_r20/external/mbedtls/tests/suites/test_suite_asn1parse.function (revision 62c56f9862f102b96d72393aff6076c951fb8148)

/* BEGIN_HEADER */
#include <errno.h>
#include <stdlib.h>
#include <limits.h>

#include "mbedtls/bignum.h"
#include "mbedtls/asn1.h"
#if defined(MBEDTLS_ASN1_WRITE_C)
#include "mbedtls/asn1write.h"
#endif

/* Used internally to report an error that indicates a bug in a parsing function. */
#define ERR_PARSE_INCONSISTENCY INT_MAX

/* Use this magic value in some tests to indicate that the expected result
 * should not be checked. */
#define UNPREDICTABLE_RESULT 0x5552

static int nested_parse(unsigned char **const p,
                        const unsigned char *const end)
{
    int ret;
    size_t len = 0;
    size_t len2 = 0;
    unsigned char *const start = *p;
    unsigned char *content_start;
    unsigned char tag;

    /* First get the length, skipping over the tag. */
    content_start = start + 1;
    ret = mbedtls_asn1_get_len(&content_start, end, &len);
    TEST_ASSERT(content_start <= end);
    if (ret != 0) {
        return ret;
    }

    /* Since we have a valid element start (tag and length), retrieve and
     * check the tag. */
    tag = start[0];
    TEST_EQUAL(mbedtls_asn1_get_tag(p, end, &len2, tag ^ 1),
               MBEDTLS_ERR_ASN1_UNEXPECTED_TAG);
    *p = start;
    TEST_EQUAL(mbedtls_asn1_get_tag(p, end, &len2, tag), 0);
    TEST_EQUAL(len, len2);
    TEST_ASSERT(*p == content_start);
    *p = content_start;

    switch (tag & 0x1f) {
        case MBEDTLS_ASN1_BOOLEAN:
        {
            int val = -257;
            *p = start;
            ret = mbedtls_asn1_get_bool(p, end, &val);
            if (ret == 0) {
                TEST_ASSERT(val == 0 || val == 1);
            }
            break;
        }

        case MBEDTLS_ASN1_INTEGER:
        {
#if defined(MBEDTLS_BIGNUM_C)
            mbedtls_mpi mpi;
            mbedtls_mpi_init(&mpi);
            *p = start;
            ret = mbedtls_asn1_get_mpi(p, end, &mpi);
            mbedtls_mpi_free(&mpi);
#else
            *p = start + 1;
            ret = mbedtls_asn1_get_len(p, end, &len);
            *p += len;
#endif
            /* If we're sure that the number fits in an int, also
             * call mbedtls_asn1_get_int(). */
            if (ret == 0 && len < sizeof(int)) {
                int val = -257;
                unsigned char *q = start;
                ret = mbedtls_asn1_get_int(&q, end, &val);
                TEST_ASSERT(*p == q);
            }
            break;
        }

        case MBEDTLS_ASN1_BIT_STRING:
        {
            mbedtls_asn1_bitstring bs;
            *p = start;
            ret = mbedtls_asn1_get_bitstring(p, end, &bs);
            break;
        }

        case MBEDTLS_ASN1_SEQUENCE:
        {
            while (*p <= end && *p < content_start + len && ret == 0) {
                ret = nested_parse(p, content_start + len);
            }
            break;
        }

        case MBEDTLS_ASN1_OCTET_STRING:
        case MBEDTLS_ASN1_NULL:
        case MBEDTLS_ASN1_OID:
        case MBEDTLS_ASN1_UTF8_STRING:
        case MBEDTLS_ASN1_SET:
        case MBEDTLS_ASN1_PRINTABLE_STRING:
        case MBEDTLS_ASN1_T61_STRING:
        case MBEDTLS_ASN1_IA5_STRING:
        case MBEDTLS_ASN1_UTC_TIME:
        case MBEDTLS_ASN1_GENERALIZED_TIME:
        case MBEDTLS_ASN1_UNIVERSAL_STRING:
        case MBEDTLS_ASN1_BMP_STRING:
        default:
            /* No further testing implemented for this tag. */
            *p += len;
            return 0;
    }

    TEST_ASSERT(*p <= end);
    return ret;

exit:
    return ERR_PARSE_INCONSISTENCY;
}

int get_len_step(const data_t *input, size_t buffer_size,
                 size_t actual_length)
{
    unsigned char *buf = NULL;
    unsigned char *p = NULL;
    unsigned char *end;
    size_t parsed_length;
    int ret;

    mbedtls_test_set_step(buffer_size);
    /* Allocate a new buffer of exactly the length to parse each time.
     * This gives memory sanitizers a chance to catch buffer overreads. */
    if (buffer_size == 0) {
        TEST_CALLOC(buf, 1);
        end = buf + 1;
        p = end;
    } else {
        TEST_CALLOC_OR_SKIP(buf, buffer_size);
        if (buffer_size > input->len) {
            memcpy(buf, input->x, input->len);
            memset(buf + input->len, 'A', buffer_size - input->len);
        } else {
            memcpy(buf, input->x, buffer_size);
        }
        p = buf;
        end = buf + buffer_size;
    }

    ret = mbedtls_asn1_get_len(&p, end, &parsed_length);

    if (buffer_size >= input->len + actual_length) {
        TEST_EQUAL(ret, 0);
        TEST_ASSERT(p == buf + input->len);
        TEST_EQUAL(parsed_length, actual_length);
    } else {
        TEST_EQUAL(ret, MBEDTLS_ERR_ASN1_OUT_OF_DATA);
    }
    mbedtls_free(buf);
    return 1;

exit:
    mbedtls_free(buf);
    return 0;
}

typedef struct {
    const unsigned char *input_start;
    const char *description;
} traverse_state_t;

/* Value returned by traverse_callback if description runs out. */
#define RET_TRAVERSE_STOP 1
/* Value returned by traverse_callback if description has an invalid format
 * (see traverse_sequence_of). */
#define RET_TRAVERSE_ERROR 2


static int traverse_callback(void *ctx, int tag,
                             unsigned char *content, size_t len)
{
    traverse_state_t *state = ctx;
    size_t offset;
    const char *rest = state->description;
    unsigned long n;

    TEST_ASSERT(content > state->input_start);
    offset = content - state->input_start;
    mbedtls_test_set_step(offset);

    if (*rest == 0) {
        return RET_TRAVERSE_STOP;
    }
    n = strtoul(rest, (char **) &rest, 0);
    TEST_EQUAL(n, offset);
    TEST_EQUAL(*rest, ',');
    ++rest;
    n = strtoul(rest, (char **) &rest, 0);
    TEST_EQUAL(n, (unsigned) tag);
    TEST_EQUAL(*rest, ',');
    ++rest;
    n = strtoul(rest, (char **) &rest, 0);
    TEST_EQUAL(n, len);
    if (*rest == ',') {
        ++rest;
    }

    state->description = rest;
    return 0;

exit:
    return RET_TRAVERSE_ERROR;
}

/* END_HEADER */

/* BEGIN_DEPENDENCIES
 * depends_on:MBEDTLS_ASN1_PARSE_C
 * END_DEPENDENCIES
 */

/* BEGIN_CASE */
void parse_prefixes(const data_t *input,
                    int full_result,
                    int overfull_result)
{
    /* full_result: expected result from parsing the given string. */
    /* overfull_result: expected_result from parsing the given string plus
     * some trailing garbage. This may be UNPREDICTABLE_RESULT to accept
     * any result: use this for invalid inputs that may or may not become
     * valid depending on what the trailing garbage is. */

    unsigned char *buf = NULL;
    unsigned char *p = NULL;
    size_t buffer_size;
    int ret;

    /* Test every prefix of the input, except the empty string.
     * The first byte of the string is the tag. Without a tag byte,
     * we wouldn't know what to parse the input as.
     * Also test the input followed by an extra byte.
     */
    for (buffer_size = 1; buffer_size <= input->len + 1; buffer_size++) {
        mbedtls_test_set_step(buffer_size);
        /* Allocate a new buffer of exactly the length to parse each time.
         * This gives memory sanitizers a chance to catch buffer overreads. */
        TEST_CALLOC(buf, buffer_size);
        memcpy(buf, input->x, buffer_size);
        p = buf;
        ret = nested_parse(&p, buf + buffer_size);

        if (ret == ERR_PARSE_INCONSISTENCY) {
            goto exit;
        }
        if (buffer_size < input->len) {
            TEST_EQUAL(ret, MBEDTLS_ERR_ASN1_OUT_OF_DATA);
        } else if (buffer_size == input->len) {
            TEST_EQUAL(ret, full_result);
        } else { /* ( buffer_size > input->len ) */
            if (overfull_result != UNPREDICTABLE_RESULT) {
                TEST_EQUAL(ret, overfull_result);
            }
        }
        if (ret == 0) {
            TEST_ASSERT(p == buf + input->len);
        }

        mbedtls_free(buf);
        buf = NULL;
    }

exit:
    mbedtls_free(buf);
}
/* END_CASE */

/* BEGIN_CASE */
void get_len(const data_t *input, int actual_length_arg)
{
    size_t actual_length = actual_length_arg;
    size_t buffer_size;

    /* Test prefixes of a buffer containing the given length string
     * followed by `actual_length` bytes of payload. To save a bit of
     * time, we skip some "boring" prefixes: we don't test prefixes where
     * the payload is truncated more than one byte away from either end,
     * and we only test the empty string on a 1-byte input.
     */
    for (buffer_size = 1; buffer_size <= input->len + 1; buffer_size++) {
        if (!get_len_step(input, buffer_size, actual_length)) {
            goto exit;
        }
    }
    if (!get_len_step(input, input->len + actual_length - 1, actual_length)) {
        goto exit;
    }
    if (!get_len_step(input, input->len + actual_length, actual_length)) {
        goto exit;
    }
}
/* END_CASE */

/* BEGIN_CASE */
void get_boolean(const data_t *input,
                 int expected_value, int expected_result)
{
    unsigned char *p = input->x;
    int val;
    int ret;
    ret = mbedtls_asn1_get_bool(&p, input->x + input->len, &val);
    TEST_EQUAL(ret, expected_result);
    if (expected_result == 0) {
        TEST_EQUAL(val, expected_value);
        TEST_ASSERT(p == input->x + input->len);
    }
}
/* END_CASE */

/* BEGIN_CASE */
void empty_integer(const data_t *input)
{
    unsigned char *p;
#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi actual_mpi;
#endif
    int val;

#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi_init(&actual_mpi);
#endif

    /* An INTEGER with no content is not valid. */
    p = input->x;
    TEST_EQUAL(mbedtls_asn1_get_int(&p, input->x + input->len, &val),
               MBEDTLS_ERR_ASN1_INVALID_LENGTH);

#if defined(MBEDTLS_BIGNUM_C)
    /* INTEGERs are sometimes abused as bitstrings, so the library accepts
     * an INTEGER with empty content and gives it the value 0. */
    p = input->x;
    TEST_EQUAL(mbedtls_asn1_get_mpi(&p, input->x + input->len, &actual_mpi),
               0);
    TEST_EQUAL(mbedtls_mpi_cmp_int(&actual_mpi, 0), 0);
#endif

exit:
#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi_free(&actual_mpi);
#endif
    /*empty cleanup in some configurations*/;
}
/* END_CASE */

/* BEGIN_CASE */
void get_integer(const data_t *input,
                 const char *expected_hex, int expected_result)
{
    unsigned char *p;
#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi expected_mpi;
    mbedtls_mpi actual_mpi;
    mbedtls_mpi complement;
    int expected_result_for_mpi = expected_result;
#endif
    long expected_value;
    int expected_result_for_int = expected_result;
    int val;
    int ret;

#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi_init(&expected_mpi);
    mbedtls_mpi_init(&actual_mpi);
    mbedtls_mpi_init(&complement);
#endif

    errno = 0;
    expected_value = strtol(expected_hex, NULL, 16);
    if (expected_result == 0 &&
        (errno == ERANGE
#if LONG_MAX > INT_MAX
         || expected_value > INT_MAX || expected_value < INT_MIN
#endif
        )) {
        /* The library returns the dubious error code INVALID_LENGTH
         * for integers that are out of range. */
        expected_result_for_int = MBEDTLS_ERR_ASN1_INVALID_LENGTH;
    }
    if (expected_result == 0 && expected_value < 0) {
        /* The library does not support negative INTEGERs and
         * returns the dubious error code INVALID_LENGTH.
         * Test that we preserve the historical behavior. If we
         * decide to change the behavior, we'll also change this test. */
        expected_result_for_int = MBEDTLS_ERR_ASN1_INVALID_LENGTH;
    }

    p = input->x;
    ret = mbedtls_asn1_get_int(&p, input->x + input->len, &val);
    TEST_EQUAL(ret, expected_result_for_int);
    if (ret == 0) {
        TEST_EQUAL(val, expected_value);
        TEST_ASSERT(p == input->x + input->len);
    }

#if defined(MBEDTLS_BIGNUM_C)
    ret = mbedtls_test_read_mpi(&expected_mpi, expected_hex);
    TEST_ASSERT(ret == 0 || ret == MBEDTLS_ERR_MPI_BAD_INPUT_DATA);
    if (ret == MBEDTLS_ERR_MPI_BAD_INPUT_DATA) {
        /* The data overflows the maximum MPI size. */
        expected_result_for_mpi = MBEDTLS_ERR_MPI_BAD_INPUT_DATA;
    }
    p = input->x;
    ret = mbedtls_asn1_get_mpi(&p, input->x + input->len, &actual_mpi);
    TEST_EQUAL(ret, expected_result_for_mpi);
    if (ret == 0) {
        if (expected_value >= 0) {
            TEST_ASSERT(mbedtls_mpi_cmp_mpi(&actual_mpi,
                                            &expected_mpi) == 0);
        } else {
            /* The library ignores the sign bit in ASN.1 INTEGERs
             * (which makes sense insofar as INTEGERs are sometimes
             * abused as bit strings), so the result of parsing them
             * is a positive integer such that expected_mpi +
             * actual_mpi = 2^n where n is the length of the content
             * of the INTEGER. (Leading ff octets don't matter for the
             * expected value, but they matter for the actual value.)
             * Test that we don't change from this behavior. If we
             * decide to fix the library to change the behavior on
             * negative INTEGERs, we'll fix this test code. */
            unsigned char *q = input->x + 1;
            size_t len;
            TEST_ASSERT(mbedtls_asn1_get_len(&q, input->x + input->len,
                                             &len) == 0);
            TEST_ASSERT(mbedtls_mpi_lset(&complement, 1) == 0);
            TEST_ASSERT(mbedtls_mpi_shift_l(&complement, len * 8) == 0);
            TEST_ASSERT(mbedtls_mpi_add_mpi(&complement, &complement,
                                            &expected_mpi) == 0);
            TEST_ASSERT(mbedtls_mpi_cmp_mpi(&complement,
                                            &actual_mpi) == 0);
        }
        TEST_ASSERT(p == input->x + input->len);
    }
#endif

exit:
#if defined(MBEDTLS_BIGNUM_C)
    mbedtls_mpi_free(&expected_mpi);
    mbedtls_mpi_free(&actual_mpi);
    mbedtls_mpi_free(&complement);
#endif
    /*empty cleanup in some configurations*/;
}
/* END_CASE */

/* BEGIN_CASE */
void get_enum(const data_t *input,
              const char *expected_hex, int expected_result)
{
    unsigned char *p;
    long expected_value;
    int expected_result_for_enum = expected_result;
    int val;
    int ret;

    errno = 0;
    expected_value = strtol(expected_hex, NULL, 16);
    if (expected_result == 0 &&
        (errno == ERANGE
#if LONG_MAX > INT_MAX
         || expected_value > INT_MAX || expected_value < INT_MIN
#endif
        )) {
        /* The library returns the dubious error code INVALID_LENGTH
         * for integers that are out of range. */
        expected_result_for_enum = MBEDTLS_ERR_ASN1_INVALID_LENGTH;
    }
    if (expected_result == 0 && expected_value < 0) {
        /* The library does not support negative INTEGERs and
         * returns the dubious error code INVALID_LENGTH.
         * Test that we preserve the historical behavior. If we
         * decide to change the behavior, we'll also change this test. */
        expected_result_for_enum = MBEDTLS_ERR_ASN1_INVALID_LENGTH;
    }

    p = input->x;
    ret = mbedtls_asn1_get_enum(&p, input->x + input->len, &val);
    TEST_EQUAL(ret, expected_result_for_enum);
    if (ret == 0) {
        TEST_EQUAL(val, expected_value);
        TEST_ASSERT(p == input->x + input->len);
    }
}
/* END_CASE */

/* BEGIN_CASE depends_on:MBEDTLS_BIGNUM_C */
void get_mpi_too_large()
{
    unsigned char *buf = NULL;
    unsigned char *p;
    mbedtls_mpi actual_mpi;
    size_t too_many_octets =
        MBEDTLS_MPI_MAX_LIMBS * sizeof(mbedtls_mpi_uint) + 1;
    size_t size = too_many_octets + 6;

    mbedtls_mpi_init(&actual_mpi);

    TEST_CALLOC(buf, size);
    buf[0] = 0x02; /* tag: INTEGER */
    buf[1] = 0x84; /* 4-octet length */
    buf[2] = (too_many_octets >> 24) & 0xff;
    buf[3] = (too_many_octets >> 16) & 0xff;
    buf[4] = (too_many_octets >> 8) & 0xff;
    buf[5] = too_many_octets & 0xff;
    buf[6] = 0x01; /* most significant octet */

    p = buf;
    TEST_EQUAL(mbedtls_asn1_get_mpi(&p, buf + size, &actual_mpi),
               MBEDTLS_ERR_MPI_ALLOC_FAILED);

exit:
    mbedtls_mpi_free(&actual_mpi);
    mbedtls_free(buf);
}
/* END_CASE */

/* BEGIN_CASE */
void get_bitstring(const data_t *input,
                   int expected_length, int expected_unused_bits,
                   int expected_result, int expected_result_null)
{
    mbedtls_asn1_bitstring bs = { 0xdead, 0x21, NULL };
    unsigned char *p = input->x;

    TEST_EQUAL(mbedtls_asn1_get_bitstring(&p, input->x + input->len, &bs),
               expected_result);
    if (expected_result == 0) {
        TEST_EQUAL(bs.len, (size_t) expected_length);
        TEST_EQUAL(bs.unused_bits, expected_unused_bits);
        TEST_ASSERT(bs.p != NULL);
        TEST_EQUAL(bs.p - input->x + bs.len, input->len);
        TEST_ASSERT(p == input->x + input->len);
    }

    p = input->x;
    TEST_EQUAL(mbedtls_asn1_get_bitstring_null(&p, input->x + input->len,
                                               &bs.len),
               expected_result_null);
    if (expected_result_null == 0) {
        TEST_EQUAL(bs.len, (size_t) expected_length);
        if (expected_result == 0) {
            TEST_ASSERT(p == input->x + input->len - bs.len);
        }
    }
}
/* END_CASE */

/* BEGIN_CASE */
void get_sequence_of(const data_t *input, int tag,
                     const char *description,
                     int expected_result)
{
    /* The description string is a comma-separated list of integers.
     * For each element in the SEQUENCE in input, description contains
     * two integers: the offset of the element (offset from the start
     * of input to the tag of the element) and the length of the
     * element's contents.
     * "offset1,length1,..." */

    mbedtls_asn1_sequence head = { { 0, 0, NULL }, NULL };
    mbedtls_asn1_sequence *cur;
    unsigned char *p = input->x;
    const char *rest = description;
    unsigned long n;
    unsigned int step = 0;

    TEST_EQUAL(mbedtls_asn1_get_sequence_of(&p, input->x + input->len,
                                            &head, tag),
               expected_result);
    if (expected_result == 0) {
        TEST_ASSERT(p == input->x + input->len);

        if (!*rest) {
            TEST_EQUAL(head.buf.tag, 0);
            TEST_ASSERT(head.buf.p == NULL);
            TEST_EQUAL(head.buf.len, 0);
            TEST_ASSERT(head.next == NULL);
        } else {
            cur = &head;
            while (*rest) {
                mbedtls_test_set_step(step);
                TEST_ASSERT(cur != NULL);
                TEST_EQUAL(cur->buf.tag, tag);
                n = strtoul(rest, (char **) &rest, 0);
                TEST_EQUAL(n, (size_t) (cur->buf.p - input->x));
                ++rest;
                n = strtoul(rest, (char **) &rest, 0);
                TEST_EQUAL(n, cur->buf.len);
                if (*rest) {
                    ++rest;
                }
                cur = cur->next;
                ++step;
            }
            TEST_ASSERT(cur == NULL);
        }
    }

exit:
    mbedtls_asn1_sequence_free(head.next);
}
/* END_CASE */

/* BEGIN_CASE */
void traverse_sequence_of(const data_t *input,
                          int tag_must_mask, int tag_must_val,
                          int tag_may_mask, int tag_may_val,
                          const char *description,
                          int expected_result)
{
    /* The description string is a comma-separated list of integers.
     * For each element in the SEQUENCE in input, description contains
     * three integers: the offset of the element's content (offset from
     * the start of input to the content of the element), the element's tag,
     * and the length of the element's contents.
     * "offset1,tag1,length1,..." */

    unsigned char *p = input->x;
    traverse_state_t traverse_state = { input->x, description };
    int ret;

    ret = mbedtls_asn1_traverse_sequence_of(&p, input->x + input->len,
                                            (uint8_t) tag_must_mask, (uint8_t) tag_must_val,
                                            (uint8_t) tag_may_mask, (uint8_t) tag_may_val,
                                            traverse_callback, &traverse_state);
    if (ret == RET_TRAVERSE_ERROR) {
        goto exit;
    }
    TEST_EQUAL(ret, expected_result);
    TEST_EQUAL(*traverse_state.description, 0);
}
/* END_CASE */

/* BEGIN_CASE */
void get_alg(const data_t *input,
             int oid_offset, int oid_length,
             int params_tag, int params_offset, int params_length,
             int total_length,
             int expected_result)
{
    mbedtls_asn1_buf oid = { -1, 0, NULL };
    mbedtls_asn1_buf params = { -1, 0, NULL };
    unsigned char *p = input->x;
    int ret;

    TEST_EQUAL(mbedtls_asn1_get_alg(&p, input->x + input->len,
                                    &oid, &params),
               expected_result);
    if (expected_result == 0) {
        TEST_EQUAL(oid.tag, MBEDTLS_ASN1_OID);
        TEST_EQUAL(oid.p - input->x, oid_offset);
        TEST_EQUAL(oid.len, (size_t) oid_length);
        TEST_EQUAL(params.tag, params_tag);
        if (params_offset != 0) {
            TEST_EQUAL(params.p - input->x, params_offset);
        } else {
            TEST_ASSERT(params.p == NULL);
        }
        TEST_EQUAL(params.len, (size_t) params_length);
        TEST_EQUAL(p - input->x, total_length);
    }

    ret = mbedtls_asn1_get_alg_null(&p, input->x + input->len, &oid);
    if (expected_result == 0 && params_offset == 0) {
        TEST_EQUAL(oid.tag, MBEDTLS_ASN1_OID);
        TEST_EQUAL(oid.p - input->x, oid_offset);
        TEST_EQUAL(oid.len, (size_t) oid_length);
        TEST_EQUAL(p - input->x, total_length);
    } else {
        TEST_ASSERT(ret != 0);
    }
}
/* END_CASE */

/* BEGIN_CASE */
void find_named_data(data_t *oid0, data_t *oid1, data_t *oid2, data_t *oid3,
                     data_t *needle, int from, int position)
{
    mbedtls_asn1_named_data nd[] = {
        { { 0x06, oid0->len, oid0->x }, { 0, 0, NULL }, NULL, 0 },
        { { 0x06, oid1->len, oid1->x }, { 0, 0, NULL }, NULL, 0 },
        { { 0x06, oid2->len, oid2->x }, { 0, 0, NULL }, NULL, 0 },
        { { 0x06, oid3->len, oid3->x }, { 0, 0, NULL }, NULL, 0 },
    };
    mbedtls_asn1_named_data *pointers[ARRAY_LENGTH(nd) + 1];
    size_t i;
    const mbedtls_asn1_named_data *found;

    for (i = 0; i < ARRAY_LENGTH(nd); i++) {
        pointers[i] = &nd[i];
    }
    pointers[ARRAY_LENGTH(nd)] = NULL;
    for (i = 0; i < ARRAY_LENGTH(nd); i++) {
        nd[i].next = pointers[i+1];
    }

    found = mbedtls_asn1_find_named_data((const mbedtls_asn1_named_data *) pointers[from],
                                         (const char *) needle->x,
                                         needle->len);
    TEST_ASSERT(found == pointers[position]);
}
/* END_CASE */

/* BEGIN_CASE depends_on:!MBEDTLS_DEPRECATED_REMOVED:!MBEDTLS_DEPRECATED_WARNING */
void free_named_data_null()
{
    mbedtls_asn1_free_named_data(NULL);
    goto exit; /* Silence unused label warning */
}
/* END_CASE */

/* BEGIN_CASE depends_on:!MBEDTLS_DEPRECATED_REMOVED:!MBEDTLS_DEPRECATED_WARNING */
void free_named_data(int with_oid, int with_val, int with_next)
{
    mbedtls_asn1_named_data next =
    { { 0x06, 0, NULL }, { 0, 0xcafe, NULL }, NULL, 0 };
    mbedtls_asn1_named_data head =
    { { 0x06, 0, NULL }, { 0, 0, NULL }, NULL, 0 };

    if (with_oid) {
        TEST_CALLOC(head.oid.p, 1);
    }
    if (with_val) {
        TEST_CALLOC(head.val.p, 1);
    }
    if (with_next) {
        head.next = &next;
    }

    mbedtls_asn1_free_named_data(&head);
    TEST_ASSERT(head.oid.p == NULL);
    TEST_ASSERT(head.val.p == NULL);
    TEST_ASSERT(head.next == NULL);
    TEST_ASSERT(next.val.len == 0xcafe);

exit:
    mbedtls_free(head.oid.p);
    mbedtls_free(head.val.p);
}
/* END_CASE */

/* BEGIN_CASE */
void free_named_data_list(int length)
{
    mbedtls_asn1_named_data *head = NULL;
    int i;

    for (i = 0; i < length; i++) {
        mbedtls_asn1_named_data *new = NULL;
        TEST_CALLOC(new, 1);
        new->next = head;
        head = new;
    }

    mbedtls_asn1_free_named_data_list(&head);
    TEST_ASSERT(head == NULL);
    /* Most of the point of the test is that it doesn't leak memory.
     * So this test is only really useful under a memory leak detection
     * framework. */
exit:
    mbedtls_asn1_free_named_data_list(&head);
}
/* END_CASE */