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