Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 1 | /*- |
Lev Walkin | 2c34aad | 2005-03-10 11:50:24 +0000 | [diff] [blame] | 2 | * Copyright (c) 2003, 2004, 2005 Lev Walkin <vlm@lionet.info>. |
| 3 | * All rights reserved. |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 4 | * Redistribution and modifications are permitted subject to BSD license. |
| 5 | */ |
| 6 | #ifndef _OBJECT_IDENTIFIER_H_ |
| 7 | #define _OBJECT_IDENTIFIER_H_ |
| 8 | |
Lev Walkin | 8e8078a | 2004-09-26 13:10:40 +0000 | [diff] [blame] | 9 | #include <asn_application.h> |
Lev Walkin | 3256d6f | 2004-10-21 11:22:12 +0000 | [diff] [blame] | 10 | #include <asn_codecs_prim.h> |
Bi-Ruei, Chiu | e1bf219 | 2017-08-19 00:55:25 +0800 | [diff] [blame] | 11 | #include <OCTET_STRING.h> |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 12 | |
Lev Walkin | 21b41ac | 2005-07-24 09:03:44 +0000 | [diff] [blame] | 13 | #ifdef __cplusplus |
| 14 | extern "C" { |
| 15 | #endif |
| 16 | |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 17 | typedef uint32_t asn_oid_arc_t; |
| 18 | #define ASN_OID_ARC_MAX (~((asn_oid_arc_t)0)) |
| 19 | |
Lev Walkin | 8e8078a | 2004-09-26 13:10:40 +0000 | [diff] [blame] | 20 | typedef ASN__PRIMITIVE_TYPE_t OBJECT_IDENTIFIER_t; |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 21 | |
Lev Walkin | 5e03376 | 2004-09-29 13:26:15 +0000 | [diff] [blame] | 22 | extern asn_TYPE_descriptor_t asn_DEF_OBJECT_IDENTIFIER; |
Bi-Ruei, Chiu | 1f87ac0 | 2017-08-20 01:25:45 +0800 | [diff] [blame] | 23 | extern asn_TYPE_operation_t asn_OP_OBJECT_IDENTIFIER; |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 24 | |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 25 | asn_struct_print_f OBJECT_IDENTIFIER_print; |
Lev Walkin | a9cc46e | 2004-09-22 16:06:28 +0000 | [diff] [blame] | 26 | asn_constr_check_f OBJECT_IDENTIFIER_constraint; |
| 27 | der_type_encoder_f OBJECT_IDENTIFIER_encode_der; |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 28 | xer_type_decoder_f OBJECT_IDENTIFIER_decode_xer; |
Lev Walkin | a9cc46e | 2004-09-22 16:06:28 +0000 | [diff] [blame] | 29 | xer_type_encoder_f OBJECT_IDENTIFIER_encode_xer; |
Lev Walkin | a5972be | 2017-09-29 23:15:58 -0700 | [diff] [blame] | 30 | asn_random_fill_f OBJECT_IDENTIFIER_random_fill; |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 31 | |
Bi-Ruei, Chiu | 1fa31c9 | 2016-05-16 13:50:09 +0800 | [diff] [blame] | 32 | #define OBJECT_IDENTIFIER_free ASN__PRIMITIVE_TYPE_free |
Bi-Ruei, Chiu | e1bf219 | 2017-08-19 00:55:25 +0800 | [diff] [blame] | 33 | #define OBJECT_IDENTIFIER_compare OCTET_STRING_compare |
Bi-Ruei, Chiu | 1fa31c9 | 2016-05-16 13:50:09 +0800 | [diff] [blame] | 34 | #define OBJECT_IDENTIFIER_decode_ber ber_decode_primitive |
| 35 | #define OBJECT_IDENTIFIER_encode_der der_encode_primitive |
Lev Walkin | b5b524b | 2017-10-13 03:14:03 -0700 | [diff] [blame] | 36 | #define OBJECT_IDENTIFIER_decode_oer oer_decode_primitive |
| 37 | #define OBJECT_IDENTIFIER_encode_oer oer_encode_primitive |
Bi-Ruei, Chiu | 1fa31c9 | 2016-05-16 13:50:09 +0800 | [diff] [blame] | 38 | #define OBJECT_IDENTIFIER_decode_uper OCTET_STRING_decode_uper |
| 39 | #define OBJECT_IDENTIFIER_encode_uper OCTET_STRING_encode_uper |
| 40 | |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 41 | /********************************** |
| 42 | * Some handy conversion routines * |
| 43 | **********************************/ |
| 44 | |
| 45 | /* |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 46 | * This function fills an (arcs) array with OBJECT IDENTIFIER arcs |
| 47 | * up to specified (arc_slots) elements. |
| 48 | * |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 49 | * EXAMPLE: |
| 50 | * void print_arcs(OBJECT_IDENTIFIER_t *oid) { |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 51 | * asn_oid_arc_t fixed_arcs[10]; // Try with fixed space first |
| 52 | * asn_oid_arc_t *arcs = fixed_arcs; |
| 53 | * size_t arc_slots = sizeof(fixed_arcs)/sizeof(fixed_arcs[0]); // 10 |
| 54 | * ssize_t count; // Real number of arcs. |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 55 | * int i; |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 56 | * |
| 57 | * count = OBJECT_IDENTIFIER_get_arcs(oid, arcs, arc_slots); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 58 | * // If necessary, reallocate arcs array and try again. |
Lev Walkin | 29a044b | 2004-06-14 07:24:36 +0000 | [diff] [blame] | 59 | * if(count > arc_slots) { |
| 60 | * arc_slots = count; |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 61 | * arcs = malloc(sizeof(asn_oid_arc_t) * arc_slots); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 62 | * if(!arcs) return; |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 63 | * count = OBJECT_IDENTIFIER_get_arcs(oid, arcs, arc_slots); |
Lev Walkin | 29a044b | 2004-06-14 07:24:36 +0000 | [diff] [blame] | 64 | * assert(count == arc_slots); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 65 | * } |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 66 | * |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 67 | * // Print the contents of the arcs array. |
| 68 | * for(i = 0; i < count; i++) |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 69 | * printf("%"PRIu32"\n", arcs[i]); |
| 70 | * |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 71 | * // Avoid memory leak. |
| 72 | * if(arcs != fixed_arcs) free(arcs); |
| 73 | * } |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 74 | * |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 75 | * RETURN VALUES: |
| 76 | * -1/EINVAL: Invalid arguments (oid is missing) |
| 77 | * -1/ERANGE: One or more arcs have value out of array cell type range. |
| 78 | * >=0: Number of arcs contained in the OBJECT IDENTIFIER |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 79 | * |
| 80 | * WARNING: The function always returns the actual number of arcs, |
| 81 | * even if there is no sufficient (arc_slots) provided. |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 82 | */ |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 83 | ssize_t OBJECT_IDENTIFIER_get_arcs(const OBJECT_IDENTIFIER_t *oid, |
| 84 | asn_oid_arc_t *arcs, size_t arc_slots); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 85 | |
| 86 | /* |
| 87 | * This functions initializes the OBJECT IDENTIFIER object with |
| 88 | * the given set of arcs. |
| 89 | * The minimum of two arcs must be present; some restrictions apply. |
| 90 | * RETURN VALUES: |
| 91 | * -1/EINVAL: Invalid arguments |
| 92 | * -1/ERANGE: The first two arcs do not conform to ASN.1 restrictions. |
| 93 | * -1/ENOMEM: Memory allocation failed |
| 94 | * 0: The object was initialized with new arcs. |
| 95 | */ |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 96 | int OBJECT_IDENTIFIER_set_arcs(OBJECT_IDENTIFIER_t *oid, |
| 97 | const asn_oid_arc_t *arcs, size_t arcs_count); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 98 | |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 99 | |
| 100 | /* |
| 101 | * Parse the OBJECT IDENTIFIER textual representation ("1.3.6.1.4.1.9363"). |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 102 | * No arc can exceed the (0..ASN_OID_ARC_MAX, which is the same as UINT32_MAX). |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 103 | * This function is not specific to OBJECT IDENTIFIER, it may be used to parse |
| 104 | * the RELATIVE-OID data, or any other data consisting of dot-separated |
| 105 | * series of numeric values. |
| 106 | * |
| 107 | * If (oid_txt_length == -1), the strlen() will be invoked to determine the |
| 108 | * size of the (oid_text) string. |
| 109 | * |
Lev Walkin | 093ba2e | 2005-04-04 21:10:06 +0000 | [diff] [blame] | 110 | * After return, the optional (opt_oid_text_end) is set to the character after |
| 111 | * the last parsed one. (opt_oid_text_end) is never less than (oid_text). |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 112 | * |
| 113 | * RETURN VALUES: |
| 114 | * -1: Parse error. |
| 115 | * >= 0: Number of arcs contained in the OBJECT IDENTIFIER. |
| 116 | * |
| 117 | * WARNING: The function always returns the real number of arcs, |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 118 | * even if there is no sufficient (arc_slots) provided. |
| 119 | * This is useful for (arc_slots) value estimation. |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 120 | */ |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 121 | ssize_t OBJECT_IDENTIFIER_parse_arcs(const char *oid_text, |
| 122 | ssize_t oid_txt_length, |
| 123 | asn_oid_arc_t *arcs, size_t arcs_count, |
| 124 | const char **opt_oid_text_end); |
Lev Walkin | 9230225 | 2004-10-23 10:16:51 +0000 | [diff] [blame] | 125 | |
| 126 | /* |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 127 | * Internal functions. |
Lev Walkin | 0787ff0 | 2004-06-17 23:43:39 +0000 | [diff] [blame] | 128 | * Used by RELATIVE-OID implementation in particular. |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 129 | */ |
Lev Walkin | 588bf0f | 2017-10-13 23:51:16 -0700 | [diff] [blame^] | 130 | |
| 131 | /* |
| 132 | * Retrieve a single arc of size from the (arcbuf) buffer. |
| 133 | * RETURN VALUES: |
| 134 | * -1: Failed to retrieve the value from the (arcbuf). |
| 135 | * >0: Number of bytes consumed from the (arcbuf), <= (arcbuf_len). |
| 136 | */ |
| 137 | ssize_t OBJECT_IDENTIFIER_get_single_arc(const uint8_t *arcbuf, |
| 138 | size_t arcbuf_len, |
| 139 | asn_oid_arc_t *ret_value); |
| 140 | |
| 141 | /* |
| 142 | * Write the unterminated arc value into the (arcbuf) which has the size at |
| 143 | * least (arcbuf_len). |
| 144 | * RETURN VALUES: |
| 145 | * -1: (arcbuf_len) size is not sufficient to write the value. |
| 146 | * <n>: Number of bytes appended to the arcbuf (<= arcbuf_len). |
| 147 | */ |
| 148 | ssize_t OBJECT_IDENTIFIER_set_single_arc(uint8_t *arcbuf, size_t arcbuf_len, |
| 149 | asn_oid_arc_t arc_value); |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 150 | |
Lev Walkin | 21b41ac | 2005-07-24 09:03:44 +0000 | [diff] [blame] | 151 | #ifdef __cplusplus |
| 152 | } |
| 153 | #endif |
| 154 | |
Lev Walkin | f15320b | 2004-06-03 03:38:44 +0000 | [diff] [blame] | 155 | #endif /* _OBJECT_IDENTIFIER_H_ */ |