1 /* 2 Unix SMB/CIFS implementation. 3 simple ASN1 code 4 Copyright (C) Andrew Tridgell 2001 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 3 of the License, or 9 (at your option) any later version. 10 11 This program is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 GNU General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with this program. If not, see <http://www.gnu.org/licenses/>. 18 */ 19 20 #ifndef _ASN_1_H 21 #define _ASN_1_H 22 23 #include "replace.h" 24 #include <talloc.h> 25 #include "lib/util/data_blob.h" 26 27 28 struct nesting; 29 struct asn1_data; 30 typedef struct asn1_data ASN1_DATA; 31 32 #define ASN1_APPLICATION(x) ((x)+0x60) 33 #define ASN1_APPLICATION_SIMPLE(x) ((x)+0x40) 34 #define ASN1_SEQUENCE(x) ((x)+0x30) 35 #define ASN1_CONTEXT(x) ((x)+0xa0) 36 #define ASN1_CONTEXT_SIMPLE(x) ((x)+0x80) 37 #define ASN1_GENERAL_STRING 0x1b 38 #define ASN1_OCTET_STRING 0x4 39 #define ASN1_OID 0x6 40 #define ASN1_BOOLEAN 0x1 41 #define ASN1_INTEGER 0x2 42 #define ASN1_BIT_STRING 0x3 43 #define ASN1_ENUMERATED 0xa 44 #define ASN1_SET 0x31 45 46 #define ASN1_MAX_OIDS 20 47 48 /* 49 * The maximum permitted depth for an ASN.1 parse tree, the limit is chosen 50 * to align with the value for windows. Note that this value will trigger 51 * ASAN stack overflow errors. 52 */ 53 #define ASN1_MAX_TREE_DEPTH 512 54 55 struct asn1_data *asn1_init(TALLOC_CTX *mem_ctx, unsigned max_depth); 56 void asn1_free(struct asn1_data *data); 57 bool asn1_has_error(const struct asn1_data *data); 58 void asn1_set_error(struct asn1_data *data); 59 bool asn1_has_nesting(const struct asn1_data *data); 60 off_t asn1_current_ofs(const struct asn1_data *data); 61 bool asn1_write(struct asn1_data *data, const void *p, int len); 62 bool asn1_write_uint8(struct asn1_data *data, uint8_t v); 63 bool asn1_push_tag(struct asn1_data *data, uint8_t tag); 64 bool asn1_pop_tag(struct asn1_data *data); 65 bool asn1_write_implicit_Integer(struct asn1_data *data, int i); 66 bool asn1_write_Integer(struct asn1_data *data, int i); 67 bool asn1_write_BitString(struct asn1_data *data, const void *p, size_t length, uint8_t padding); 68 bool ber_write_OID_String(TALLOC_CTX *mem_ctx, DATA_BLOB *blob, const char *OID); 69 bool ber_write_partial_OID_String(TALLOC_CTX *mem_ctx, DATA_BLOB *blob, const char *partial_oid); 70 bool asn1_write_OID(struct asn1_data *data, const char *OID); 71 bool asn1_write_OctetString(struct asn1_data *data, const void *p, size_t length); 72 bool asn1_write_LDAPString(struct asn1_data *data, const char *s); 73 bool asn1_write_DATA_BLOB_LDAPString(struct asn1_data *data, const DATA_BLOB *s); 74 bool asn1_write_GeneralString(struct asn1_data *data, const char *s); 75 bool asn1_write_ContextSimple(struct asn1_data *data, uint8_t num, DATA_BLOB *blob); 76 bool asn1_write_BOOLEAN(struct asn1_data *data, bool v); 77 bool asn1_read_BOOLEAN(struct asn1_data *data, bool *v); 78 bool asn1_check_BOOLEAN(struct asn1_data *data, bool v); 79 bool asn1_write_BOOLEAN_context(struct asn1_data *data, bool v, int context); 80 bool asn1_read_BOOLEAN_context(struct asn1_data *data, bool *v, int context); 81 bool asn1_load(struct asn1_data *data, DATA_BLOB blob); 82 bool asn1_peek(struct asn1_data *data, void *p, int len); 83 bool asn1_read(struct asn1_data *data, void *p, int len); 84 bool asn1_read_uint8(struct asn1_data *data, uint8_t *v); 85 bool asn1_peek_uint8(struct asn1_data *data, uint8_t *v); 86 bool asn1_peek_tag(struct asn1_data *data, uint8_t tag); 87 bool asn1_start_tag(struct asn1_data *data, uint8_t tag); 88 bool asn1_end_tag(struct asn1_data *data); 89 int asn1_tag_remaining(struct asn1_data *data); 90 bool ber_read_OID_String(TALLOC_CTX *mem_ctx, DATA_BLOB blob, char **OID); 91 bool ber_read_partial_OID_String(TALLOC_CTX *mem_ctx, DATA_BLOB blob, char **partial_oid); 92 bool asn1_read_OID(struct asn1_data *data, TALLOC_CTX *mem_ctx, char **OID); 93 bool asn1_check_OID(struct asn1_data *data, const char *OID); 94 bool asn1_read_LDAPString(struct asn1_data *data, TALLOC_CTX *mem_ctx, char **s); 95 bool asn1_read_GeneralString(struct asn1_data *data, TALLOC_CTX *mem_ctx, char **s); 96 bool asn1_read_OctetString(struct asn1_data *data, TALLOC_CTX *mem_ctx, DATA_BLOB *blob); 97 bool asn1_read_ContextSimple(struct asn1_data *data, TALLOC_CTX *mem_ctx, uint8_t num, DATA_BLOB *blob); 98 bool asn1_read_implicit_Integer(struct asn1_data *data, int *i); 99 bool asn1_read_Integer(struct asn1_data *data, int *i); 100 bool asn1_read_BitString(struct asn1_data *data, TALLOC_CTX *mem_ctx, DATA_BLOB *blob, uint8_t *padding); 101 bool asn1_read_enumerated(struct asn1_data *data, int *v); 102 bool asn1_check_enumerated(struct asn1_data *data, int v); 103 bool asn1_write_enumerated(struct asn1_data *data, uint8_t v); 104 bool asn1_blob(const struct asn1_data *asn1, DATA_BLOB *blob); 105 bool asn1_extract_blob(struct asn1_data *asn1, TALLOC_CTX *mem_ctx, 106 DATA_BLOB *pblob); 107 void asn1_load_nocopy(struct asn1_data *data, uint8_t *buf, size_t len); 108 int asn1_peek_full_tag(DATA_BLOB blob, uint8_t tag, size_t *packet_size); 109 size_t asn1_get_length(const struct asn1_data *asn1); 110 111 #endif /* _ASN_1_H */ 112