Mbed TLS v3.6.0
|
Generic ASN.1 parsing. More...
#include "mbedtls/private_access.h"
#include "mbedtls/build_info.h"
#include "mbedtls/platform_util.h"
#include <stddef.h>
#include "mbedtls/bignum.h"
Go to the source code of this file.
Data Structures | |
struct | mbedtls_asn1_buf |
struct | mbedtls_asn1_bitstring |
struct | mbedtls_asn1_sequence |
struct | mbedtls_asn1_named_data |
Macros | |
#define | MBEDTLS_OID_SIZE(x) (sizeof(x) - 1) |
#define | MBEDTLS_OID_CMP(oid_str, oid_buf) |
#define | MBEDTLS_OID_CMP_RAW(oid_str, oid_buf, oid_buf_len) |
ASN1 Error codes | |
These error codes are combined with other error codes for higher error granularity. e.g. X.509 and PKCS #7 error codes ASN1 is a standard to specify data structures. | |
#define | MBEDTLS_ERR_ASN1_OUT_OF_DATA -0x0060 |
#define | MBEDTLS_ERR_ASN1_UNEXPECTED_TAG -0x0062 |
#define | MBEDTLS_ERR_ASN1_INVALID_LENGTH -0x0064 |
#define | MBEDTLS_ERR_ASN1_LENGTH_MISMATCH -0x0066 |
#define | MBEDTLS_ERR_ASN1_INVALID_DATA -0x0068 |
#define | MBEDTLS_ERR_ASN1_ALLOC_FAILED -0x006A |
#define | MBEDTLS_ERR_ASN1_BUF_TOO_SMALL -0x006C |
DER constants | |
These constants comply with the DER encoded ASN.1 type tags. DER encoding uses hexadecimal representation. An example DER sequence is:
| |
#define | MBEDTLS_ASN1_BOOLEAN 0x01 |
#define | MBEDTLS_ASN1_INTEGER 0x02 |
#define | MBEDTLS_ASN1_BIT_STRING 0x03 |
#define | MBEDTLS_ASN1_OCTET_STRING 0x04 |
#define | MBEDTLS_ASN1_NULL 0x05 |
#define | MBEDTLS_ASN1_OID 0x06 |
#define | MBEDTLS_ASN1_ENUMERATED 0x0A |
#define | MBEDTLS_ASN1_UTF8_STRING 0x0C |
#define | MBEDTLS_ASN1_SEQUENCE 0x10 |
#define | MBEDTLS_ASN1_SET 0x11 |
#define | MBEDTLS_ASN1_PRINTABLE_STRING 0x13 |
#define | MBEDTLS_ASN1_T61_STRING 0x14 |
#define | MBEDTLS_ASN1_IA5_STRING 0x16 |
#define | MBEDTLS_ASN1_UTC_TIME 0x17 |
#define | MBEDTLS_ASN1_GENERALIZED_TIME 0x18 |
#define | MBEDTLS_ASN1_UNIVERSAL_STRING 0x1C |
#define | MBEDTLS_ASN1_BMP_STRING 0x1E |
#define | MBEDTLS_ASN1_PRIMITIVE 0x00 |
#define | MBEDTLS_ASN1_CONSTRUCTED 0x20 |
#define | MBEDTLS_ASN1_CONTEXT_SPECIFIC 0x80 |
#define | MBEDTLS_ASN1_IS_STRING_TAG(tag) |
#define | MBEDTLS_ASN1_TAG_CLASS_MASK 0xC0 |
#define | MBEDTLS_ASN1_TAG_PC_MASK 0x20 |
#define | MBEDTLS_ASN1_TAG_VALUE_MASK 0x1F |
Functions to parse ASN.1 data structures | |
typedef struct mbedtls_asn1_buf | mbedtls_asn1_buf |
typedef struct mbedtls_asn1_bitstring | mbedtls_asn1_bitstring |
typedef struct mbedtls_asn1_sequence | mbedtls_asn1_sequence |
typedef struct mbedtls_asn1_named_data | mbedtls_asn1_named_data |
int | mbedtls_asn1_get_len (unsigned char **p, const unsigned char *end, size_t *len) |
Get the length of an ASN.1 element. Updates the pointer to immediately behind the length. | |
int | mbedtls_asn1_get_tag (unsigned char **p, const unsigned char *end, size_t *len, int tag) |
Get the tag and length of the element. Check for the requested tag. Updates the pointer to immediately behind the tag and length. | |
int | mbedtls_asn1_get_bool (unsigned char **p, const unsigned char *end, int *val) |
Retrieve a boolean ASN.1 tag and its value. Updates the pointer to immediately behind the full tag. | |
int | mbedtls_asn1_get_int (unsigned char **p, const unsigned char *end, int *val) |
Retrieve an integer ASN.1 tag and its value. Updates the pointer to immediately behind the full tag. | |
int | mbedtls_asn1_get_enum (unsigned char **p, const unsigned char *end, int *val) |
Retrieve an enumerated ASN.1 tag and its value. Updates the pointer to immediately behind the full tag. | |
int | mbedtls_asn1_get_bitstring (unsigned char **p, const unsigned char *end, mbedtls_asn1_bitstring *bs) |
Retrieve a bitstring ASN.1 tag and its value. Updates the pointer to immediately behind the full tag. | |
int | mbedtls_asn1_get_bitstring_null (unsigned char **p, const unsigned char *end, size_t *len) |
Retrieve a bitstring ASN.1 tag without unused bits and its value. Updates the pointer to the beginning of the bit/octet string. | |
int | mbedtls_asn1_get_sequence_of (unsigned char **p, const unsigned char *end, mbedtls_asn1_sequence *cur, int tag) |
Parses and splits an ASN.1 "SEQUENCE OF <tag>". Updates the pointer to immediately behind the full sequence tag. | |
void | mbedtls_asn1_sequence_free (mbedtls_asn1_sequence *seq) |
Free a heap-allocated linked list presentation of an ASN.1 sequence, including the first element. | |
int | mbedtls_asn1_traverse_sequence_of (unsigned char **p, const unsigned char *end, unsigned char tag_must_mask, unsigned char tag_must_val, unsigned char tag_may_mask, unsigned char tag_may_val, int(*cb)(void *ctx, int tag, unsigned char *start, size_t len), void *ctx) |
Traverse an ASN.1 SEQUENCE container and call a callback for each entry. | |
int | mbedtls_asn1_get_mpi (unsigned char **p, const unsigned char *end, mbedtls_mpi *X) |
Retrieve an integer ASN.1 tag and its value. Updates the pointer to immediately behind the full tag. | |
int | mbedtls_asn1_get_alg (unsigned char **p, const unsigned char *end, mbedtls_asn1_buf *alg, mbedtls_asn1_buf *params) |
Retrieve an AlgorithmIdentifier ASN.1 sequence. Updates the pointer to immediately behind the full AlgorithmIdentifier. | |
int | mbedtls_asn1_get_alg_null (unsigned char **p, const unsigned char *end, mbedtls_asn1_buf *alg) |
Retrieve an AlgorithmIdentifier ASN.1 sequence with NULL or no params. Updates the pointer to immediately behind the full AlgorithmIdentifier. | |
const mbedtls_asn1_named_data * | mbedtls_asn1_find_named_data (const mbedtls_asn1_named_data *list, const char *oid, size_t len) |
Find a specific named_data entry in a sequence or list based on the OID. | |
void MBEDTLS_DEPRECATED | mbedtls_asn1_free_named_data (mbedtls_asn1_named_data *entry) |
Free a mbedtls_asn1_named_data entry. | |
void | mbedtls_asn1_free_named_data_list (mbedtls_asn1_named_data **head) |
Free all entries in a mbedtls_asn1_named_data list. | |
void | mbedtls_asn1_free_named_data_list_shallow (mbedtls_asn1_named_data *name) |
Free all shallow entries in a mbedtls_asn1_named_data list, but do not free internal pointer targets. | |
Generic ASN.1 parsing.
Definition in file asn1.h.