1 /* 2 * Copyright 2020-2022 The OpenSSL Project Authors. All Rights Reserved. 3 * 4 * Licensed under the Apache License 2.0 (the "License"). You may not use 5 * this file except in compliance with the License. You can obtain a copy 6 * in the file LICENSE in the source distribution or at 7 * https://www.openssl.org/source/license.html 8 */ 9 10 #ifndef OSSL_INTERNAL_DER_H 11 #define OSSL_INTERNAL_DER_H 12 #pragma once 13 14 #include <openssl/bn.h> 15 #include "internal/packet.h" 16 17 /* 18 * NOTE: X.690 numbers the identifier octet bits 1 to 8. 19 * We use the same numbering in comments here. 20 */ 21 22 /* Well known primitive tags */ 23 24 /* 25 * DER UNIVERSAL tags, occupying bits 1-5 in the DER identifier byte 26 * These are only valid for the UNIVERSAL class. With the other classes, 27 * these bits have a different meaning. 28 */ 29 #define DER_P_EOC 0 /* BER End Of Contents tag */ 30 #define DER_P_BOOLEAN 1 31 #define DER_P_INTEGER 2 32 #define DER_P_BIT_STRING 3 33 #define DER_P_OCTET_STRING 4 34 #define DER_P_NULL 5 35 #define DER_P_OBJECT 6 36 #define DER_P_OBJECT_DESCRIPTOR 7 37 #define DER_P_EXTERNAL 8 38 #define DER_P_REAL 9 39 #define DER_P_ENUMERATED 10 40 #define DER_P_UTF8STRING 12 41 #define DER_P_SEQUENCE 16 42 #define DER_P_SET 17 43 #define DER_P_NUMERICSTRING 18 44 #define DER_P_PRINTABLESTRING 19 45 #define DER_P_T61STRING 20 46 #define DER_P_VIDEOTEXSTRING 21 47 #define DER_P_IA5STRING 22 48 #define DER_P_UTCTIME 23 49 #define DER_P_GENERALIZEDTIME 24 50 #define DER_P_GRAPHICSTRING 25 51 #define DER_P_ISO64STRING 26 52 #define DER_P_GENERALSTRING 27 53 #define DER_P_UNIVERSALSTRING 28 54 #define DER_P_BMPSTRING 30 55 56 /* DER Flags, occupying bit 6 in the DER identifier byte */ 57 #define DER_F_PRIMITIVE 0x00 58 #define DER_F_CONSTRUCTED 0x20 59 60 /* DER classes tags, occupying bits 7-8 in the DER identifier byte */ 61 #define DER_C_UNIVERSAL 0x00 62 #define DER_C_APPLICATION 0x40 63 #define DER_C_CONTEXT 0x80 64 #define DER_C_PRIVATE 0xC0 65 66 /* 67 * Run-time constructors. 68 * 69 * They all construct DER backwards, so care should be taken to use them 70 * that way. 71 */ 72 73 /* This can be used for all items that don't have a context */ 74 #define DER_NO_CONTEXT -1 75 76 int ossl_DER_w_precompiled(WPACKET *pkt, int tag, 77 const unsigned char *precompiled, 78 size_t precompiled_n); 79 80 int ossl_DER_w_boolean(WPACKET *pkt, int tag, int b); 81 int ossl_DER_w_uint32(WPACKET *pkt, int tag, uint32_t v); 82 int ossl_DER_w_bn(WPACKET *pkt, int tag, const BIGNUM *v); 83 int ossl_DER_w_null(WPACKET *pkt, int tag); 84 int ossl_DER_w_octet_string(WPACKET *pkt, int tag, 85 const unsigned char *data, size_t data_n); 86 int ossl_DER_w_octet_string_uint32(WPACKET *pkt, int tag, uint32_t value); 87 88 /* 89 * All constructors for constructed elements have a begin and a end function 90 */ 91 int ossl_DER_w_begin_sequence(WPACKET *pkt, int tag); 92 int ossl_DER_w_end_sequence(WPACKET *pkt, int tag); 93 94 #endif 95