xref: /openbsd-src/lib/libcrypto/x509/x509v3.h (revision fc405d53b73a2d73393cb97f684863d17b583e38)
1 /* $OpenBSD: x509v3.h,v 1.24 2023/04/25 19:01:01 tb Exp $ */
2 /* Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
3  * project 1999.
4  */
5 /* ====================================================================
6  * Copyright (c) 1999-2004 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  *    licensing@OpenSSL.org.
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  * (eay@cryptsoft.com).  This product includes software written by Tim
55  * Hudson (tjh@cryptsoft.com).
56  *
57  */
58 #ifndef HEADER_X509V3_H
59 #define HEADER_X509V3_H
60 
61 #include <openssl/opensslconf.h>
62 
63 #include <openssl/bio.h>
64 #include <openssl/x509.h>
65 #include <openssl/conf.h>
66 
67 #ifdef __cplusplus
68 extern "C" {
69 #endif
70 
71 /* Forward reference */
72 struct v3_ext_method;
73 struct v3_ext_ctx;
74 
75 /* Useful typedefs */
76 
77 typedef void * (*X509V3_EXT_NEW)(void);
78 typedef void (*X509V3_EXT_FREE)(void *);
79 typedef void * (*X509V3_EXT_D2I)(void *, const unsigned char ** , long);
80 typedef int (*X509V3_EXT_I2D)(void *, unsigned char **);
81 typedef STACK_OF(CONF_VALUE) *
82   (*X509V3_EXT_I2V)(const struct v3_ext_method *method, void *ext,
83 		    STACK_OF(CONF_VALUE) *extlist);
84 typedef void * (*X509V3_EXT_V2I)(const struct v3_ext_method *method,
85 				 struct v3_ext_ctx *ctx,
86 				 STACK_OF(CONF_VALUE) *values);
87 typedef char * (*X509V3_EXT_I2S)(const struct v3_ext_method *method, void *ext);
88 typedef void * (*X509V3_EXT_S2I)(const struct v3_ext_method *method,
89 				 struct v3_ext_ctx *ctx, const char *str);
90 typedef int (*X509V3_EXT_I2R)(const struct v3_ext_method *method, void *ext,
91 			      BIO *out, int indent);
92 typedef void * (*X509V3_EXT_R2I)(const struct v3_ext_method *method,
93 				 struct v3_ext_ctx *ctx, const char *str);
94 
95 /* V3 extension structure */
96 
97 struct v3_ext_method {
98 	int ext_nid;
99 	int ext_flags;
100 	/* If this is set the following four fields are ignored */
101 	ASN1_ITEM_EXP *it;
102 	/* Old style ASN1 calls */
103 	X509V3_EXT_NEW ext_new;
104 	X509V3_EXT_FREE ext_free;
105 	X509V3_EXT_D2I d2i;
106 	X509V3_EXT_I2D i2d;
107 
108 	/* The following pair is used for string extensions */
109 	X509V3_EXT_I2S i2s;
110 	X509V3_EXT_S2I s2i;
111 
112 	/* The following pair is used for multi-valued extensions */
113 	X509V3_EXT_I2V i2v;
114 	X509V3_EXT_V2I v2i;
115 
116 	/* The following are used for raw extensions */
117 	X509V3_EXT_I2R i2r;
118 	X509V3_EXT_R2I r2i;
119 
120 	void *usr_data;	/* Any extension specific data */
121 };
122 
123 typedef struct X509V3_CONF_METHOD_st {
124 	char *(*get_string)(void *db, const char *section, const char *value);
125 	STACK_OF(CONF_VALUE) *(*get_section)(void *db, const char *section);
126 	void (*free_string)(void *db, char *string);
127 	void (*free_section)(void *db, STACK_OF(CONF_VALUE) *section);
128 } X509V3_CONF_METHOD;
129 
130 /* Context specific info */
131 struct v3_ext_ctx {
132 	#define CTX_TEST 0x1
133 	int flags;
134 	X509 *issuer_cert;
135 	X509 *subject_cert;
136 	X509_REQ *subject_req;
137 	X509_CRL *crl;
138 	X509V3_CONF_METHOD *db_meth;
139 	void *db;
140 	/* Maybe more here */
141 };
142 
143 typedef struct v3_ext_method X509V3_EXT_METHOD;
144 
145 DECLARE_STACK_OF(X509V3_EXT_METHOD)
146 
147 /* ext_flags values */
148 #define X509V3_EXT_DYNAMIC	0x1
149 #define X509V3_EXT_CTX_DEP	0x2
150 #define X509V3_EXT_MULTILINE	0x4
151 
152 typedef BIT_STRING_BITNAME ENUMERATED_NAMES;
153 
154 typedef struct BASIC_CONSTRAINTS_st {
155 	int ca;
156 	ASN1_INTEGER *pathlen;
157 } BASIC_CONSTRAINTS;
158 
159 
160 typedef struct PKEY_USAGE_PERIOD_st {
161 	ASN1_GENERALIZEDTIME *notBefore;
162 	ASN1_GENERALIZEDTIME *notAfter;
163 } PKEY_USAGE_PERIOD;
164 
165 typedef struct otherName_st {
166 	ASN1_OBJECT *type_id;
167 	ASN1_TYPE *value;
168 } OTHERNAME;
169 
170 typedef struct EDIPartyName_st {
171 	ASN1_STRING *nameAssigner;
172 	ASN1_STRING *partyName;
173 } EDIPARTYNAME;
174 
175 typedef struct GENERAL_NAME_st {
176 
177 	#define GEN_OTHERNAME	0
178 	#define GEN_EMAIL	1
179 	#define GEN_DNS		2
180 	#define GEN_X400	3
181 	#define GEN_DIRNAME	4
182 	#define GEN_EDIPARTY	5
183 	#define GEN_URI		6
184 	#define GEN_IPADD	7
185 	#define GEN_RID		8
186 
187 	int type;
188 	union {
189 		char *ptr;
190 		OTHERNAME *otherName; /* otherName */
191 		ASN1_IA5STRING *rfc822Name;
192 		ASN1_IA5STRING *dNSName;
193 		ASN1_STRING *x400Address;
194 		X509_NAME *directoryName;
195 		EDIPARTYNAME *ediPartyName;
196 		ASN1_IA5STRING *uniformResourceIdentifier;
197 		ASN1_OCTET_STRING *iPAddress;
198 		ASN1_OBJECT *registeredID;
199 
200 		/* Old names */
201 		ASN1_OCTET_STRING *ip; /* iPAddress */
202 		X509_NAME *dirn;		/* dirn */
203 		ASN1_IA5STRING *ia5; /* rfc822Name, dNSName, uniformResourceIdentifier */
204 		ASN1_OBJECT *rid; /* registeredID */
205 	} d;
206 } GENERAL_NAME;
207 
208 typedef struct ACCESS_DESCRIPTION_st {
209 	ASN1_OBJECT *method;
210 	GENERAL_NAME *location;
211 } ACCESS_DESCRIPTION;
212 
213 typedef STACK_OF(ACCESS_DESCRIPTION) AUTHORITY_INFO_ACCESS;
214 
215 typedef STACK_OF(ASN1_OBJECT) EXTENDED_KEY_USAGE;
216 
217 DECLARE_STACK_OF(GENERAL_NAME)
218 
219 typedef STACK_OF(GENERAL_NAME) GENERAL_NAMES;
220 DECLARE_STACK_OF(GENERAL_NAMES)
221 
222 DECLARE_STACK_OF(ACCESS_DESCRIPTION)
223 
224 typedef struct DIST_POINT_NAME_st {
225 	int type;
226 	union {
227 		GENERAL_NAMES *fullname;
228 		STACK_OF(X509_NAME_ENTRY) *relativename;
229 	} name;
230 	/* If relativename then this contains the full distribution point name */
231 	X509_NAME *dpname;
232 } DIST_POINT_NAME;
233 /* All existing reasons */
234 #define CRLDP_ALL_REASONS	0x807f
235 
236 #define CRL_REASON_NONE				-1
237 #define CRL_REASON_UNSPECIFIED			0
238 #define CRL_REASON_KEY_COMPROMISE		1
239 #define CRL_REASON_CA_COMPROMISE		2
240 #define CRL_REASON_AFFILIATION_CHANGED		3
241 #define CRL_REASON_SUPERSEDED			4
242 #define CRL_REASON_CESSATION_OF_OPERATION	5
243 #define CRL_REASON_CERTIFICATE_HOLD		6
244 #define CRL_REASON_REMOVE_FROM_CRL		8
245 #define CRL_REASON_PRIVILEGE_WITHDRAWN		9
246 #define CRL_REASON_AA_COMPROMISE		10
247 
248 struct DIST_POINT_st {
249 	DIST_POINT_NAME	*distpoint;
250 	ASN1_BIT_STRING *reasons;
251 	GENERAL_NAMES *CRLissuer;
252 	int dp_reasons;
253 };
254 
255 typedef STACK_OF(DIST_POINT) CRL_DIST_POINTS;
256 
257 DECLARE_STACK_OF(DIST_POINT)
258 
259 struct AUTHORITY_KEYID_st {
260 	ASN1_OCTET_STRING *keyid;
261 	GENERAL_NAMES *issuer;
262 	ASN1_INTEGER *serial;
263 };
264 
265 typedef struct NOTICEREF_st {
266 	ASN1_STRING *organization;
267 	STACK_OF(ASN1_INTEGER) *noticenos;
268 } NOTICEREF;
269 
270 typedef struct USERNOTICE_st {
271 	NOTICEREF *noticeref;
272 	ASN1_STRING *exptext;
273 } USERNOTICE;
274 
275 typedef struct POLICYQUALINFO_st {
276 	ASN1_OBJECT *pqualid;
277 	union {
278 		ASN1_IA5STRING *cpsuri;
279 		USERNOTICE *usernotice;
280 		ASN1_TYPE *other;
281 	} d;
282 } POLICYQUALINFO;
283 
284 DECLARE_STACK_OF(POLICYQUALINFO)
285 
286 typedef struct POLICYINFO_st {
287 	ASN1_OBJECT *policyid;
288 	STACK_OF(POLICYQUALINFO) *qualifiers;
289 } POLICYINFO;
290 
291 typedef STACK_OF(POLICYINFO) CERTIFICATEPOLICIES;
292 
293 DECLARE_STACK_OF(POLICYINFO)
294 
295 typedef struct POLICY_MAPPING_st {
296 	ASN1_OBJECT *issuerDomainPolicy;
297 	ASN1_OBJECT *subjectDomainPolicy;
298 } POLICY_MAPPING;
299 
300 DECLARE_STACK_OF(POLICY_MAPPING)
301 
302 typedef STACK_OF(POLICY_MAPPING) POLICY_MAPPINGS;
303 
304 typedef struct GENERAL_SUBTREE_st {
305 	GENERAL_NAME *base;
306 	ASN1_INTEGER *minimum;
307 	ASN1_INTEGER *maximum;
308 } GENERAL_SUBTREE;
309 
310 DECLARE_STACK_OF(GENERAL_SUBTREE)
311 
312 struct NAME_CONSTRAINTS_st {
313 	STACK_OF(GENERAL_SUBTREE) *permittedSubtrees;
314 	STACK_OF(GENERAL_SUBTREE) *excludedSubtrees;
315 };
316 
317 typedef struct POLICY_CONSTRAINTS_st {
318 	ASN1_INTEGER *requireExplicitPolicy;
319 	ASN1_INTEGER *inhibitPolicyMapping;
320 } POLICY_CONSTRAINTS;
321 
322 struct ISSUING_DIST_POINT_st {
323 	DIST_POINT_NAME *distpoint;
324 	int onlyuser;
325 	int onlyCA;
326 	ASN1_BIT_STRING *onlysomereasons;
327 	int indirectCRL;
328 	int onlyattr;
329 };
330 
331 /* Values in idp_flags field */
332 /* IDP present */
333 #define	IDP_PRESENT	0x1
334 /* IDP values inconsistent */
335 #define IDP_INVALID	0x2
336 /* onlyuser true */
337 #define	IDP_ONLYUSER	0x4
338 /* onlyCA true */
339 #define	IDP_ONLYCA	0x8
340 /* onlyattr true */
341 #define IDP_ONLYATTR	0x10
342 /* indirectCRL true */
343 #define IDP_INDIRECT	0x20
344 /* onlysomereasons present */
345 #define IDP_REASONS	0x40
346 
347 #define X509V3_conf_err(val) ERR_asprintf_error_data( \
348 			"section:%s,name:%s,value:%s", val->section, \
349 			val->name, val->value);
350 
351 #define X509V3_set_ctx_test(ctx) \
352 			X509V3_set_ctx(ctx, NULL, NULL, NULL, NULL, CTX_TEST)
353 #define X509V3_set_ctx_nodb(ctx) (ctx)->db = NULL;
354 
355 #define EXT_BITSTRING(nid, table) { nid, 0, &ASN1_BIT_STRING_it, \
356 			0,0,0,0, \
357 			0,0, \
358 			(X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \
359 			(X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \
360 			NULL, NULL, \
361 			table}
362 
363 #define EXT_IA5STRING(nid) { nid, 0, &ASN1_IA5STRING_it, \
364 			0,0,0,0, \
365 			(X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \
366 			(X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \
367 			0,0,0,0, \
368 			NULL}
369 
370 #define EXT_END { -1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
371 
372 
373 /* X509_PURPOSE stuff */
374 
375 #define EXFLAG_BCONS		0x0001
376 #define EXFLAG_KUSAGE		0x0002
377 #define EXFLAG_XKUSAGE		0x0004
378 #define EXFLAG_NSCERT		0x0008
379 
380 #define EXFLAG_CA		0x0010
381 #define EXFLAG_SI		0x0020  /* Self issued. */
382 #define EXFLAG_V1		0x0040
383 #define EXFLAG_INVALID		0x0080
384 #define EXFLAG_SET		0x0100
385 #define EXFLAG_CRITICAL		0x0200
386 #if !defined(LIBRESSL_INTERNAL)
387 #define EXFLAG_PROXY		0x0400
388 #endif
389 #define EXFLAG_INVALID_POLICY	0x0800
390 #define EXFLAG_FRESHEST		0x1000
391 #define EXFLAG_SS               0x2000	/* Self signed. */
392 
393 #define KU_DIGITAL_SIGNATURE	0x0080
394 #define KU_NON_REPUDIATION	0x0040
395 #define KU_KEY_ENCIPHERMENT	0x0020
396 #define KU_DATA_ENCIPHERMENT	0x0010
397 #define KU_KEY_AGREEMENT	0x0008
398 #define KU_KEY_CERT_SIGN	0x0004
399 #define KU_CRL_SIGN		0x0002
400 #define KU_ENCIPHER_ONLY	0x0001
401 #define KU_DECIPHER_ONLY	0x8000
402 
403 #define NS_SSL_CLIENT		0x80
404 #define NS_SSL_SERVER		0x40
405 #define NS_SMIME		0x20
406 #define NS_OBJSIGN		0x10
407 #define NS_SSL_CA		0x04
408 #define NS_SMIME_CA		0x02
409 #define NS_OBJSIGN_CA		0x01
410 #define NS_ANY_CA		(NS_SSL_CA|NS_SMIME_CA|NS_OBJSIGN_CA)
411 
412 #define XKU_SSL_SERVER		0x1
413 #define XKU_SSL_CLIENT		0x2
414 #define XKU_SMIME		0x4
415 #define XKU_CODE_SIGN		0x8
416 #define XKU_SGC			0x10
417 #define XKU_OCSP_SIGN		0x20
418 #define XKU_TIMESTAMP		0x40
419 #define XKU_DVCS		0x80
420 #define XKU_ANYEKU		0x100
421 
422 #define X509_PURPOSE_DYNAMIC	0x1
423 #define X509_PURPOSE_DYNAMIC_NAME	0x2
424 
425 typedef struct x509_purpose_st {
426 	int purpose;
427 	int trust;		/* Default trust ID */
428 	int flags;
429 	int (*check_purpose)(const struct x509_purpose_st *,
430 				const X509 *, int);
431 	char *name;
432 	char *sname;
433 	void *usr_data;
434 } X509_PURPOSE;
435 
436 #define X509_PURPOSE_SSL_CLIENT		1
437 #define X509_PURPOSE_SSL_SERVER		2
438 #define X509_PURPOSE_NS_SSL_SERVER	3
439 #define X509_PURPOSE_SMIME_SIGN		4
440 #define X509_PURPOSE_SMIME_ENCRYPT	5
441 #define X509_PURPOSE_CRL_SIGN		6
442 #define X509_PURPOSE_ANY		7
443 #define X509_PURPOSE_OCSP_HELPER	8
444 #define X509_PURPOSE_TIMESTAMP_SIGN	9
445 
446 #define X509_PURPOSE_MIN		1
447 #define X509_PURPOSE_MAX		9
448 
449 /* Flags for X509V3_EXT_print() */
450 
451 #define X509V3_EXT_UNKNOWN_MASK		(0xfL << 16)
452 /* Return error for unknown extensions */
453 #define X509V3_EXT_DEFAULT		0
454 /* Print error for unknown extensions */
455 #define X509V3_EXT_ERROR_UNKNOWN	(1L << 16)
456 /* ASN1 parse unknown extensions */
457 #define X509V3_EXT_PARSE_UNKNOWN	(2L << 16)
458 /* BIO_dump unknown extensions */
459 #define X509V3_EXT_DUMP_UNKNOWN		(3L << 16)
460 
461 /* Flags for X509V3_add1_i2d */
462 
463 #define X509V3_ADD_OP_MASK		0xfL
464 #define X509V3_ADD_DEFAULT		0L
465 #define X509V3_ADD_APPEND		1L
466 #define X509V3_ADD_REPLACE		2L
467 #define X509V3_ADD_REPLACE_EXISTING	3L
468 #define X509V3_ADD_KEEP_EXISTING	4L
469 #define X509V3_ADD_DELETE		5L
470 #define X509V3_ADD_SILENT		0x10
471 
472 DECLARE_STACK_OF(X509_PURPOSE)
473 
474 BASIC_CONSTRAINTS *BASIC_CONSTRAINTS_new(void);
475 void BASIC_CONSTRAINTS_free(BASIC_CONSTRAINTS *a);
476 BASIC_CONSTRAINTS *d2i_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS **a, const unsigned char **in, long len);
477 int i2d_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS *a, unsigned char **out);
478 extern const ASN1_ITEM BASIC_CONSTRAINTS_it;
479 
480 AUTHORITY_KEYID *AUTHORITY_KEYID_new(void);
481 void AUTHORITY_KEYID_free(AUTHORITY_KEYID *a);
482 AUTHORITY_KEYID *d2i_AUTHORITY_KEYID(AUTHORITY_KEYID **a, const unsigned char **in, long len);
483 int i2d_AUTHORITY_KEYID(AUTHORITY_KEYID *a, unsigned char **out);
484 extern const ASN1_ITEM AUTHORITY_KEYID_it;
485 
486 PKEY_USAGE_PERIOD *PKEY_USAGE_PERIOD_new(void);
487 void PKEY_USAGE_PERIOD_free(PKEY_USAGE_PERIOD *a);
488 PKEY_USAGE_PERIOD *d2i_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD **a, const unsigned char **in, long len);
489 int i2d_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD *a, unsigned char **out);
490 extern const ASN1_ITEM PKEY_USAGE_PERIOD_it;
491 
492 GENERAL_NAME *GENERAL_NAME_new(void);
493 void GENERAL_NAME_free(GENERAL_NAME *a);
494 GENERAL_NAME *d2i_GENERAL_NAME(GENERAL_NAME **a, const unsigned char **in, long len);
495 int i2d_GENERAL_NAME(GENERAL_NAME *a, unsigned char **out);
496 extern const ASN1_ITEM GENERAL_NAME_it;
497 GENERAL_NAME *GENERAL_NAME_dup(GENERAL_NAME *a);
498 int GENERAL_NAME_cmp(GENERAL_NAME *a, GENERAL_NAME *b);
499 
500 
501 
502 ASN1_BIT_STRING *v2i_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
503 				X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval);
504 STACK_OF(CONF_VALUE) *i2v_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
505 				ASN1_BIT_STRING *bits,
506 				STACK_OF(CONF_VALUE) *extlist);
507 
508 STACK_OF(CONF_VALUE) *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method, GENERAL_NAME *gen, STACK_OF(CONF_VALUE) *ret);
509 int GENERAL_NAME_print(BIO *out, GENERAL_NAME *gen);
510 
511 GENERAL_NAMES *GENERAL_NAMES_new(void);
512 void GENERAL_NAMES_free(GENERAL_NAMES *a);
513 GENERAL_NAMES *d2i_GENERAL_NAMES(GENERAL_NAMES **a, const unsigned char **in, long len);
514 int i2d_GENERAL_NAMES(GENERAL_NAMES *a, unsigned char **out);
515 extern const ASN1_ITEM GENERAL_NAMES_it;
516 
517 STACK_OF(CONF_VALUE) *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method,
518 		GENERAL_NAMES *gen, STACK_OF(CONF_VALUE) *extlist);
519 GENERAL_NAMES *v2i_GENERAL_NAMES(const X509V3_EXT_METHOD *method,
520 				 X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval);
521 
522 OTHERNAME *OTHERNAME_new(void);
523 void OTHERNAME_free(OTHERNAME *a);
524 OTHERNAME *d2i_OTHERNAME(OTHERNAME **a, const unsigned char **in, long len);
525 int i2d_OTHERNAME(OTHERNAME *a, unsigned char **out);
526 extern const ASN1_ITEM OTHERNAME_it;
527 EDIPARTYNAME *EDIPARTYNAME_new(void);
528 void EDIPARTYNAME_free(EDIPARTYNAME *a);
529 EDIPARTYNAME *d2i_EDIPARTYNAME(EDIPARTYNAME **a, const unsigned char **in, long len);
530 int i2d_EDIPARTYNAME(EDIPARTYNAME *a, unsigned char **out);
531 extern const ASN1_ITEM EDIPARTYNAME_it;
532 int OTHERNAME_cmp(OTHERNAME *a, OTHERNAME *b);
533 void GENERAL_NAME_set0_value(GENERAL_NAME *a, int type, void *value);
534 void *GENERAL_NAME_get0_value(GENERAL_NAME *a, int *ptype);
535 int GENERAL_NAME_set0_othername(GENERAL_NAME *gen,
536 				ASN1_OBJECT *oid, ASN1_TYPE *value);
537 int GENERAL_NAME_get0_otherName(GENERAL_NAME *gen,
538 				ASN1_OBJECT **poid, ASN1_TYPE **pvalue);
539 
540 char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method,
541     const ASN1_OCTET_STRING *ia5);
542 ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method,
543     X509V3_CTX *ctx, const char *str);
544 
545 EXTENDED_KEY_USAGE *EXTENDED_KEY_USAGE_new(void);
546 void EXTENDED_KEY_USAGE_free(EXTENDED_KEY_USAGE *a);
547 EXTENDED_KEY_USAGE *d2i_EXTENDED_KEY_USAGE(EXTENDED_KEY_USAGE **a, const unsigned char **in, long len);
548 int i2d_EXTENDED_KEY_USAGE(EXTENDED_KEY_USAGE *a, unsigned char **out);
549 extern const ASN1_ITEM EXTENDED_KEY_USAGE_it;
550 int i2a_ACCESS_DESCRIPTION(BIO *bp, const ACCESS_DESCRIPTION* a);
551 
552 CERTIFICATEPOLICIES *CERTIFICATEPOLICIES_new(void);
553 void CERTIFICATEPOLICIES_free(CERTIFICATEPOLICIES *a);
554 CERTIFICATEPOLICIES *d2i_CERTIFICATEPOLICIES(CERTIFICATEPOLICIES **a, const unsigned char **in, long len);
555 int i2d_CERTIFICATEPOLICIES(CERTIFICATEPOLICIES *a, unsigned char **out);
556 extern const ASN1_ITEM CERTIFICATEPOLICIES_it;
557 POLICYINFO *POLICYINFO_new(void);
558 void POLICYINFO_free(POLICYINFO *a);
559 POLICYINFO *d2i_POLICYINFO(POLICYINFO **a, const unsigned char **in, long len);
560 int i2d_POLICYINFO(POLICYINFO *a, unsigned char **out);
561 extern const ASN1_ITEM POLICYINFO_it;
562 POLICYQUALINFO *POLICYQUALINFO_new(void);
563 void POLICYQUALINFO_free(POLICYQUALINFO *a);
564 POLICYQUALINFO *d2i_POLICYQUALINFO(POLICYQUALINFO **a, const unsigned char **in, long len);
565 int i2d_POLICYQUALINFO(POLICYQUALINFO *a, unsigned char **out);
566 extern const ASN1_ITEM POLICYQUALINFO_it;
567 USERNOTICE *USERNOTICE_new(void);
568 void USERNOTICE_free(USERNOTICE *a);
569 USERNOTICE *d2i_USERNOTICE(USERNOTICE **a, const unsigned char **in, long len);
570 int i2d_USERNOTICE(USERNOTICE *a, unsigned char **out);
571 extern const ASN1_ITEM USERNOTICE_it;
572 NOTICEREF *NOTICEREF_new(void);
573 void NOTICEREF_free(NOTICEREF *a);
574 NOTICEREF *d2i_NOTICEREF(NOTICEREF **a, const unsigned char **in, long len);
575 int i2d_NOTICEREF(NOTICEREF *a, unsigned char **out);
576 extern const ASN1_ITEM NOTICEREF_it;
577 
578 CRL_DIST_POINTS *CRL_DIST_POINTS_new(void);
579 void CRL_DIST_POINTS_free(CRL_DIST_POINTS *a);
580 CRL_DIST_POINTS *d2i_CRL_DIST_POINTS(CRL_DIST_POINTS **a, const unsigned char **in, long len);
581 int i2d_CRL_DIST_POINTS(CRL_DIST_POINTS *a, unsigned char **out);
582 extern const ASN1_ITEM CRL_DIST_POINTS_it;
583 DIST_POINT *DIST_POINT_new(void);
584 void DIST_POINT_free(DIST_POINT *a);
585 DIST_POINT *d2i_DIST_POINT(DIST_POINT **a, const unsigned char **in, long len);
586 int i2d_DIST_POINT(DIST_POINT *a, unsigned char **out);
587 extern const ASN1_ITEM DIST_POINT_it;
588 DIST_POINT_NAME *DIST_POINT_NAME_new(void);
589 void DIST_POINT_NAME_free(DIST_POINT_NAME *a);
590 DIST_POINT_NAME *d2i_DIST_POINT_NAME(DIST_POINT_NAME **a, const unsigned char **in, long len);
591 int i2d_DIST_POINT_NAME(DIST_POINT_NAME *a, unsigned char **out);
592 extern const ASN1_ITEM DIST_POINT_NAME_it;
593 ISSUING_DIST_POINT *ISSUING_DIST_POINT_new(void);
594 void ISSUING_DIST_POINT_free(ISSUING_DIST_POINT *a);
595 ISSUING_DIST_POINT *d2i_ISSUING_DIST_POINT(ISSUING_DIST_POINT **a, const unsigned char **in, long len);
596 int i2d_ISSUING_DIST_POINT(ISSUING_DIST_POINT *a, unsigned char **out);
597 extern const ASN1_ITEM ISSUING_DIST_POINT_it;
598 
599 int DIST_POINT_set_dpname(DIST_POINT_NAME *dpn, X509_NAME *iname);
600 
601 int NAME_CONSTRAINTS_check(X509 *x, NAME_CONSTRAINTS *nc);
602 
603 ACCESS_DESCRIPTION *ACCESS_DESCRIPTION_new(void);
604 void ACCESS_DESCRIPTION_free(ACCESS_DESCRIPTION *a);
605 ACCESS_DESCRIPTION *d2i_ACCESS_DESCRIPTION(ACCESS_DESCRIPTION **a, const unsigned char **in, long len);
606 int i2d_ACCESS_DESCRIPTION(ACCESS_DESCRIPTION *a, unsigned char **out);
607 extern const ASN1_ITEM ACCESS_DESCRIPTION_it;
608 AUTHORITY_INFO_ACCESS *AUTHORITY_INFO_ACCESS_new(void);
609 void AUTHORITY_INFO_ACCESS_free(AUTHORITY_INFO_ACCESS *a);
610 AUTHORITY_INFO_ACCESS *d2i_AUTHORITY_INFO_ACCESS(AUTHORITY_INFO_ACCESS **a, const unsigned char **in, long len);
611 int i2d_AUTHORITY_INFO_ACCESS(AUTHORITY_INFO_ACCESS *a, unsigned char **out);
612 extern const ASN1_ITEM AUTHORITY_INFO_ACCESS_it;
613 
614 extern const ASN1_ITEM POLICY_MAPPING_it;
615 POLICY_MAPPING *POLICY_MAPPING_new(void);
616 void POLICY_MAPPING_free(POLICY_MAPPING *a);
617 extern const ASN1_ITEM POLICY_MAPPINGS_it;
618 
619 extern const ASN1_ITEM GENERAL_SUBTREE_it;
620 GENERAL_SUBTREE *GENERAL_SUBTREE_new(void);
621 void GENERAL_SUBTREE_free(GENERAL_SUBTREE *a);
622 
623 extern const ASN1_ITEM NAME_CONSTRAINTS_it;
624 NAME_CONSTRAINTS *NAME_CONSTRAINTS_new(void);
625 void NAME_CONSTRAINTS_free(NAME_CONSTRAINTS *a);
626 
627 POLICY_CONSTRAINTS *POLICY_CONSTRAINTS_new(void);
628 void POLICY_CONSTRAINTS_free(POLICY_CONSTRAINTS *a);
629 extern const ASN1_ITEM POLICY_CONSTRAINTS_it;
630 
631 GENERAL_NAME *a2i_GENERAL_NAME(GENERAL_NAME *out,
632 			       const X509V3_EXT_METHOD *method, X509V3_CTX *ctx,
633 			       int gen_type, const char *value, int is_nc);
634 
635 #ifdef HEADER_CONF_H
636 GENERAL_NAME *v2i_GENERAL_NAME(const X509V3_EXT_METHOD *method, X509V3_CTX *ctx,
637 			       CONF_VALUE *cnf);
638 GENERAL_NAME *v2i_GENERAL_NAME_ex(GENERAL_NAME *out,
639 				  const X509V3_EXT_METHOD *method,
640 				  X509V3_CTX *ctx, CONF_VALUE *cnf, int is_nc);
641 void X509V3_conf_free(CONF_VALUE *val);
642 
643 X509_EXTENSION *X509V3_EXT_nconf_nid(CONF *conf, X509V3_CTX *ctx, int ext_nid,
644     const char *value);
645 X509_EXTENSION *X509V3_EXT_nconf(CONF *conf, X509V3_CTX *ctx, const char *name,
646     const char *value);
647 int X509V3_EXT_add_nconf_sk(CONF *conf, X509V3_CTX *ctx, const char *section,
648     STACK_OF(X509_EXTENSION) **sk);
649 int X509V3_EXT_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
650     X509 *cert);
651 int X509V3_EXT_REQ_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
652     X509_REQ *req);
653 int X509V3_EXT_CRL_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
654     X509_CRL *crl);
655 
656 X509_EXTENSION *X509V3_EXT_conf_nid(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
657     int ext_nid, const char *value);
658 X509_EXTENSION *X509V3_EXT_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
659     const char *name, const char *value);
660 int X509V3_EXT_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
661     const char *section, X509 *cert);
662 int X509V3_EXT_REQ_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
663     const char *section, X509_REQ *req);
664 int X509V3_EXT_CRL_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
665     const char *section, X509_CRL *crl);
666 
667 int X509V3_add_value_bool_nf(const char *name, int asn1_bool,
668 			     STACK_OF(CONF_VALUE) **extlist);
669 int X509V3_get_value_bool(const CONF_VALUE *value, int *asn1_bool);
670 int X509V3_get_value_int(const CONF_VALUE *value, ASN1_INTEGER **aint);
671 void X509V3_set_nconf(X509V3_CTX *ctx, CONF *conf);
672 void X509V3_set_conf_lhash(X509V3_CTX *ctx, LHASH_OF(CONF_VALUE) *lhash);
673 #endif
674 
675 char *X509V3_get_string(X509V3_CTX *ctx, const char *name,
676     const char *section);
677 STACK_OF(CONF_VALUE) *X509V3_get_section(X509V3_CTX *ctx, const char *section);
678 void X509V3_string_free(X509V3_CTX *ctx, char *str);
679 void X509V3_section_free( X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *section);
680 void X509V3_set_ctx(X509V3_CTX *ctx, X509 *issuer, X509 *subject,
681 				 X509_REQ *req, X509_CRL *crl, int flags);
682 
683 int X509V3_add_value(const char *name, const char *value,
684 						STACK_OF(CONF_VALUE) **extlist);
685 int X509V3_add_value_uchar(const char *name, const unsigned char *value,
686 						STACK_OF(CONF_VALUE) **extlist);
687 int X509V3_add_value_bool(const char *name, int asn1_bool,
688 						STACK_OF(CONF_VALUE) **extlist);
689 int X509V3_add_value_int(const char *name, const ASN1_INTEGER *aint,
690 						STACK_OF(CONF_VALUE) **extlist);
691 char *i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const ASN1_INTEGER *aint);
692 ASN1_INTEGER *s2i_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const char *value);
693 char *i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, const ASN1_ENUMERATED *aint);
694 char *i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth,
695     const ASN1_ENUMERATED *aint);
696 int X509V3_EXT_add(X509V3_EXT_METHOD *ext);
697 int X509V3_EXT_add_list(X509V3_EXT_METHOD *extlist);
698 int X509V3_EXT_add_alias(int nid_to, int nid_from);
699 void X509V3_EXT_cleanup(void);
700 
701 const X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext);
702 const X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid);
703 int X509V3_add_standard_extensions(void);
704 STACK_OF(CONF_VALUE) *X509V3_parse_list(const char *line);
705 void *X509V3_EXT_d2i(X509_EXTENSION *ext);
706 void *X509V3_get_d2i(const STACK_OF(X509_EXTENSION) *x, int nid, int *crit,
707     int *idx);
708 
709 
710 X509_EXTENSION *X509V3_EXT_i2d(int ext_nid, int crit, void *ext_struc);
711 int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value, int crit, unsigned long flags);
712 
713 char *hex_to_string(const unsigned char *buffer, long len);
714 unsigned char *string_to_hex(const char *str, long *len);
715 
716 void X509V3_EXT_val_prn(BIO *out, STACK_OF(CONF_VALUE) *val, int indent,
717 								 int ml);
718 int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, int indent);
719 int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
720 
721 int X509V3_extensions_print(BIO *out, const char *title,
722     const STACK_OF(X509_EXTENSION) *exts, unsigned long flag, int indent);
723 
724 int X509_check_ca(X509 *x);
725 int X509_check_purpose(X509 *x, int id, int ca);
726 int X509_supported_extension(X509_EXTENSION *ex);
727 int X509_PURPOSE_set(int *p, int purpose);
728 int X509_check_issued(X509 *issuer, X509 *subject);
729 int X509_check_akid(X509 *issuer, AUTHORITY_KEYID *akid);
730 int X509_PURPOSE_get_count(void);
731 X509_PURPOSE * X509_PURPOSE_get0(int idx);
732 int X509_PURPOSE_get_by_sname(const char *sname);
733 int X509_PURPOSE_get_by_id(int id);
734 int X509_PURPOSE_add(int id, int trust, int flags,
735 			int (*ck)(const X509_PURPOSE *, const X509 *, int),
736 			const char *name, const char *sname, void *arg);
737 char *X509_PURPOSE_get0_name(const X509_PURPOSE *xp);
738 char *X509_PURPOSE_get0_sname(const X509_PURPOSE *xp);
739 int X509_PURPOSE_get_trust(const X509_PURPOSE *xp);
740 void X509_PURPOSE_cleanup(void);
741 int X509_PURPOSE_get_id(const X509_PURPOSE *);
742 uint32_t X509_get_extension_flags(X509 *x);
743 uint32_t X509_get_key_usage(X509 *x);
744 uint32_t X509_get_extended_key_usage(X509 *x);
745 
746 STACK_OF(OPENSSL_STRING) *X509_get1_email(X509 *x);
747 STACK_OF(OPENSSL_STRING) *X509_REQ_get1_email(X509_REQ *x);
748 void X509_email_free(STACK_OF(OPENSSL_STRING) *sk);
749 STACK_OF(OPENSSL_STRING) *X509_get1_ocsp(X509 *x);
750 
751 /* Flags for X509_check_* functions */
752 /* Always check subject name for host match even if subject alt names present */
753 #define X509_CHECK_FLAG_ALWAYS_CHECK_SUBJECT	0x1
754 /* Disable wildcard matching for dnsName fields and common name. */
755 #define X509_CHECK_FLAG_NO_WILDCARDS	0x2
756 /* Wildcards must not match a partial label. */
757 #define X509_CHECK_FLAG_NO_PARTIAL_WILDCARDS 0x4
758 /* Allow (non-partial) wildcards to match multiple labels. */
759 #define X509_CHECK_FLAG_MULTI_LABEL_WILDCARDS 0x8
760 /* Constraint verifier subdomain patterns to match a single labels. */
761 #define X509_CHECK_FLAG_SINGLE_LABEL_SUBDOMAINS 0x10
762 /* Disable checking the CN for a hostname, to support modern validation */
763 #define X509_CHECK_FLAG_NEVER_CHECK_SUBJECT 0x20
764 
765 /*
766  * Match reference identifiers starting with "." to any sub-domain.
767  * This is a non-public flag, turned on implicitly when the subject
768  * reference identity is a DNS name.
769  */
770 #define _X509_CHECK_FLAG_DOT_SUBDOMAINS 0x8000
771 
772 int X509_check_host(X509 *x, const char *chk, size_t chklen,
773     unsigned int flags, char **peername);
774 int X509_check_email(X509 *x, const char *chk, size_t chklen,
775     unsigned int flags);
776 int X509_check_ip(X509 *x, const unsigned char *chk, size_t chklen,
777     unsigned int flags);
778 int X509_check_ip_asc(X509 *x, const char *ipasc, unsigned int flags);
779 
780 ASN1_OCTET_STRING *a2i_IPADDRESS(const char *ipasc);
781 ASN1_OCTET_STRING *a2i_IPADDRESS_NC(const char *ipasc);
782 int a2i_ipadd(unsigned char *ipout, const char *ipasc);
783 int X509V3_NAME_from_section(X509_NAME *nm, STACK_OF(CONF_VALUE)*dn_sk,
784 						unsigned long chtype);
785 
786 #ifndef OPENSSL_NO_RFC3779
787 typedef struct ASRange_st {
788 	ASN1_INTEGER *min;
789 	ASN1_INTEGER *max;
790 } ASRange;
791 
792 #define ASIdOrRange_id		0
793 #define ASIdOrRange_range	1
794 
795 typedef struct ASIdOrRange_st {
796 	int type;
797 	union {
798 		ASN1_INTEGER *id;
799 		ASRange *range;
800 	} u;
801 } ASIdOrRange;
802 
803 typedef STACK_OF(ASIdOrRange) ASIdOrRanges;
804 DECLARE_STACK_OF(ASIdOrRange)
805 
806 #define ASIdentifierChoice_inherit		0
807 #define ASIdentifierChoice_asIdsOrRanges	1
808 
809 typedef struct ASIdentifierChoice_st {
810 	int type;
811 	union {
812 		ASN1_NULL *inherit;
813 		ASIdOrRanges *asIdsOrRanges;
814 	} u;
815 } ASIdentifierChoice;
816 
817 typedef struct ASIdentifiers_st {
818 	ASIdentifierChoice *asnum;
819 	ASIdentifierChoice *rdi;
820 } ASIdentifiers;
821 
822 ASRange *ASRange_new(void);
823 void ASRange_free(ASRange *a);
824 ASRange *d2i_ASRange(ASRange **a, const unsigned char **in, long len);
825 int i2d_ASRange(ASRange *a, unsigned char **out);
826 extern const ASN1_ITEM ASRange_it;
827 
828 ASIdOrRange *ASIdOrRange_new(void);
829 void ASIdOrRange_free(ASIdOrRange *a);
830 ASIdOrRange *d2i_ASIdOrRange(ASIdOrRange **a, const unsigned char **in,
831     long len);
832 int i2d_ASIdOrRange(ASIdOrRange *a, unsigned char **out);
833 extern const ASN1_ITEM ASIdOrRange_it;
834 
835 ASIdentifierChoice *ASIdentifierChoice_new(void);
836 void ASIdentifierChoice_free(ASIdentifierChoice *a);
837 ASIdentifierChoice *d2i_ASIdentifierChoice(ASIdentifierChoice **a,
838     const unsigned char **in, long len);
839 int i2d_ASIdentifierChoice(ASIdentifierChoice *a, unsigned char **out);
840 extern const ASN1_ITEM ASIdentifierChoice_it;
841 
842 ASIdentifiers *ASIdentifiers_new(void);
843 void ASIdentifiers_free(ASIdentifiers *a);
844 ASIdentifiers *d2i_ASIdentifiers(ASIdentifiers **a, const unsigned char **in,
845     long len);
846 int i2d_ASIdentifiers(ASIdentifiers *a, unsigned char **out);
847 extern const ASN1_ITEM ASIdentifiers_it;
848 
849 typedef struct IPAddressRange_st {
850 	ASN1_BIT_STRING *min;
851 	ASN1_BIT_STRING *max;
852 } IPAddressRange;
853 
854 #define IPAddressOrRange_addressPrefix	0
855 #define IPAddressOrRange_addressRange	1
856 
857 typedef struct IPAddressOrRange_st {
858 	int type;
859 	union {
860 		ASN1_BIT_STRING *addressPrefix;
861 		IPAddressRange *addressRange;
862 	} u;
863 } IPAddressOrRange;
864 
865 typedef STACK_OF(IPAddressOrRange) IPAddressOrRanges;
866 DECLARE_STACK_OF(IPAddressOrRange)
867 
868 #define IPAddressChoice_inherit			0
869 #define IPAddressChoice_addressesOrRanges	1
870 
871 typedef struct IPAddressChoice_st {
872 	int type;
873 	union {
874 		ASN1_NULL *inherit;
875 		IPAddressOrRanges *addressesOrRanges;
876 	} u;
877 } IPAddressChoice;
878 
879 typedef struct IPAddressFamily_st {
880 	ASN1_OCTET_STRING *addressFamily;
881 	IPAddressChoice *ipAddressChoice;
882 } IPAddressFamily;
883 
884 typedef STACK_OF(IPAddressFamily) IPAddrBlocks;
885 DECLARE_STACK_OF(IPAddressFamily)
886 
887 IPAddressRange *IPAddressRange_new(void);
888 void IPAddressRange_free(IPAddressRange *a);
889 IPAddressRange *d2i_IPAddressRange(IPAddressRange **a,
890     const unsigned char **in, long len);
891 int i2d_IPAddressRange(IPAddressRange *a, unsigned char **out);
892 extern const ASN1_ITEM IPAddressRange_it;
893 
894 IPAddressOrRange *IPAddressOrRange_new(void);
895 void IPAddressOrRange_free(IPAddressOrRange *a);
896 IPAddressOrRange *d2i_IPAddressOrRange(IPAddressOrRange **a,
897     const unsigned char **in, long len);
898 int i2d_IPAddressOrRange(IPAddressOrRange *a, unsigned char **out);
899 extern const ASN1_ITEM IPAddressOrRange_it;
900 
901 IPAddressChoice *IPAddressChoice_new(void);
902 void IPAddressChoice_free(IPAddressChoice *a);
903 IPAddressChoice *d2i_IPAddressChoice(IPAddressChoice **a,
904     const unsigned char **in, long len);
905 int i2d_IPAddressChoice(IPAddressChoice *a, unsigned char **out);
906 extern const ASN1_ITEM IPAddressChoice_it;
907 
908 IPAddressFamily *IPAddressFamily_new(void);
909 void IPAddressFamily_free(IPAddressFamily *a);
910 IPAddressFamily *d2i_IPAddressFamily(IPAddressFamily **a,
911     const unsigned char **in, long len);
912 int i2d_IPAddressFamily(IPAddressFamily *a, unsigned char **out);
913 extern const ASN1_ITEM IPAddressFamily_it;
914 
915 /*
916  * API tag for elements of the ASIdentifer SEQUENCE.
917  */
918 #define V3_ASID_ASNUM	0
919 #define V3_ASID_RDI	1
920 
921 /*
922  * AFI values, assigned by IANA.  It'd be nice to make the AFI
923  * handling code totally generic, but there are too many little things
924  * that would need to be defined for other address families for it to
925  * be worth the trouble.
926  */
927 #define IANA_AFI_IPV4	1
928 #define IANA_AFI_IPV6	2
929 
930 /*
931  * Utilities to construct and extract values from RFC3779 extensions,
932  * since some of the encodings (particularly for IP address prefixes
933  * and ranges) are a bit tedious to work with directly.
934  */
935 int X509v3_asid_add_inherit(ASIdentifiers *asid, int which);
936 int X509v3_asid_add_id_or_range(ASIdentifiers *asid, int which,
937     ASN1_INTEGER *min, ASN1_INTEGER *max);
938 int X509v3_addr_add_inherit(IPAddrBlocks *addr, const unsigned afi,
939     const unsigned *safi);
940 int X509v3_addr_add_prefix(IPAddrBlocks *addr, const unsigned afi,
941     const unsigned *safi, unsigned char *a, const int prefixlen);
942 int X509v3_addr_add_range(IPAddrBlocks *addr, const unsigned afi,
943     const unsigned *safi, unsigned char *min, unsigned char *max);
944 unsigned X509v3_addr_get_afi(const IPAddressFamily *f);
945 int X509v3_addr_get_range(IPAddressOrRange *aor, const unsigned afi,
946     unsigned char *min, unsigned char *max, const int length);
947 
948 /*
949  * Canonical forms.
950  */
951 int X509v3_asid_is_canonical(ASIdentifiers *asid);
952 int X509v3_addr_is_canonical(IPAddrBlocks *addr);
953 int X509v3_asid_canonize(ASIdentifiers *asid);
954 int X509v3_addr_canonize(IPAddrBlocks *addr);
955 
956 /*
957  * Tests for inheritance and containment.
958  */
959 int X509v3_asid_inherits(ASIdentifiers *asid);
960 int X509v3_addr_inherits(IPAddrBlocks *addr);
961 int X509v3_asid_subset(ASIdentifiers *a, ASIdentifiers *b);
962 int X509v3_addr_subset(IPAddrBlocks *a, IPAddrBlocks *b);
963 
964 /*
965  * Check whether RFC 3779 extensions nest properly in chains.
966  */
967 int X509v3_asid_validate_path(X509_STORE_CTX *);
968 int X509v3_addr_validate_path(X509_STORE_CTX *);
969 int X509v3_asid_validate_resource_set(STACK_OF(X509) *chain, ASIdentifiers *ext,
970     int allow_inheritance);
971 int X509v3_addr_validate_resource_set(STACK_OF(X509) *chain, IPAddrBlocks *ext,
972     int allow_inheritance);
973 
974 #endif /* !OPENSSL_NO_RFC3779 */
975 
976 void ERR_load_X509V3_strings(void);
977 
978 /* Error codes for the X509V3 functions. */
979 
980 /* Function codes. */
981 #define X509V3_F_A2I_GENERAL_NAME			 164
982 #define X509V3_F_ASIDENTIFIERCHOICE_CANONIZE		 161
983 #define X509V3_F_ASIDENTIFIERCHOICE_IS_CANONICAL	 162
984 #define X509V3_F_COPY_EMAIL				 122
985 #define X509V3_F_COPY_ISSUER				 123
986 #define X509V3_F_DO_DIRNAME				 144
987 #define X509V3_F_DO_EXT_CONF				 124
988 #define X509V3_F_DO_EXT_I2D				 135
989 #define X509V3_F_DO_EXT_NCONF				 151
990 #define X509V3_F_DO_I2V_NAME_CONSTRAINTS		 148
991 #define X509V3_F_GNAMES_FROM_SECTNAME			 156
992 #define X509V3_F_HEX_TO_STRING				 111
993 #define X509V3_F_I2S_ASN1_ENUMERATED			 121
994 #define X509V3_F_I2S_ASN1_IA5STRING			 149
995 #define X509V3_F_I2S_ASN1_INTEGER			 120
996 #define X509V3_F_I2V_AUTHORITY_INFO_ACCESS		 138
997 #define X509V3_F_NOTICE_SECTION				 132
998 #define X509V3_F_NREF_NOS				 133
999 #define X509V3_F_POLICY_SECTION				 131
1000 #define X509V3_F_PROCESS_PCI_VALUE			 150
1001 #define X509V3_F_R2I_CERTPOL				 130
1002 #define X509V3_F_R2I_PCI				 155
1003 #define X509V3_F_S2I_ASN1_IA5STRING			 100
1004 #define X509V3_F_S2I_ASN1_INTEGER			 108
1005 #define X509V3_F_S2I_ASN1_OCTET_STRING			 112
1006 #define X509V3_F_S2I_ASN1_SKEY_ID			 114
1007 #define X509V3_F_S2I_SKEY_ID				 115
1008 #define X509V3_F_SET_DIST_POINT_NAME			 158
1009 #define X509V3_F_STRING_TO_HEX				 113
1010 #define X509V3_F_SXNET_ADD_ID_ASC			 125
1011 #define X509V3_F_SXNET_ADD_ID_INTEGER			 126
1012 #define X509V3_F_SXNET_ADD_ID_ULONG			 127
1013 #define X509V3_F_SXNET_GET_ID_ASC			 128
1014 #define X509V3_F_SXNET_GET_ID_ULONG			 129
1015 #define X509V3_F_V2I_ASIDENTIFIERS			 163
1016 #define X509V3_F_V2I_ASN1_BIT_STRING			 101
1017 #define X509V3_F_V2I_AUTHORITY_INFO_ACCESS		 139
1018 #define X509V3_F_V2I_AUTHORITY_KEYID			 119
1019 #define X509V3_F_V2I_BASIC_CONSTRAINTS			 102
1020 #define X509V3_F_V2I_CRLD				 134
1021 #define X509V3_F_V2I_EXTENDED_KEY_USAGE			 103
1022 #define X509V3_F_V2I_GENERAL_NAMES			 118
1023 #define X509V3_F_V2I_GENERAL_NAME_EX			 117
1024 #define X509V3_F_V2I_IDP				 157
1025 #define X509V3_F_V2I_IPADDRBLOCKS			 159
1026 #define X509V3_F_V2I_ISSUER_ALT				 153
1027 #define X509V3_F_V2I_NAME_CONSTRAINTS			 147
1028 #define X509V3_F_V2I_POLICY_CONSTRAINTS			 146
1029 #define X509V3_F_V2I_POLICY_MAPPINGS			 145
1030 #define X509V3_F_V2I_SUBJECT_ALT			 154
1031 #define X509V3_F_V3_ADDR_VALIDATE_PATH_INTERNAL		 160
1032 #define X509V3_F_V3_GENERIC_EXTENSION			 116
1033 #define X509V3_F_X509V3_ADD1_I2D			 140
1034 #define X509V3_F_X509V3_ADD_VALUE			 105
1035 #define X509V3_F_X509V3_EXT_ADD				 104
1036 #define X509V3_F_X509V3_EXT_ADD_ALIAS			 106
1037 #define X509V3_F_X509V3_EXT_CONF			 107
1038 #define X509V3_F_X509V3_EXT_I2D				 136
1039 #define X509V3_F_X509V3_EXT_NCONF			 152
1040 #define X509V3_F_X509V3_GET_SECTION			 142
1041 #define X509V3_F_X509V3_GET_STRING			 143
1042 #define X509V3_F_X509V3_GET_VALUE_BOOL			 110
1043 #define X509V3_F_X509V3_PARSE_LIST			 109
1044 #define X509V3_F_X509_PURPOSE_ADD			 137
1045 #define X509V3_F_X509_PURPOSE_SET			 141
1046 
1047 /* Reason codes. */
1048 #define X509V3_R_BAD_IP_ADDRESS				 118
1049 #define X509V3_R_BAD_OBJECT				 119
1050 #define X509V3_R_BN_DEC2BN_ERROR			 100
1051 #define X509V3_R_BN_TO_ASN1_INTEGER_ERROR		 101
1052 #define X509V3_R_DIRNAME_ERROR				 149
1053 #define X509V3_R_DISTPOINT_ALREADY_SET			 160
1054 #define X509V3_R_DUPLICATE_ZONE_ID			 133
1055 #define X509V3_R_ERROR_CONVERTING_ZONE			 131
1056 #define X509V3_R_ERROR_CREATING_EXTENSION		 144
1057 #define X509V3_R_ERROR_IN_EXTENSION			 128
1058 #define X509V3_R_EXPECTED_A_SECTION_NAME		 137
1059 #define X509V3_R_EXTENSION_EXISTS			 145
1060 #define X509V3_R_EXTENSION_NAME_ERROR			 115
1061 #define X509V3_R_EXTENSION_NOT_FOUND			 102
1062 #define X509V3_R_EXTENSION_SETTING_NOT_SUPPORTED	 103
1063 #define X509V3_R_EXTENSION_VALUE_ERROR			 116
1064 #define X509V3_R_ILLEGAL_EMPTY_EXTENSION		 151
1065 #define X509V3_R_ILLEGAL_HEX_DIGIT			 113
1066 #define X509V3_R_INCORRECT_POLICY_SYNTAX_TAG		 152
1067 #define X509V3_R_INVALID_MULTIPLE_RDNS			 161
1068 #define X509V3_R_INVALID_ASNUMBER			 162
1069 #define X509V3_R_INVALID_ASRANGE			 163
1070 #define X509V3_R_INVALID_BOOLEAN_STRING			 104
1071 #define X509V3_R_INVALID_EXTENSION_STRING		 105
1072 #define X509V3_R_INVALID_INHERITANCE			 165
1073 #define X509V3_R_INVALID_IPADDRESS			 166
1074 #define X509V3_R_INVALID_NAME				 106
1075 #define X509V3_R_INVALID_NULL_ARGUMENT			 107
1076 #define X509V3_R_INVALID_NULL_NAME			 108
1077 #define X509V3_R_INVALID_NULL_VALUE			 109
1078 #define X509V3_R_INVALID_NUMBER				 140
1079 #define X509V3_R_INVALID_NUMBERS			 141
1080 #define X509V3_R_INVALID_OBJECT_IDENTIFIER		 110
1081 #define X509V3_R_INVALID_OPTION				 138
1082 #define X509V3_R_INVALID_POLICY_IDENTIFIER		 134
1083 #define X509V3_R_INVALID_PROXY_POLICY_SETTING		 153
1084 #define X509V3_R_INVALID_PURPOSE			 146
1085 #define X509V3_R_INVALID_SAFI				 164
1086 #define X509V3_R_INVALID_SECTION			 135
1087 #define X509V3_R_INVALID_SYNTAX				 143
1088 #define X509V3_R_ISSUER_DECODE_ERROR			 126
1089 #define X509V3_R_MISSING_VALUE				 124
1090 #define X509V3_R_NEED_ORGANIZATION_AND_NUMBERS		 142
1091 #define X509V3_R_NO_CONFIG_DATABASE			 136
1092 #define X509V3_R_NO_ISSUER_CERTIFICATE			 121
1093 #define X509V3_R_NO_ISSUER_DETAILS			 127
1094 #define X509V3_R_NO_POLICY_IDENTIFIER			 139
1095 #define X509V3_R_NO_PROXY_CERT_POLICY_LANGUAGE_DEFINED	 154
1096 #define X509V3_R_NO_PUBLIC_KEY				 114
1097 #define X509V3_R_NO_SUBJECT_DETAILS			 125
1098 #define X509V3_R_ODD_NUMBER_OF_DIGITS			 112
1099 #define X509V3_R_OPERATION_NOT_DEFINED			 148
1100 #define X509V3_R_OTHERNAME_ERROR			 147
1101 #define X509V3_R_POLICY_LANGUAGE_ALREADY_DEFINED	 155
1102 #define X509V3_R_POLICY_PATH_LENGTH			 156
1103 #define X509V3_R_POLICY_PATH_LENGTH_ALREADY_DEFINED	 157
1104 #define X509V3_R_POLICY_SYNTAX_NOT_CURRENTLY_SUPPORTED	 158
1105 #define X509V3_R_POLICY_WHEN_PROXY_LANGUAGE_REQUIRES_NO_POLICY 159
1106 #define X509V3_R_SECTION_NOT_FOUND			 150
1107 #define X509V3_R_UNABLE_TO_GET_ISSUER_DETAILS		 122
1108 #define X509V3_R_UNABLE_TO_GET_ISSUER_KEYID		 123
1109 #define X509V3_R_UNKNOWN_BIT_STRING_ARGUMENT		 111
1110 #define X509V3_R_UNKNOWN_EXTENSION			 129
1111 #define X509V3_R_UNKNOWN_EXTENSION_NAME			 130
1112 #define X509V3_R_UNKNOWN_OPTION				 120
1113 #define X509V3_R_UNSUPPORTED_OPTION			 117
1114 #define X509V3_R_UNSUPPORTED_TYPE			 167
1115 #define X509V3_R_USER_TOO_LONG				 132
1116 
1117 #ifdef  __cplusplus
1118 }
1119 #endif
1120 #endif
1121