asn1t.h 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907
  1. /* $OpenBSD: asn1t.h,v 1.23 2023/07/28 10:00:10 tb Exp $ */
  2. /* Written by Dr Stephen N Henson ([email protected]) for the OpenSSL
  3. * project 2000.
  4. */
  5. /* ====================================================================
  6. * Copyright (c) 2000-2005 The OpenSSL Project. All rights reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in
  17. * the documentation and/or other materials provided with the
  18. * distribution.
  19. *
  20. * 3. All advertising materials mentioning features or use of this
  21. * software must display the following acknowledgment:
  22. * "This product includes software developed by the OpenSSL Project
  23. * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  24. *
  25. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  26. * endorse or promote products derived from this software without
  27. * prior written permission. For written permission, please contact
  28. * [email protected].
  29. *
  30. * 5. Products derived from this software may not be called "OpenSSL"
  31. * nor may "OpenSSL" appear in their names without prior written
  32. * permission of the OpenSSL Project.
  33. *
  34. * 6. Redistributions of any form whatsoever must retain the following
  35. * acknowledgment:
  36. * "This product includes software developed by the OpenSSL Project
  37. * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  38. *
  39. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  40. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  41. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  42. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  43. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  44. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  45. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  46. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  47. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  48. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  49. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  50. * OF THE POSSIBILITY OF SUCH DAMAGE.
  51. * ====================================================================
  52. *
  53. * This product includes cryptographic software written by Eric Young
  54. * ([email protected]). This product includes software written by Tim
  55. * Hudson ([email protected]).
  56. *
  57. */
  58. #ifndef HEADER_ASN1T_H
  59. #define HEADER_ASN1T_H
  60. #include <stddef.h>
  61. #include <openssl/opensslconf.h>
  62. #include <openssl/asn1.h>
  63. /* ASN1 template defines, structures and functions */
  64. #ifdef __cplusplus
  65. extern "C" {
  66. #endif
  67. #ifndef LIBRESSL_INTERNAL
  68. /* Macro to obtain ASN1_ADB pointer from a type (only used internally) */
  69. #define ASN1_ADB_ptr(iptr) ((const ASN1_ADB *)(iptr))
  70. /* Macros for start and end of ASN1_ITEM definition */
  71. #define ASN1_ITEM_start(itname) \
  72. const ASN1_ITEM itname##_it = {
  73. #define static_ASN1_ITEM_start(itname) \
  74. static const ASN1_ITEM itname##_it = {
  75. #define ASN1_ITEM_end(itname) \
  76. };
  77. /* Macros to aid ASN1 template writing */
  78. #define ASN1_ITEM_TEMPLATE(tname) \
  79. static const ASN1_TEMPLATE tname##_item_tt
  80. #define ASN1_ITEM_TEMPLATE_END(tname) \
  81. ;\
  82. ASN1_ITEM_start(tname) \
  83. ASN1_ITYPE_PRIMITIVE,\
  84. -1,\
  85. &tname##_item_tt,\
  86. 0,\
  87. NULL,\
  88. 0,\
  89. #tname \
  90. ASN1_ITEM_end(tname)
  91. #define static_ASN1_ITEM_TEMPLATE_END(tname) \
  92. ;\
  93. static_ASN1_ITEM_start(tname) \
  94. ASN1_ITYPE_PRIMITIVE,\
  95. -1,\
  96. &tname##_item_tt,\
  97. 0,\
  98. NULL,\
  99. 0,\
  100. #tname \
  101. ASN1_ITEM_end(tname)
  102. /* This is a ASN1 type which just embeds a template */
  103. /*
  104. * This pair helps declare a SEQUENCE. We can do:
  105. *
  106. * ASN1_SEQUENCE(stname) = {
  107. * ... SEQUENCE components ...
  108. * } ASN1_SEQUENCE_END(stname)
  109. *
  110. * This will produce an ASN1_ITEM called stname_it
  111. * for a structure called stname.
  112. *
  113. * If you want the same structure but a different
  114. * name then use:
  115. *
  116. * ASN1_SEQUENCE(itname) = {
  117. * ... SEQUENCE components ...
  118. * } ASN1_SEQUENCE_END_name(stname, itname)
  119. *
  120. * This will create an item called itname_it using
  121. * a structure called stname.
  122. */
  123. #define ASN1_SEQUENCE(tname) \
  124. static const ASN1_TEMPLATE tname##_seq_tt[]
  125. #define ASN1_SEQUENCE_END(stname) ASN1_SEQUENCE_END_name(stname, stname)
  126. #define static_ASN1_SEQUENCE_END(stname) static_ASN1_SEQUENCE_END_name(stname, stname)
  127. #define ASN1_SEQUENCE_END_name(stname, tname) \
  128. ;\
  129. ASN1_ITEM_start(tname) \
  130. ASN1_ITYPE_SEQUENCE,\
  131. V_ASN1_SEQUENCE,\
  132. tname##_seq_tt,\
  133. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  134. NULL,\
  135. sizeof(stname),\
  136. #stname \
  137. ASN1_ITEM_end(tname)
  138. #define static_ASN1_SEQUENCE_END_name(stname, tname) \
  139. ;\
  140. static_ASN1_ITEM_start(tname) \
  141. ASN1_ITYPE_SEQUENCE,\
  142. V_ASN1_SEQUENCE,\
  143. tname##_seq_tt,\
  144. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  145. NULL,\
  146. sizeof(stname),\
  147. #stname \
  148. ASN1_ITEM_end(tname)
  149. #define ASN1_NDEF_SEQUENCE(tname) \
  150. ASN1_SEQUENCE(tname)
  151. #define ASN1_NDEF_SEQUENCE_cb(tname, cb) \
  152. ASN1_SEQUENCE_cb(tname, cb)
  153. #define ASN1_SEQUENCE_cb(tname, cb) \
  154. static const ASN1_AUX tname##_aux = {NULL, 0, 0, 0, cb, 0}; \
  155. ASN1_SEQUENCE(tname)
  156. #define ASN1_SEQUENCE_ref(tname, cb, lck) \
  157. static const ASN1_AUX tname##_aux = {NULL, ASN1_AFLG_REFCOUNT, offsetof(tname, references), lck, cb, 0}; \
  158. ASN1_SEQUENCE(tname)
  159. #define ASN1_SEQUENCE_enc(tname, enc, cb) \
  160. static const ASN1_AUX tname##_aux = {NULL, ASN1_AFLG_ENCODING, 0, 0, cb, offsetof(tname, enc)}; \
  161. ASN1_SEQUENCE(tname)
  162. #define ASN1_NDEF_SEQUENCE_END(tname) \
  163. ;\
  164. ASN1_ITEM_start(tname) \
  165. ASN1_ITYPE_NDEF_SEQUENCE,\
  166. V_ASN1_SEQUENCE,\
  167. tname##_seq_tt,\
  168. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  169. NULL,\
  170. sizeof(tname),\
  171. #tname \
  172. ASN1_ITEM_end(tname)
  173. #define static_ASN1_NDEF_SEQUENCE_END(tname) \
  174. ;\
  175. static_ASN1_ITEM_start(tname) \
  176. ASN1_ITYPE_NDEF_SEQUENCE,\
  177. V_ASN1_SEQUENCE,\
  178. tname##_seq_tt,\
  179. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  180. NULL,\
  181. sizeof(tname),\
  182. #tname \
  183. ASN1_ITEM_end(tname)
  184. #define ASN1_SEQUENCE_END_enc(stname, tname) ASN1_SEQUENCE_END_ref(stname, tname)
  185. #define ASN1_SEQUENCE_END_cb(stname, tname) ASN1_SEQUENCE_END_ref(stname, tname)
  186. #define static_ASN1_SEQUENCE_END_cb(stname, tname) static_ASN1_SEQUENCE_END_ref(stname, tname)
  187. #define ASN1_SEQUENCE_END_ref(stname, tname) \
  188. ;\
  189. ASN1_ITEM_start(tname) \
  190. ASN1_ITYPE_SEQUENCE,\
  191. V_ASN1_SEQUENCE,\
  192. tname##_seq_tt,\
  193. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  194. &tname##_aux,\
  195. sizeof(stname),\
  196. #stname \
  197. ASN1_ITEM_end(tname)
  198. #define static_ASN1_SEQUENCE_END_ref(stname, tname) \
  199. ;\
  200. static_ASN1_ITEM_start(tname) \
  201. ASN1_ITYPE_SEQUENCE,\
  202. V_ASN1_SEQUENCE,\
  203. tname##_seq_tt,\
  204. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  205. &tname##_aux,\
  206. sizeof(stname),\
  207. #stname \
  208. ASN1_ITEM_end(tname)
  209. #define ASN1_NDEF_SEQUENCE_END_cb(stname, tname) \
  210. ;\
  211. ASN1_ITEM_start(tname) \
  212. ASN1_ITYPE_NDEF_SEQUENCE,\
  213. V_ASN1_SEQUENCE,\
  214. tname##_seq_tt,\
  215. sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\
  216. &tname##_aux,\
  217. sizeof(stname),\
  218. #stname \
  219. ASN1_ITEM_end(tname)
  220. /*
  221. * This pair helps declare a CHOICE type. We can do:
  222. *
  223. * ASN1_CHOICE(chname) = {
  224. * ... CHOICE options ...
  225. * ASN1_CHOICE_END(chname)
  226. *
  227. * This will produce an ASN1_ITEM called chname_it
  228. * for a structure called chname. The structure
  229. * definition must look like this:
  230. * typedef struct {
  231. * int type;
  232. * union {
  233. * ASN1_SOMETHING *opt1;
  234. * ASN1_SOMEOTHER *opt2;
  235. * } value;
  236. * } chname;
  237. *
  238. * the name of the selector must be 'type'.
  239. * to use an alternative selector name use the
  240. * ASN1_CHOICE_END_selector() version.
  241. */
  242. #define ASN1_CHOICE(tname) \
  243. static const ASN1_TEMPLATE tname##_ch_tt[]
  244. #define ASN1_CHOICE_cb(tname, cb) \
  245. static const ASN1_AUX tname##_aux = {NULL, 0, 0, 0, cb, 0}; \
  246. ASN1_CHOICE(tname)
  247. #define ASN1_CHOICE_END(stname) ASN1_CHOICE_END_name(stname, stname)
  248. #define static_ASN1_CHOICE_END(stname) static_ASN1_CHOICE_END_name(stname, stname)
  249. #define ASN1_CHOICE_END_name(stname, tname) ASN1_CHOICE_END_selector(stname, tname, type)
  250. #define static_ASN1_CHOICE_END_name(stname, tname) static_ASN1_CHOICE_END_selector(stname, tname, type)
  251. #define ASN1_CHOICE_END_selector(stname, tname, selname) \
  252. ;\
  253. ASN1_ITEM_start(tname) \
  254. ASN1_ITYPE_CHOICE,\
  255. offsetof(stname,selname) ,\
  256. tname##_ch_tt,\
  257. sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\
  258. NULL,\
  259. sizeof(stname),\
  260. #stname \
  261. ASN1_ITEM_end(tname)
  262. #define static_ASN1_CHOICE_END_selector(stname, tname, selname) \
  263. ;\
  264. static_ASN1_ITEM_start(tname) \
  265. ASN1_ITYPE_CHOICE,\
  266. offsetof(stname,selname) ,\
  267. tname##_ch_tt,\
  268. sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\
  269. NULL,\
  270. sizeof(stname),\
  271. #stname \
  272. ASN1_ITEM_end(tname)
  273. #define ASN1_CHOICE_END_cb(stname, tname, selname) \
  274. ;\
  275. ASN1_ITEM_start(tname) \
  276. ASN1_ITYPE_CHOICE,\
  277. offsetof(stname,selname) ,\
  278. tname##_ch_tt,\
  279. sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\
  280. &tname##_aux,\
  281. sizeof(stname),\
  282. #stname \
  283. ASN1_ITEM_end(tname)
  284. /* This helps with the template wrapper form of ASN1_ITEM */
  285. #define ASN1_EX_TEMPLATE_TYPE(flags, tag, name, type) { \
  286. (flags), (tag), 0,\
  287. #name, ASN1_ITEM_ref(type) }
  288. /* These help with SEQUENCE or CHOICE components */
  289. /* used to declare other types */
  290. #define ASN1_EX_TYPE(flags, tag, stname, field, type) { \
  291. (flags), (tag), offsetof(stname, field),\
  292. #field, ASN1_ITEM_ref(type) }
  293. /* implicit and explicit helper macros */
  294. #define ASN1_IMP_EX(stname, field, type, tag, ex) \
  295. ASN1_EX_TYPE(ASN1_TFLG_IMPLICIT | ex, tag, stname, field, type)
  296. #define ASN1_EXP_EX(stname, field, type, tag, ex) \
  297. ASN1_EX_TYPE(ASN1_TFLG_EXPLICIT | ex, tag, stname, field, type)
  298. /* Any defined by macros: the field used is in the table itself */
  299. #define ASN1_ADB_OBJECT(tblname) { ASN1_TFLG_ADB_OID, -1, 0, #tblname, (const ASN1_ITEM *)&(tblname##_adb) }
  300. #define ASN1_ADB_INTEGER(tblname) { ASN1_TFLG_ADB_INT, -1, 0, #tblname, (const ASN1_ITEM *)&(tblname##_adb) }
  301. /* Plain simple type */
  302. #define ASN1_SIMPLE(stname, field, type) ASN1_EX_TYPE(0,0, stname, field, type)
  303. /* OPTIONAL simple type */
  304. #define ASN1_OPT(stname, field, type) ASN1_EX_TYPE(ASN1_TFLG_OPTIONAL, 0, stname, field, type)
  305. /* IMPLICIT tagged simple type */
  306. #define ASN1_IMP(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, 0)
  307. /* IMPLICIT tagged OPTIONAL simple type */
  308. #define ASN1_IMP_OPT(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL)
  309. /* Same as above but EXPLICIT */
  310. #define ASN1_EXP(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, 0)
  311. #define ASN1_EXP_OPT(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL)
  312. /* SEQUENCE OF type */
  313. #define ASN1_SEQUENCE_OF(stname, field, type) \
  314. ASN1_EX_TYPE(ASN1_TFLG_SEQUENCE_OF, 0, stname, field, type)
  315. /* OPTIONAL SEQUENCE OF */
  316. #define ASN1_SEQUENCE_OF_OPT(stname, field, type) \
  317. ASN1_EX_TYPE(ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL, 0, stname, field, type)
  318. /* Same as above but for SET OF */
  319. #define ASN1_SET_OF(stname, field, type) \
  320. ASN1_EX_TYPE(ASN1_TFLG_SET_OF, 0, stname, field, type)
  321. #define ASN1_SET_OF_OPT(stname, field, type) \
  322. ASN1_EX_TYPE(ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL, 0, stname, field, type)
  323. /* Finally compound types of SEQUENCE, SET, IMPLICIT, EXPLICIT and OPTIONAL */
  324. #define ASN1_IMP_SET_OF(stname, field, type, tag) \
  325. ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF)
  326. #define ASN1_EXP_SET_OF(stname, field, type, tag) \
  327. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF)
  328. #define ASN1_IMP_SET_OF_OPT(stname, field, type, tag) \
  329. ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL)
  330. #define ASN1_EXP_SET_OF_OPT(stname, field, type, tag) \
  331. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL)
  332. #define ASN1_IMP_SEQUENCE_OF(stname, field, type, tag) \
  333. ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF)
  334. #define ASN1_IMP_SEQUENCE_OF_OPT(stname, field, type, tag) \
  335. ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL)
  336. #define ASN1_EXP_SEQUENCE_OF(stname, field, type, tag) \
  337. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF)
  338. #define ASN1_EXP_SEQUENCE_OF_OPT(stname, field, type, tag) \
  339. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL)
  340. /* EXPLICIT using indefinite length constructed form */
  341. #define ASN1_NDEF_EXP(stname, field, type, tag) \
  342. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_NDEF)
  343. /* EXPLICIT OPTIONAL using indefinite length constructed form */
  344. #define ASN1_NDEF_EXP_OPT(stname, field, type, tag) \
  345. ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL|ASN1_TFLG_NDEF)
  346. /* Macros for the ASN1_ADB structure */
  347. #define ASN1_ADB(name) \
  348. static const ASN1_ADB_TABLE name##_adbtbl[]
  349. #define ASN1_ADB_END(name, flags, field, app_table, def, none) \
  350. ;\
  351. static const ASN1_ADB name##_adb = {\
  352. flags,\
  353. offsetof(name, field),\
  354. app_table,\
  355. name##_adbtbl,\
  356. sizeof(name##_adbtbl) / sizeof(ASN1_ADB_TABLE),\
  357. def,\
  358. none\
  359. }
  360. #define ADB_ENTRY(val, template) {val, template}
  361. #define ASN1_ADB_TEMPLATE(name) \
  362. static const ASN1_TEMPLATE name##_tt
  363. #endif /* !LIBRESSL_INTERNAL */
  364. /* This is the ASN1 template structure that defines
  365. * a wrapper round the actual type. It determines the
  366. * actual position of the field in the value structure,
  367. * various flags such as OPTIONAL and the field name.
  368. */
  369. struct ASN1_TEMPLATE_st {
  370. unsigned long flags; /* Various flags */
  371. long tag; /* tag, not used if no tagging */
  372. unsigned long offset; /* Offset of this field in structure */
  373. const char *field_name; /* Field name */
  374. ASN1_ITEM_EXP *item; /* Relevant ASN1_ITEM or ASN1_ADB */
  375. };
  376. /* Macro to extract ASN1_ITEM and ASN1_ADB pointer from ASN1_TEMPLATE */
  377. #define ASN1_TEMPLATE_item(t) (t->item_ptr)
  378. #define ASN1_TEMPLATE_adb(t) (t->item_ptr)
  379. typedef struct ASN1_ADB_TABLE_st ASN1_ADB_TABLE;
  380. typedef struct ASN1_ADB_st ASN1_ADB;
  381. struct ASN1_ADB_st {
  382. unsigned long flags; /* Various flags */
  383. unsigned long offset; /* Offset of selector field */
  384. const ASN1_ADB_TABLE *tbl; /* Table of possible types */
  385. long tblcount; /* Number of entries in tbl */
  386. const ASN1_TEMPLATE *default_tt; /* Type to use if no match */
  387. const ASN1_TEMPLATE *null_tt; /* Type to use if selector is NULL */
  388. };
  389. struct ASN1_ADB_TABLE_st {
  390. long value; /* NID for an object or value for an int */
  391. const ASN1_TEMPLATE tt; /* item for this value */
  392. };
  393. /* template flags */
  394. /* Field is optional */
  395. #define ASN1_TFLG_OPTIONAL (0x1)
  396. /* Field is a SET OF */
  397. #define ASN1_TFLG_SET_OF (0x1 << 1)
  398. /* Field is a SEQUENCE OF */
  399. #define ASN1_TFLG_SEQUENCE_OF (0x2 << 1)
  400. /* Special case: this refers to a SET OF that
  401. * will be sorted into DER order when encoded *and*
  402. * the corresponding STACK will be modified to match
  403. * the new order.
  404. */
  405. #define ASN1_TFLG_SET_ORDER (0x3 << 1)
  406. /* Mask for SET OF or SEQUENCE OF */
  407. #define ASN1_TFLG_SK_MASK (0x3 << 1)
  408. /* These flags mean the tag should be taken from the
  409. * tag field. If EXPLICIT then the underlying type
  410. * is used for the inner tag.
  411. */
  412. /* IMPLICIT tagging */
  413. #define ASN1_TFLG_IMPTAG (0x1 << 3)
  414. /* EXPLICIT tagging, inner tag from underlying type */
  415. #define ASN1_TFLG_EXPTAG (0x2 << 3)
  416. #define ASN1_TFLG_TAG_MASK (0x3 << 3)
  417. /* context specific IMPLICIT */
  418. #define ASN1_TFLG_IMPLICIT ASN1_TFLG_IMPTAG|ASN1_TFLG_CONTEXT
  419. /* context specific EXPLICIT */
  420. #define ASN1_TFLG_EXPLICIT ASN1_TFLG_EXPTAG|ASN1_TFLG_CONTEXT
  421. /*
  422. * If tagging is in force these determine the type of tag to use. Otherwiser
  423. * the tag is determined by the underlying type. These values reflect the
  424. * actual octet format.
  425. */
  426. /* Universal tag */
  427. #define ASN1_TFLG_UNIVERSAL (0x0<<6)
  428. /* Application tag */
  429. #define ASN1_TFLG_APPLICATION (0x1<<6)
  430. /* Context specific tag */
  431. #define ASN1_TFLG_CONTEXT (0x2<<6)
  432. /* Private tag */
  433. #define ASN1_TFLG_PRIVATE (0x3<<6)
  434. #define ASN1_TFLG_TAG_CLASS (0x3<<6)
  435. /*
  436. * These are for ANY DEFINED BY type. In this case
  437. * the 'item' field points to an ASN1_ADB structure
  438. * which contains a table of values to decode the
  439. * relevant type
  440. */
  441. #define ASN1_TFLG_ADB_MASK (0x3<<8)
  442. #define ASN1_TFLG_ADB_OID (0x1<<8)
  443. #define ASN1_TFLG_ADB_INT (0x1<<9)
  444. /*
  445. * This flag when present in a SEQUENCE OF, SET OF
  446. * or EXPLICIT causes indefinite length constructed
  447. * encoding to be used if required.
  448. */
  449. #define ASN1_TFLG_NDEF (0x1<<11)
  450. /* This is the actual ASN1 item itself */
  451. struct ASN1_ITEM_st {
  452. char itype; /* The item type, primitive, SEQUENCE, CHOICE or extern */
  453. long utype; /* underlying type */
  454. const ASN1_TEMPLATE *templates; /* If SEQUENCE or CHOICE this contains the contents */
  455. long tcount; /* Number of templates if SEQUENCE or CHOICE */
  456. const void *funcs; /* functions that handle this type */
  457. long size; /* Structure size (usually)*/
  458. const char *sname; /* Structure name */
  459. };
  460. /* These are values for the itype field and
  461. * determine how the type is interpreted.
  462. *
  463. * For PRIMITIVE types the underlying type
  464. * determines the behaviour if items is NULL.
  465. *
  466. * Otherwise templates must contain a single
  467. * template and the type is treated in the
  468. * same way as the type specified in the template.
  469. *
  470. * For SEQUENCE types the templates field points
  471. * to the members, the size field is the
  472. * structure size.
  473. *
  474. * For CHOICE types the templates field points
  475. * to each possible member (typically a union)
  476. * and the 'size' field is the offset of the
  477. * selector.
  478. *
  479. * The 'funcs' field is used for application
  480. * specific functions.
  481. *
  482. * The EXTERN type uses a new style d2i/i2d.
  483. * The new style should be used where possible
  484. * because it avoids things like the d2i IMPLICIT
  485. * hack.
  486. *
  487. * MSTRING is a multiple string type, it is used
  488. * for a CHOICE of character strings where the
  489. * actual strings all occupy an ASN1_STRING
  490. * structure. In this case the 'utype' field
  491. * has a special meaning, it is used as a mask
  492. * of acceptable types using the B_ASN1 constants.
  493. *
  494. * NDEF_SEQUENCE is the same as SEQUENCE except
  495. * that it will use indefinite length constructed
  496. * encoding if requested.
  497. *
  498. */
  499. #define ASN1_ITYPE_PRIMITIVE 0x0
  500. #define ASN1_ITYPE_SEQUENCE 0x1
  501. #define ASN1_ITYPE_CHOICE 0x2
  502. #define ASN1_ITYPE_EXTERN 0x4
  503. #define ASN1_ITYPE_MSTRING 0x5
  504. #define ASN1_ITYPE_NDEF_SEQUENCE 0x6
  505. /* Cache for ASN1 tag and length, so we
  506. * don't keep re-reading it for things
  507. * like CHOICE
  508. */
  509. struct ASN1_TLC_st {
  510. char valid; /* Values below are valid */
  511. int ret; /* return value */
  512. long plen; /* length */
  513. int ptag; /* class value */
  514. int pclass; /* class value */
  515. int hdrlen; /* header length */
  516. };
  517. /* Typedefs for ASN1 function pointers */
  518. typedef ASN1_VALUE * ASN1_new_func(void);
  519. typedef void ASN1_free_func(ASN1_VALUE *a);
  520. typedef ASN1_VALUE * ASN1_d2i_func(ASN1_VALUE **a, const unsigned char ** in, long length);
  521. typedef int ASN1_i2d_func(ASN1_VALUE * a, unsigned char **in);
  522. typedef int ASN1_ex_d2i(ASN1_VALUE **pval, const unsigned char **in, long len, const ASN1_ITEM *it,
  523. int tag, int aclass, char opt, ASN1_TLC *ctx);
  524. typedef int ASN1_ex_i2d(ASN1_VALUE **pval, unsigned char **out, const ASN1_ITEM *it, int tag, int aclass);
  525. typedef int ASN1_ex_new_func(ASN1_VALUE **pval, const ASN1_ITEM *it);
  526. typedef void ASN1_ex_free_func(ASN1_VALUE **pval, const ASN1_ITEM *it);
  527. typedef int ASN1_ex_print_func(BIO *out, ASN1_VALUE **pval,
  528. int indent, const char *fname,
  529. const ASN1_PCTX *pctx);
  530. typedef int ASN1_primitive_i2c(ASN1_VALUE **pval, unsigned char *cont, int *putype, const ASN1_ITEM *it);
  531. typedef int ASN1_primitive_c2i(ASN1_VALUE **pval, const unsigned char *cont, int len, int utype, char *free_cont, const ASN1_ITEM *it);
  532. typedef int ASN1_primitive_print(BIO *out, ASN1_VALUE **pval, const ASN1_ITEM *it, int indent, const ASN1_PCTX *pctx);
  533. typedef struct ASN1_EXTERN_FUNCS_st {
  534. void *app_data;
  535. ASN1_ex_new_func *asn1_ex_new;
  536. ASN1_ex_free_func *asn1_ex_free;
  537. ASN1_ex_free_func *asn1_ex_clear;
  538. ASN1_ex_d2i *asn1_ex_d2i;
  539. ASN1_ex_i2d *asn1_ex_i2d;
  540. ASN1_ex_print_func *asn1_ex_print;
  541. } ASN1_EXTERN_FUNCS;
  542. typedef struct ASN1_PRIMITIVE_FUNCS_st {
  543. void *app_data;
  544. unsigned long flags;
  545. ASN1_ex_new_func *prim_new;
  546. ASN1_ex_free_func *prim_free;
  547. ASN1_ex_free_func *prim_clear;
  548. ASN1_primitive_c2i *prim_c2i;
  549. ASN1_primitive_i2c *prim_i2c;
  550. ASN1_primitive_print *prim_print;
  551. } ASN1_PRIMITIVE_FUNCS;
  552. /* This is the ASN1_AUX structure: it handles various
  553. * miscellaneous requirements. For example the use of
  554. * reference counts and an informational callback.
  555. *
  556. * The "informational callback" is called at various
  557. * points during the ASN1 encoding and decoding. It can
  558. * be used to provide minor customisation of the structures
  559. * used. This is most useful where the supplied routines
  560. * *almost* do the right thing but need some extra help
  561. * at a few points. If the callback returns zero then
  562. * it is assumed a fatal error has occurred and the
  563. * main operation should be abandoned.
  564. *
  565. * If major changes in the default behaviour are required
  566. * then an external type is more appropriate.
  567. */
  568. typedef int ASN1_aux_cb(int operation, ASN1_VALUE **in, const ASN1_ITEM *it,
  569. void *exarg);
  570. typedef struct ASN1_AUX_st {
  571. void *app_data;
  572. int flags;
  573. int ref_offset; /* Offset of reference value */
  574. int ref_lock; /* Lock type to use */
  575. ASN1_aux_cb *asn1_cb;
  576. int enc_offset; /* Offset of ASN1_ENCODING structure */
  577. } ASN1_AUX;
  578. /* For print related callbacks exarg points to this structure */
  579. typedef struct ASN1_PRINT_ARG_st {
  580. BIO *out;
  581. int indent;
  582. const ASN1_PCTX *pctx;
  583. } ASN1_PRINT_ARG;
  584. /* For streaming related callbacks exarg points to this structure */
  585. typedef struct ASN1_STREAM_ARG_st {
  586. /* BIO to stream through */
  587. BIO *out;
  588. /* BIO with filters appended */
  589. BIO *ndef_bio;
  590. /* Streaming I/O boundary */
  591. unsigned char **boundary;
  592. } ASN1_STREAM_ARG;
  593. /* Flags in ASN1_AUX */
  594. /* Use a reference count */
  595. #define ASN1_AFLG_REFCOUNT 1
  596. /* Save the encoding of structure (useful for signatures) */
  597. #define ASN1_AFLG_ENCODING 2
  598. /* operation values for asn1_cb */
  599. #define ASN1_OP_NEW_PRE 0
  600. #define ASN1_OP_NEW_POST 1
  601. #define ASN1_OP_FREE_PRE 2
  602. #define ASN1_OP_FREE_POST 3
  603. #define ASN1_OP_D2I_PRE 4
  604. #define ASN1_OP_D2I_POST 5
  605. #define ASN1_OP_I2D_PRE 6
  606. #define ASN1_OP_I2D_POST 7
  607. #define ASN1_OP_PRINT_PRE 8
  608. #define ASN1_OP_PRINT_POST 9
  609. #define ASN1_OP_STREAM_PRE 10
  610. #define ASN1_OP_STREAM_POST 11
  611. #define ASN1_OP_DETACHED_PRE 12
  612. #define ASN1_OP_DETACHED_POST 13
  613. #ifndef LIBRESSL_INTERNAL
  614. /* Macro to implement a primitive type */
  615. #define IMPLEMENT_ASN1_TYPE(stname) IMPLEMENT_ASN1_TYPE_ex(stname, stname, 0)
  616. #define IMPLEMENT_ASN1_TYPE_ex(itname, vname, ex) \
  617. ASN1_ITEM_start(itname) \
  618. ASN1_ITYPE_PRIMITIVE, V_##vname, NULL, 0, NULL, ex, #itname \
  619. ASN1_ITEM_end(itname)
  620. /* Macro to implement a multi string type */
  621. #define IMPLEMENT_ASN1_MSTRING(itname, mask) \
  622. ASN1_ITEM_start(itname) \
  623. ASN1_ITYPE_MSTRING, mask, NULL, 0, NULL, sizeof(ASN1_STRING), #itname \
  624. ASN1_ITEM_end(itname)
  625. #define IMPLEMENT_EXTERN_ASN1(sname, tag, fptrs) \
  626. ASN1_ITEM_start(sname) \
  627. ASN1_ITYPE_EXTERN, \
  628. tag, \
  629. NULL, \
  630. 0, \
  631. &fptrs, \
  632. 0, \
  633. #sname \
  634. ASN1_ITEM_end(sname)
  635. /* Macro to implement standard functions in terms of ASN1_ITEM structures */
  636. #define IMPLEMENT_ASN1_FUNCTIONS(stname) IMPLEMENT_ASN1_FUNCTIONS_fname(stname, stname, stname)
  637. #define IMPLEMENT_ASN1_FUNCTIONS_name(stname, itname) IMPLEMENT_ASN1_FUNCTIONS_fname(stname, itname, itname)
  638. #define IMPLEMENT_ASN1_FUNCTIONS_ENCODE_name(stname, itname) \
  639. IMPLEMENT_ASN1_FUNCTIONS_ENCODE_fname(stname, itname, itname)
  640. #define IMPLEMENT_STATIC_ASN1_ALLOC_FUNCTIONS(stname) \
  641. IMPLEMENT_ASN1_ALLOC_FUNCTIONS_pfname(static, stname, stname, stname)
  642. #define IMPLEMENT_ASN1_ALLOC_FUNCTIONS(stname) \
  643. IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, stname, stname)
  644. #define IMPLEMENT_ASN1_ALLOC_FUNCTIONS_pfname(pre, stname, itname, fname) \
  645. pre stname *fname##_new(void) \
  646. { \
  647. return (stname *)ASN1_item_new(ASN1_ITEM_rptr(itname)); \
  648. } \
  649. pre void fname##_free(stname *a) \
  650. { \
  651. ASN1_item_free((ASN1_VALUE *)a, ASN1_ITEM_rptr(itname)); \
  652. }
  653. #define IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname) \
  654. stname *fname##_new(void) \
  655. { \
  656. return (stname *)ASN1_item_new(ASN1_ITEM_rptr(itname)); \
  657. } \
  658. void fname##_free(stname *a) \
  659. { \
  660. ASN1_item_free((ASN1_VALUE *)a, ASN1_ITEM_rptr(itname)); \
  661. }
  662. #define IMPLEMENT_ASN1_FUNCTIONS_fname(stname, itname, fname) \
  663. IMPLEMENT_ASN1_ENCODE_FUNCTIONS_fname(stname, itname, fname) \
  664. IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname)
  665. #define IMPLEMENT_ASN1_ENCODE_FUNCTIONS_fname(stname, itname, fname) \
  666. stname *d2i_##fname(stname **a, const unsigned char **in, long len) \
  667. { \
  668. return (stname *)ASN1_item_d2i((ASN1_VALUE **)a, in, len, ASN1_ITEM_rptr(itname));\
  669. } \
  670. int i2d_##fname(stname *a, unsigned char **out) \
  671. { \
  672. return ASN1_item_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(itname));\
  673. }
  674. #define IMPLEMENT_ASN1_NDEF_FUNCTION(stname) \
  675. int i2d_##stname##_NDEF(stname *a, unsigned char **out) \
  676. { \
  677. return ASN1_item_ndef_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(stname));\
  678. }
  679. /* This includes evil casts to remove const: they will go away when full
  680. * ASN1 constification is done.
  681. */
  682. #define IMPLEMENT_ASN1_ENCODE_FUNCTIONS_const_fname(stname, itname, fname) \
  683. stname *d2i_##fname(stname **a, const unsigned char **in, long len) \
  684. { \
  685. return (stname *)ASN1_item_d2i((ASN1_VALUE **)a, in, len, ASN1_ITEM_rptr(itname));\
  686. } \
  687. int i2d_##fname(const stname *a, unsigned char **out) \
  688. { \
  689. return ASN1_item_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(itname));\
  690. }
  691. #define IMPLEMENT_ASN1_DUP_FUNCTION(stname) \
  692. stname * stname##_dup(stname *x) \
  693. { \
  694. return ASN1_item_dup(ASN1_ITEM_rptr(stname), x); \
  695. }
  696. #define IMPLEMENT_ASN1_PRINT_FUNCTION(stname) \
  697. IMPLEMENT_ASN1_PRINT_FUNCTION_fname(stname, stname, stname)
  698. #define IMPLEMENT_ASN1_PRINT_FUNCTION_fname(stname, itname, fname) \
  699. int fname##_print_ctx(BIO *out, stname *x, int indent, \
  700. const ASN1_PCTX *pctx) \
  701. { \
  702. return ASN1_item_print(out, (ASN1_VALUE *)x, indent, \
  703. ASN1_ITEM_rptr(itname), pctx); \
  704. }
  705. #define IMPLEMENT_ASN1_FUNCTIONS_const(name) \
  706. IMPLEMENT_ASN1_FUNCTIONS_const_fname(name, name, name)
  707. #define IMPLEMENT_ASN1_FUNCTIONS_const_fname(stname, itname, fname) \
  708. IMPLEMENT_ASN1_ENCODE_FUNCTIONS_const_fname(stname, itname, fname) \
  709. IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname)
  710. #endif /* !LIBRESSL_INTERNAL */
  711. /* external definitions for primitive types */
  712. extern const ASN1_ITEM ASN1_BOOLEAN_it;
  713. extern const ASN1_ITEM ASN1_TBOOLEAN_it;
  714. extern const ASN1_ITEM ASN1_FBOOLEAN_it;
  715. extern const ASN1_ITEM ASN1_SEQUENCE_it;
  716. extern const ASN1_ITEM BIGNUM_it;
  717. extern const ASN1_ITEM LONG_it;
  718. extern const ASN1_ITEM ZLONG_it;
  719. #ifndef LIBRESSL_INTERNAL
  720. extern const ASN1_ITEM CBIGNUM_it;
  721. #endif
  722. DECLARE_STACK_OF(ASN1_VALUE)
  723. /* Functions used internally by the ASN1 code */
  724. int ASN1_item_ex_new(ASN1_VALUE **pval, const ASN1_ITEM *it);
  725. void ASN1_item_ex_free(ASN1_VALUE **pval, const ASN1_ITEM *it);
  726. int ASN1_item_ex_d2i(ASN1_VALUE **pval, const unsigned char **in, long len, const ASN1_ITEM *it,
  727. int tag, int aclass, char opt, ASN1_TLC *ctx);
  728. int ASN1_item_ex_i2d(ASN1_VALUE **pval, unsigned char **out, const ASN1_ITEM *it, int tag, int aclass);
  729. #ifdef __cplusplus
  730. }
  731. #endif
  732. #endif