• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
2  * project 1999. */
3 /* ====================================================================
4  * Copyright (c) 1999-2004 The OpenSSL Project.  All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in
15  *    the documentation and/or other materials provided with the
16  *    distribution.
17  *
18  * 3. All advertising materials mentioning features or use of this
19  *    software must display the following acknowledgment:
20  *    "This product includes software developed by the OpenSSL Project
21  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
22  *
23  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
24  *    endorse or promote products derived from this software without
25  *    prior written permission. For written permission, please contact
26  *    licensing@OpenSSL.org.
27  *
28  * 5. Products derived from this software may not be called "OpenSSL"
29  *    nor may "OpenSSL" appear in their names without prior written
30  *    permission of the OpenSSL Project.
31  *
32  * 6. Redistributions of any form whatsoever must retain the following
33  *    acknowledgment:
34  *    "This product includes software developed by the OpenSSL Project
35  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
36  *
37  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
38  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
39  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
40  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
41  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
43  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
44  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
45  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
46  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
47  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
48  * OF THE POSSIBILITY OF SUCH DAMAGE.
49  * ====================================================================
50  *
51  * This product includes cryptographic software written by Eric Young
52  * (eay@cryptsoft.com).  This product includes software written by Tim
53  * Hudson (tjh@cryptsoft.com). */
54 
55 #ifndef HEADER_X509V3_H
56 #define HEADER_X509V3_H
57 
58 #include <openssl/bio.h>
59 #include <openssl/conf.h>
60 #include <openssl/x509.h>
61 
62 #ifdef __cplusplus
63 extern "C" {
64 #endif
65 
66 
67 /* Legacy X.509 library.
68  *
69  * This header is part of OpenSSL's X.509 implementation. It is retained for
70  * compatibility but otherwise underdocumented and not actively maintained. In
71  * the future, a replacement library will be available. Meanwhile, minimize
72  * dependencies on this header where possible. */
73 
74 
75 /* Forward reference */
76 struct v3_ext_method;
77 struct v3_ext_ctx;
78 
79 /* Useful typedefs */
80 
81 typedef void * (*X509V3_EXT_NEW)(void);
82 typedef void (*X509V3_EXT_FREE)(void *);
83 typedef void * (*X509V3_EXT_D2I)(void *, const unsigned char ** , long);
84 typedef int (*X509V3_EXT_I2D)(void *, unsigned char **);
85 typedef STACK_OF(CONF_VALUE) *
86   (*X509V3_EXT_I2V)(const struct v3_ext_method *method, void *ext,
87 		    STACK_OF(CONF_VALUE) *extlist);
88 typedef void * (*X509V3_EXT_V2I)(const struct v3_ext_method *method,
89 				 struct v3_ext_ctx *ctx,
90 				 STACK_OF(CONF_VALUE) *values);
91 typedef char * (*X509V3_EXT_I2S)(const struct v3_ext_method *method, void *ext);
92 typedef void * (*X509V3_EXT_S2I)(const struct v3_ext_method *method,
93 				 struct v3_ext_ctx *ctx, const char *str);
94 typedef int (*X509V3_EXT_I2R)(const struct v3_ext_method *method, void *ext,
95 			      BIO *out, int indent);
96 typedef void * (*X509V3_EXT_R2I)(const struct v3_ext_method *method,
97 				 struct v3_ext_ctx *ctx, const char *str);
98 
99 /* V3 extension structure */
100 
101 struct v3_ext_method {
102 int ext_nid;
103 int ext_flags;
104 /* If this is set the following four fields are ignored */
105 ASN1_ITEM_EXP *it;
106 /* Old style ASN1 calls */
107 X509V3_EXT_NEW ext_new;
108 X509V3_EXT_FREE ext_free;
109 X509V3_EXT_D2I d2i;
110 X509V3_EXT_I2D i2d;
111 
112 /* The following pair is used for string extensions */
113 X509V3_EXT_I2S i2s;
114 X509V3_EXT_S2I s2i;
115 
116 /* The following pair is used for multi-valued extensions */
117 X509V3_EXT_I2V i2v;
118 X509V3_EXT_V2I v2i;
119 
120 /* The following are used for raw extensions */
121 X509V3_EXT_I2R i2r;
122 X509V3_EXT_R2I r2i;
123 
124 void *usr_data;	/* Any extension specific data */
125 };
126 
127 typedef struct X509V3_CONF_METHOD_st {
128 char * (*get_string)(void *db, char *section, char *value);
129 STACK_OF(CONF_VALUE) * (*get_section)(void *db, char *section);
130 void (*free_string)(void *db, char * string);
131 void (*free_section)(void *db, STACK_OF(CONF_VALUE) *section);
132 } X509V3_CONF_METHOD;
133 
134 /* Context specific info */
135 struct v3_ext_ctx {
136 #define CTX_TEST 0x1
137 int flags;
138 X509 *issuer_cert;
139 X509 *subject_cert;
140 X509_REQ *subject_req;
141 X509_CRL *crl;
142 const X509V3_CONF_METHOD *db_meth;
143 void *db;
144 /* Maybe more here */
145 };
146 
147 typedef struct v3_ext_method X509V3_EXT_METHOD;
148 
149 DEFINE_STACK_OF(X509V3_EXT_METHOD)
150 
151 /* ext_flags values */
152 #define X509V3_EXT_DYNAMIC	0x1
153 #define X509V3_EXT_CTX_DEP	0x2
154 #define X509V3_EXT_MULTILINE	0x4
155 
156 typedef BIT_STRING_BITNAME ENUMERATED_NAMES;
157 
158 struct BASIC_CONSTRAINTS_st {
159 int ca;
160 ASN1_INTEGER *pathlen;
161 };
162 
163 
164 typedef struct PKEY_USAGE_PERIOD_st {
165 ASN1_GENERALIZEDTIME *notBefore;
166 ASN1_GENERALIZEDTIME *notAfter;
167 } PKEY_USAGE_PERIOD;
168 
169 typedef struct otherName_st {
170 ASN1_OBJECT *type_id;
171 ASN1_TYPE *value;
172 } OTHERNAME;
173 
174 typedef struct EDIPartyName_st {
175 	ASN1_STRING *nameAssigner;
176 	ASN1_STRING *partyName;
177 } EDIPARTYNAME;
178 
179 typedef struct GENERAL_NAME_st {
180 
181 #define GEN_OTHERNAME	0
182 #define GEN_EMAIL	1
183 #define GEN_DNS		2
184 #define GEN_X400	3
185 #define GEN_DIRNAME	4
186 #define GEN_EDIPARTY	5
187 #define GEN_URI		6
188 #define GEN_IPADD	7
189 #define GEN_RID		8
190 
191 int type;
192 union {
193 	char *ptr;
194 	OTHERNAME *otherName; /* otherName */
195 	ASN1_IA5STRING *rfc822Name;
196 	ASN1_IA5STRING *dNSName;
197 	ASN1_TYPE *x400Address;
198 	X509_NAME *directoryName;
199 	EDIPARTYNAME *ediPartyName;
200 	ASN1_IA5STRING *uniformResourceIdentifier;
201 	ASN1_OCTET_STRING *iPAddress;
202 	ASN1_OBJECT *registeredID;
203 
204 	/* Old names */
205 	ASN1_OCTET_STRING *ip; /* iPAddress */
206 	X509_NAME *dirn;		/* dirn */
207 	ASN1_IA5STRING *ia5;/* rfc822Name, dNSName, uniformResourceIdentifier */
208 	ASN1_OBJECT *rid; /* registeredID */
209 	ASN1_TYPE *other; /* x400Address */
210 } d;
211 } GENERAL_NAME;
212 
213 DEFINE_STACK_OF(GENERAL_NAME)
214 DECLARE_ASN1_SET_OF(GENERAL_NAME)
215 
216 typedef STACK_OF(GENERAL_NAME) GENERAL_NAMES;
217 
218 DEFINE_STACK_OF(GENERAL_NAMES)
219 
220 typedef struct ACCESS_DESCRIPTION_st {
221 	ASN1_OBJECT *method;
222 	GENERAL_NAME *location;
223 } ACCESS_DESCRIPTION;
224 
225 DEFINE_STACK_OF(ACCESS_DESCRIPTION)
226 DECLARE_ASN1_SET_OF(ACCESS_DESCRIPTION)
227 
228 typedef STACK_OF(ACCESS_DESCRIPTION) AUTHORITY_INFO_ACCESS;
229 
230 typedef STACK_OF(ASN1_OBJECT) EXTENDED_KEY_USAGE;
231 
232 typedef struct DIST_POINT_NAME_st {
233 int type;
234 union {
235 	GENERAL_NAMES *fullname;
236 	STACK_OF(X509_NAME_ENTRY) *relativename;
237 } name;
238 /* If relativename then this contains the full distribution point name */
239 X509_NAME *dpname;
240 } DIST_POINT_NAME;
241 /* All existing reasons */
242 #define CRLDP_ALL_REASONS	0x807f
243 
244 #define CRL_REASON_NONE				(-1)
245 #define CRL_REASON_UNSPECIFIED			0
246 #define CRL_REASON_KEY_COMPROMISE		1
247 #define CRL_REASON_CA_COMPROMISE		2
248 #define CRL_REASON_AFFILIATION_CHANGED		3
249 #define CRL_REASON_SUPERSEDED			4
250 #define CRL_REASON_CESSATION_OF_OPERATION	5
251 #define CRL_REASON_CERTIFICATE_HOLD		6
252 #define CRL_REASON_REMOVE_FROM_CRL		8
253 #define CRL_REASON_PRIVILEGE_WITHDRAWN		9
254 #define CRL_REASON_AA_COMPROMISE		10
255 
256 struct DIST_POINT_st {
257 DIST_POINT_NAME	*distpoint;
258 ASN1_BIT_STRING *reasons;
259 GENERAL_NAMES *CRLissuer;
260 int dp_reasons;
261 };
262 
263 typedef STACK_OF(DIST_POINT) CRL_DIST_POINTS;
264 
265 DEFINE_STACK_OF(DIST_POINT)
266 DECLARE_ASN1_SET_OF(DIST_POINT)
267 
268 struct AUTHORITY_KEYID_st {
269 ASN1_OCTET_STRING *keyid;
270 GENERAL_NAMES *issuer;
271 ASN1_INTEGER *serial;
272 };
273 
274 /* Strong extranet structures */
275 
276 typedef struct SXNET_ID_st {
277 	ASN1_INTEGER *zone;
278 	ASN1_OCTET_STRING *user;
279 } SXNETID;
280 
281 DEFINE_STACK_OF(SXNETID)
282 DECLARE_ASN1_SET_OF(SXNETID)
283 
284 typedef struct SXNET_st {
285 	ASN1_INTEGER *version;
286 	STACK_OF(SXNETID) *ids;
287 } SXNET;
288 
289 typedef struct NOTICEREF_st {
290 	ASN1_STRING *organization;
291 	STACK_OF(ASN1_INTEGER) *noticenos;
292 } NOTICEREF;
293 
294 typedef struct USERNOTICE_st {
295 	NOTICEREF *noticeref;
296 	ASN1_STRING *exptext;
297 } USERNOTICE;
298 
299 typedef struct POLICYQUALINFO_st {
300 	ASN1_OBJECT *pqualid;
301 	union {
302 		ASN1_IA5STRING *cpsuri;
303 		USERNOTICE *usernotice;
304 		ASN1_TYPE *other;
305 	} d;
306 } POLICYQUALINFO;
307 
308 DEFINE_STACK_OF(POLICYQUALINFO)
309 DECLARE_ASN1_SET_OF(POLICYQUALINFO)
310 
311 typedef struct POLICYINFO_st {
312 	ASN1_OBJECT *policyid;
313 	STACK_OF(POLICYQUALINFO) *qualifiers;
314 } POLICYINFO;
315 
316 typedef STACK_OF(POLICYINFO) CERTIFICATEPOLICIES;
317 
318 DEFINE_STACK_OF(POLICYINFO)
319 DECLARE_ASN1_SET_OF(POLICYINFO)
320 
321 typedef struct POLICY_MAPPING_st {
322 	ASN1_OBJECT *issuerDomainPolicy;
323 	ASN1_OBJECT *subjectDomainPolicy;
324 } POLICY_MAPPING;
325 
326 DEFINE_STACK_OF(POLICY_MAPPING)
327 
328 typedef STACK_OF(POLICY_MAPPING) POLICY_MAPPINGS;
329 
330 typedef struct GENERAL_SUBTREE_st {
331 	GENERAL_NAME *base;
332 	ASN1_INTEGER *minimum;
333 	ASN1_INTEGER *maximum;
334 } GENERAL_SUBTREE;
335 
336 DEFINE_STACK_OF(GENERAL_SUBTREE)
337 
338 struct NAME_CONSTRAINTS_st {
339 	STACK_OF(GENERAL_SUBTREE) *permittedSubtrees;
340 	STACK_OF(GENERAL_SUBTREE) *excludedSubtrees;
341 };
342 
343 typedef struct POLICY_CONSTRAINTS_st {
344 	ASN1_INTEGER *requireExplicitPolicy;
345 	ASN1_INTEGER *inhibitPolicyMapping;
346 } POLICY_CONSTRAINTS;
347 
348 /* Proxy certificate structures, see RFC 3820 */
349 typedef struct PROXY_POLICY_st
350 	{
351 	ASN1_OBJECT *policyLanguage;
352 	ASN1_OCTET_STRING *policy;
353 	} PROXY_POLICY;
354 
355 typedef struct PROXY_CERT_INFO_EXTENSION_st
356 	{
357 	ASN1_INTEGER *pcPathLengthConstraint;
358 	PROXY_POLICY *proxyPolicy;
359 	} PROXY_CERT_INFO_EXTENSION;
360 
361 DECLARE_ASN1_FUNCTIONS(PROXY_POLICY)
362 DECLARE_ASN1_FUNCTIONS(PROXY_CERT_INFO_EXTENSION)
363 
364 struct ISSUING_DIST_POINT_st
365 	{
366 	DIST_POINT_NAME *distpoint;
367 	int onlyuser;
368 	int onlyCA;
369 	ASN1_BIT_STRING *onlysomereasons;
370 	int indirectCRL;
371 	int onlyattr;
372 	};
373 
374 /* Values in idp_flags field */
375 /* IDP present */
376 #define	IDP_PRESENT	0x1
377 /* IDP values inconsistent */
378 #define IDP_INVALID	0x2
379 /* onlyuser true */
380 #define	IDP_ONLYUSER	0x4
381 /* onlyCA true */
382 #define	IDP_ONLYCA	0x8
383 /* onlyattr true */
384 #define IDP_ONLYATTR	0x10
385 /* indirectCRL true */
386 #define IDP_INDIRECT	0x20
387 /* onlysomereasons present */
388 #define IDP_REASONS	0x40
389 
390 #define X509V3_conf_err(val) ERR_add_error_data(6, "section:", (val)->section, \
391 ",name:", (val)->name, ",value:", (val)->value);
392 
393 #define X509V3_set_ctx_test(ctx) \
394 			X509V3_set_ctx(ctx, NULL, NULL, NULL, NULL, CTX_TEST)
395 #define X509V3_set_ctx_nodb(ctx) (ctx)->db = NULL;
396 
397 #define EXT_BITSTRING(nid, table) { nid, 0, ASN1_ITEM_ref(ASN1_BIT_STRING), \
398 			0,0,0,0, \
399 			0,0, \
400 			(X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \
401 			(X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \
402 			NULL, NULL, \
403 			(void *)(table)}
404 
405 #define EXT_IA5STRING(nid) { nid, 0, ASN1_ITEM_ref(ASN1_IA5STRING), \
406 			0,0,0,0, \
407 			(X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \
408 			(X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \
409 			0,0,0,0, \
410 			NULL}
411 
412 #define EXT_END { -1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
413 
414 
415 /* X509_PURPOSE stuff */
416 
417 #define EXFLAG_BCONS		0x1
418 #define EXFLAG_KUSAGE		0x2
419 #define EXFLAG_XKUSAGE		0x4
420 #define EXFLAG_NSCERT		0x8
421 
422 #define EXFLAG_CA		0x10
423 /* Really self issued not necessarily self signed */
424 #define EXFLAG_SI		0x20
425 #define EXFLAG_V1		0x40
426 #define EXFLAG_INVALID		0x80
427 #define EXFLAG_SET		0x100
428 #define EXFLAG_CRITICAL		0x200
429 #define EXFLAG_PROXY		0x400
430 
431 #define EXFLAG_INVALID_POLICY	0x800
432 #define EXFLAG_FRESHEST		0x1000
433 /* Self signed */
434 #define EXFLAG_SS		0x2000
435 
436 #define KU_DIGITAL_SIGNATURE	0x0080
437 #define KU_NON_REPUDIATION	0x0040
438 #define KU_KEY_ENCIPHERMENT	0x0020
439 #define KU_DATA_ENCIPHERMENT	0x0010
440 #define KU_KEY_AGREEMENT	0x0008
441 #define KU_KEY_CERT_SIGN	0x0004
442 #define KU_CRL_SIGN		0x0002
443 #define KU_ENCIPHER_ONLY	0x0001
444 #define KU_DECIPHER_ONLY	0x8000
445 
446 #define NS_SSL_CLIENT		0x80
447 #define NS_SSL_SERVER		0x40
448 #define NS_SMIME		0x20
449 #define NS_OBJSIGN		0x10
450 #define NS_SSL_CA		0x04
451 #define NS_SMIME_CA		0x02
452 #define NS_OBJSIGN_CA		0x01
453 #define NS_ANY_CA		(NS_SSL_CA|NS_SMIME_CA|NS_OBJSIGN_CA)
454 
455 #define XKU_SSL_SERVER		0x1
456 #define XKU_SSL_CLIENT		0x2
457 #define XKU_SMIME		0x4
458 #define XKU_CODE_SIGN		0x8
459 #define XKU_SGC			0x10
460 #define XKU_OCSP_SIGN		0x20
461 #define XKU_TIMESTAMP		0x40
462 #define XKU_DVCS		0x80
463 #define XKU_ANYEKU		0x100
464 
465 #define X509_PURPOSE_DYNAMIC	0x1
466 #define X509_PURPOSE_DYNAMIC_NAME	0x2
467 
468 typedef struct x509_purpose_st {
469 	int purpose;
470 	int trust;		/* Default trust ID */
471 	int flags;
472 	int (*check_purpose)(const struct x509_purpose_st *,
473 				const X509 *, int);
474 	char *name;
475 	char *sname;
476 	void *usr_data;
477 } X509_PURPOSE;
478 
479 #define X509_PURPOSE_SSL_CLIENT		1
480 #define X509_PURPOSE_SSL_SERVER		2
481 #define X509_PURPOSE_NS_SSL_SERVER	3
482 #define X509_PURPOSE_SMIME_SIGN		4
483 #define X509_PURPOSE_SMIME_ENCRYPT	5
484 #define X509_PURPOSE_CRL_SIGN		6
485 #define X509_PURPOSE_ANY		7
486 #define X509_PURPOSE_OCSP_HELPER	8
487 #define X509_PURPOSE_TIMESTAMP_SIGN	9
488 
489 #define X509_PURPOSE_MIN		1
490 #define X509_PURPOSE_MAX		9
491 
492 /* Flags for X509V3_EXT_print() */
493 
494 #define X509V3_EXT_UNKNOWN_MASK		(0xfL << 16)
495 /* Return error for unknown extensions */
496 #define X509V3_EXT_DEFAULT		0
497 /* Print error for unknown extensions */
498 #define X509V3_EXT_ERROR_UNKNOWN	(1L << 16)
499 /* ASN1 parse unknown extensions */
500 #define X509V3_EXT_PARSE_UNKNOWN	(2L << 16)
501 /* BIO_dump unknown extensions */
502 #define X509V3_EXT_DUMP_UNKNOWN		(3L << 16)
503 
504 /* Flags for X509V3_add1_i2d */
505 
506 #define X509V3_ADD_OP_MASK		0xfL
507 #define X509V3_ADD_DEFAULT		0L
508 #define X509V3_ADD_APPEND		1L
509 #define X509V3_ADD_REPLACE		2L
510 #define X509V3_ADD_REPLACE_EXISTING	3L
511 #define X509V3_ADD_KEEP_EXISTING	4L
512 #define X509V3_ADD_DELETE		5L
513 #define X509V3_ADD_SILENT		0x10
514 
515 DEFINE_STACK_OF(X509_PURPOSE)
516 
517 DECLARE_ASN1_FUNCTIONS(BASIC_CONSTRAINTS)
518 
519 DECLARE_ASN1_FUNCTIONS(SXNET)
520 DECLARE_ASN1_FUNCTIONS(SXNETID)
521 
522 int SXNET_add_id_asc(SXNET **psx, char *zone, char *user, int userlen);
523 int SXNET_add_id_ulong(SXNET **psx, unsigned long lzone, char *user, int userlen);
524 int SXNET_add_id_INTEGER(SXNET **psx, ASN1_INTEGER *izone, char *user, int userlen);
525 
526 ASN1_OCTET_STRING *SXNET_get_id_asc(SXNET *sx, char *zone);
527 ASN1_OCTET_STRING *SXNET_get_id_ulong(SXNET *sx, unsigned long lzone);
528 ASN1_OCTET_STRING *SXNET_get_id_INTEGER(SXNET *sx, ASN1_INTEGER *zone);
529 
530 DECLARE_ASN1_FUNCTIONS(AUTHORITY_KEYID)
531 
532 DECLARE_ASN1_FUNCTIONS(PKEY_USAGE_PERIOD)
533 
534 DECLARE_ASN1_FUNCTIONS(GENERAL_NAME)
535 OPENSSL_EXPORT GENERAL_NAME *GENERAL_NAME_dup(GENERAL_NAME *a);
536 OPENSSL_EXPORT int GENERAL_NAME_cmp(GENERAL_NAME *a, GENERAL_NAME *b);
537 
538 
539 
540 OPENSSL_EXPORT ASN1_BIT_STRING *v2i_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
541 				X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval);
542 OPENSSL_EXPORT STACK_OF(CONF_VALUE) *i2v_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
543 				ASN1_BIT_STRING *bits,
544 				STACK_OF(CONF_VALUE) *extlist);
545 
546 OPENSSL_EXPORT STACK_OF(CONF_VALUE) *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method, GENERAL_NAME *gen, STACK_OF(CONF_VALUE) *ret);
547 OPENSSL_EXPORT int GENERAL_NAME_print(BIO *out, GENERAL_NAME *gen);
548 
549 DECLARE_ASN1_FUNCTIONS(GENERAL_NAMES)
550 
551 OPENSSL_EXPORT STACK_OF(CONF_VALUE) *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method,
552 		GENERAL_NAMES *gen, STACK_OF(CONF_VALUE) *extlist);
553 OPENSSL_EXPORT GENERAL_NAMES *v2i_GENERAL_NAMES(const X509V3_EXT_METHOD *method,
554 				 X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval);
555 
556 DECLARE_ASN1_FUNCTIONS(OTHERNAME)
557 DECLARE_ASN1_FUNCTIONS(EDIPARTYNAME)
558 OPENSSL_EXPORT int OTHERNAME_cmp(OTHERNAME *a, OTHERNAME *b);
559 OPENSSL_EXPORT void GENERAL_NAME_set0_value(GENERAL_NAME *a, int type, void *value);
560 OPENSSL_EXPORT void *GENERAL_NAME_get0_value(GENERAL_NAME *a, int *ptype);
561 OPENSSL_EXPORT int GENERAL_NAME_set0_othername(GENERAL_NAME *gen,
562 				ASN1_OBJECT *oid, ASN1_TYPE *value);
563 OPENSSL_EXPORT int GENERAL_NAME_get0_otherName(GENERAL_NAME *gen,
564 				ASN1_OBJECT **poid, ASN1_TYPE **pvalue);
565 
566 OPENSSL_EXPORT char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, ASN1_OCTET_STRING *ia5);
567 OPENSSL_EXPORT ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, char *str);
568 
569 DECLARE_ASN1_FUNCTIONS(EXTENDED_KEY_USAGE)
570 OPENSSL_EXPORT int i2a_ACCESS_DESCRIPTION(BIO *bp, ACCESS_DESCRIPTION* a);
571 
572 DECLARE_ASN1_FUNCTIONS(CERTIFICATEPOLICIES)
573 DECLARE_ASN1_FUNCTIONS(POLICYINFO)
574 DECLARE_ASN1_FUNCTIONS(POLICYQUALINFO)
575 DECLARE_ASN1_FUNCTIONS(USERNOTICE)
576 DECLARE_ASN1_FUNCTIONS(NOTICEREF)
577 
578 DECLARE_ASN1_FUNCTIONS(CRL_DIST_POINTS)
579 DECLARE_ASN1_FUNCTIONS(DIST_POINT)
580 DECLARE_ASN1_FUNCTIONS(DIST_POINT_NAME)
581 DECLARE_ASN1_FUNCTIONS(ISSUING_DIST_POINT)
582 
583 OPENSSL_EXPORT int DIST_POINT_set_dpname(DIST_POINT_NAME *dpn, X509_NAME *iname);
584 
585 OPENSSL_EXPORT int NAME_CONSTRAINTS_check(X509 *x, NAME_CONSTRAINTS *nc);
586 
587 DECLARE_ASN1_FUNCTIONS(ACCESS_DESCRIPTION)
588 DECLARE_ASN1_FUNCTIONS(AUTHORITY_INFO_ACCESS)
589 
590 DECLARE_ASN1_ITEM(POLICY_MAPPING)
591 DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_MAPPING)
592 DECLARE_ASN1_ITEM(POLICY_MAPPINGS)
593 
594 DECLARE_ASN1_ITEM(GENERAL_SUBTREE)
595 DECLARE_ASN1_ALLOC_FUNCTIONS(GENERAL_SUBTREE)
596 
597 DECLARE_ASN1_ITEM(NAME_CONSTRAINTS)
598 DECLARE_ASN1_ALLOC_FUNCTIONS(NAME_CONSTRAINTS)
599 
600 DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_CONSTRAINTS)
601 DECLARE_ASN1_ITEM(POLICY_CONSTRAINTS)
602 
603 OPENSSL_EXPORT GENERAL_NAME *a2i_GENERAL_NAME(GENERAL_NAME *out,
604 			       const X509V3_EXT_METHOD *method, X509V3_CTX *ctx,
605 			       int gen_type, char *value, int is_nc);
606 
607 OPENSSL_EXPORT GENERAL_NAME *v2i_GENERAL_NAME(const X509V3_EXT_METHOD *method, X509V3_CTX *ctx,
608 			       CONF_VALUE *cnf);
609 OPENSSL_EXPORT GENERAL_NAME *v2i_GENERAL_NAME_ex(GENERAL_NAME *out,
610 				  const X509V3_EXT_METHOD *method,
611 				  X509V3_CTX *ctx, CONF_VALUE *cnf, int is_nc);
612 OPENSSL_EXPORT void X509V3_conf_free(CONF_VALUE *val);
613 
614 OPENSSL_EXPORT X509_EXTENSION *X509V3_EXT_conf_nid(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx, int ext_nid, char *value);
615 OPENSSL_EXPORT X509_EXTENSION *X509V3_EXT_nconf_nid(CONF *conf, X509V3_CTX *ctx, int ext_nid, char *value);
616 OPENSSL_EXPORT X509_EXTENSION *X509V3_EXT_nconf(CONF *conf, X509V3_CTX *ctx, char *name, char *value);
617 OPENSSL_EXPORT int X509V3_EXT_add_nconf_sk(CONF *conf, X509V3_CTX *ctx, char *section, STACK_OF(X509_EXTENSION) **sk);
618 OPENSSL_EXPORT int X509V3_EXT_add_nconf(CONF *conf, X509V3_CTX *ctx, char *section, X509 *cert);
619 OPENSSL_EXPORT int X509V3_EXT_REQ_add_nconf(CONF *conf, X509V3_CTX *ctx, char *section, X509_REQ *req);
620 OPENSSL_EXPORT int X509V3_EXT_CRL_add_nconf(CONF *conf, X509V3_CTX *ctx, char *section, X509_CRL *crl);
621 
622 OPENSSL_EXPORT int X509V3_EXT_CRL_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
623 			    char *section, X509_CRL *crl);
624 
625 OPENSSL_EXPORT int X509V3_add_value_bool_nf(char *name, int asn1_bool,
626 			     STACK_OF(CONF_VALUE) **extlist);
627 OPENSSL_EXPORT int X509V3_get_value_bool(CONF_VALUE *value, int *asn1_bool);
628 OPENSSL_EXPORT int X509V3_get_value_int(CONF_VALUE *value, ASN1_INTEGER **aint);
629 OPENSSL_EXPORT void X509V3_set_nconf(X509V3_CTX *ctx, CONF *conf);
630 
631 OPENSSL_EXPORT char * X509V3_get_string(X509V3_CTX *ctx, char *name, char *section);
632 OPENSSL_EXPORT STACK_OF(CONF_VALUE) * X509V3_get_section(X509V3_CTX *ctx, char *section);
633 OPENSSL_EXPORT void X509V3_string_free(X509V3_CTX *ctx, char *str);
634 OPENSSL_EXPORT void X509V3_section_free( X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *section);
635 OPENSSL_EXPORT void X509V3_set_ctx(X509V3_CTX *ctx, X509 *issuer, X509 *subject,
636 				 X509_REQ *req, X509_CRL *crl, int flags);
637 
638 OPENSSL_EXPORT int X509V3_add_value(const char *name, const char *value,
639 						STACK_OF(CONF_VALUE) **extlist);
640 OPENSSL_EXPORT int X509V3_add_value_uchar(const char *name, const unsigned char *value,
641 						STACK_OF(CONF_VALUE) **extlist);
642 OPENSSL_EXPORT int X509V3_add_value_bool(const char *name, int asn1_bool,
643 						STACK_OF(CONF_VALUE) **extlist);
644 OPENSSL_EXPORT int X509V3_add_value_int(const char *name, ASN1_INTEGER *aint,
645 						STACK_OF(CONF_VALUE) **extlist);
646 OPENSSL_EXPORT char * i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, ASN1_INTEGER *aint);
647 OPENSSL_EXPORT ASN1_INTEGER * s2i_ASN1_INTEGER(X509V3_EXT_METHOD *meth, char *value);
648 OPENSSL_EXPORT char * i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
649 OPENSSL_EXPORT char * i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
650 OPENSSL_EXPORT int X509V3_EXT_add(X509V3_EXT_METHOD *ext);
651 OPENSSL_EXPORT int X509V3_EXT_add_list(X509V3_EXT_METHOD *extlist);
652 OPENSSL_EXPORT int X509V3_EXT_add_alias(int nid_to, int nid_from);
653 OPENSSL_EXPORT void X509V3_EXT_cleanup(void);
654 
655 OPENSSL_EXPORT const X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext);
656 OPENSSL_EXPORT const X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid);
657 OPENSSL_EXPORT int X509V3_add_standard_extensions(void);
658 OPENSSL_EXPORT STACK_OF(CONF_VALUE) *X509V3_parse_list(const char *line);
659 OPENSSL_EXPORT void *X509V3_EXT_d2i(X509_EXTENSION *ext);
660 OPENSSL_EXPORT void *X509V3_get_d2i(STACK_OF(X509_EXTENSION) *x, int nid, int *crit, int *idx);
661 OPENSSL_EXPORT int X509V3_EXT_free(int nid, void *ext_data);
662 
663 
664 OPENSSL_EXPORT X509_EXTENSION *X509V3_EXT_i2d(int ext_nid, int crit, void *ext_struc);
665 OPENSSL_EXPORT int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value, int crit, unsigned long flags);
666 
667 char *hex_to_string(const unsigned char *buffer, long len);
668 unsigned char *string_to_hex(const char *str, long *len);
669 int name_cmp(const char *name, const char *cmp);
670 
671 OPENSSL_EXPORT void X509V3_EXT_val_prn(BIO *out, STACK_OF(CONF_VALUE) *val, int indent,
672 								 int ml);
673 OPENSSL_EXPORT int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, int indent);
674 OPENSSL_EXPORT int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
675 
676 OPENSSL_EXPORT int X509V3_extensions_print(BIO *out, const char *title, STACK_OF(X509_EXTENSION) *exts, unsigned long flag, int indent);
677 
678 OPENSSL_EXPORT int X509_check_ca(X509 *x);
679 OPENSSL_EXPORT int X509_check_purpose(X509 *x, int id, int ca);
680 OPENSSL_EXPORT int X509_supported_extension(X509_EXTENSION *ex);
681 OPENSSL_EXPORT int X509_PURPOSE_set(int *p, int purpose);
682 OPENSSL_EXPORT int X509_check_issued(X509 *issuer, X509 *subject);
683 OPENSSL_EXPORT int X509_check_akid(X509 *issuer, AUTHORITY_KEYID *akid);
684 OPENSSL_EXPORT int X509_PURPOSE_get_count(void);
685 OPENSSL_EXPORT X509_PURPOSE * X509_PURPOSE_get0(int idx);
686 OPENSSL_EXPORT int X509_PURPOSE_get_by_sname(char *sname);
687 OPENSSL_EXPORT int X509_PURPOSE_get_by_id(int id);
688 OPENSSL_EXPORT int X509_PURPOSE_add(int id, int trust, int flags,
689 			int (*ck)(const X509_PURPOSE *, const X509 *, int),
690 				char *name, char *sname, void *arg);
691 OPENSSL_EXPORT char *X509_PURPOSE_get0_name(X509_PURPOSE *xp);
692 OPENSSL_EXPORT char *X509_PURPOSE_get0_sname(X509_PURPOSE *xp);
693 OPENSSL_EXPORT int X509_PURPOSE_get_trust(X509_PURPOSE *xp);
694 OPENSSL_EXPORT void X509_PURPOSE_cleanup(void);
695 OPENSSL_EXPORT int X509_PURPOSE_get_id(X509_PURPOSE *);
696 
697 OPENSSL_EXPORT STACK_OF(OPENSSL_STRING) *X509_get1_email(X509 *x);
698 OPENSSL_EXPORT STACK_OF(OPENSSL_STRING) *X509_REQ_get1_email(X509_REQ *x);
699 OPENSSL_EXPORT void X509_email_free(STACK_OF(OPENSSL_STRING) *sk);
700 OPENSSL_EXPORT STACK_OF(OPENSSL_STRING) *X509_get1_ocsp(X509 *x);
701 /* Flags for X509_check_* functions */
702 
703 /* Always check subject name for host match even if subject alt names present */
704 #define X509_CHECK_FLAG_ALWAYS_CHECK_SUBJECT	0x1
705 /* Disable wildcard matching for dnsName fields and common name. */
706 #define X509_CHECK_FLAG_NO_WILDCARDS	0x2
707 /* Wildcards must not match a partial label. */
708 #define X509_CHECK_FLAG_NO_PARTIAL_WILDCARDS 0x4
709 /* Allow (non-partial) wildcards to match multiple labels. */
710 #define X509_CHECK_FLAG_MULTI_LABEL_WILDCARDS 0x8
711 /* Constraint verifier subdomain patterns to match a single labels. */
712 #define X509_CHECK_FLAG_SINGLE_LABEL_SUBDOMAINS 0x10
713 /*
714  * Match reference identifiers starting with "." to any sub-domain.
715  * This is a non-public flag, turned on implicitly when the subject
716  * reference identity is a DNS name.
717  */
718 #define _X509_CHECK_FLAG_DOT_SUBDOMAINS 0x8000
719 
720 OPENSSL_EXPORT int X509_check_host(X509 *x, const char *chk, size_t chklen,
721 					unsigned int flags, char **peername);
722 OPENSSL_EXPORT int X509_check_email(X509 *x, const char *chk, size_t chklen,
723 					unsigned int flags);
724 OPENSSL_EXPORT int X509_check_ip(X509 *x, const unsigned char *chk, size_t chklen,
725 					unsigned int flags);
726 OPENSSL_EXPORT int X509_check_ip_asc(X509 *x, const char *ipasc, unsigned int flags);
727 
728 OPENSSL_EXPORT ASN1_OCTET_STRING *a2i_IPADDRESS(const char *ipasc);
729 OPENSSL_EXPORT ASN1_OCTET_STRING *a2i_IPADDRESS_NC(const char *ipasc);
730 OPENSSL_EXPORT int a2i_ipadd(unsigned char *ipout, const char *ipasc);
731 OPENSSL_EXPORT int X509V3_NAME_from_section(X509_NAME *nm, STACK_OF(CONF_VALUE)*dn_sk,
732 						unsigned long chtype);
733 
734 OPENSSL_EXPORT void X509_POLICY_NODE_print(BIO *out, X509_POLICY_NODE *node, int indent);
735 DEFINE_STACK_OF(X509_POLICY_NODE)
736 
737 /* BEGIN ERROR CODES */
738 /* The following lines are auto generated by the script mkerr.pl. Any changes
739  * made after this point may be overwritten when the script is next run.
740  */
741 
742 
743 #ifdef  __cplusplus
744 }
745 
746 extern "C++" {
747 
748 namespace bssl {
749 
750 BORINGSSL_MAKE_STACK_DELETER(DIST_POINT, DIST_POINT_free)
751 BORINGSSL_MAKE_STACK_DELETER(GENERAL_NAME, GENERAL_NAME_free)
752 // A STACK_OF(POLICYINFO) is also known as a CERTIFICATEPOLICIES.
753 BORINGSSL_MAKE_STACK_DELETER(POLICYINFO, POLICYINFO_free)
754 
755 BORINGSSL_MAKE_DELETER(AUTHORITY_KEYID, AUTHORITY_KEYID_free)
756 BORINGSSL_MAKE_DELETER(BASIC_CONSTRAINTS, BASIC_CONSTRAINTS_free)
757 BORINGSSL_MAKE_DELETER(DIST_POINT, DIST_POINT_free)
758 BORINGSSL_MAKE_DELETER(GENERAL_NAME, GENERAL_NAME_free)
759 
760 }  // namespace bssl
761 
762 }  /* extern C++ */
763 #endif
764 
765 #define X509V3_R_BAD_IP_ADDRESS 100
766 #define X509V3_R_BAD_OBJECT 101
767 #define X509V3_R_BN_DEC2BN_ERROR 102
768 #define X509V3_R_BN_TO_ASN1_INTEGER_ERROR 103
769 #define X509V3_R_CANNOT_FIND_FREE_FUNCTION 104
770 #define X509V3_R_DIRNAME_ERROR 105
771 #define X509V3_R_DISTPOINT_ALREADY_SET 106
772 #define X509V3_R_DUPLICATE_ZONE_ID 107
773 #define X509V3_R_ERROR_CONVERTING_ZONE 108
774 #define X509V3_R_ERROR_CREATING_EXTENSION 109
775 #define X509V3_R_ERROR_IN_EXTENSION 110
776 #define X509V3_R_EXPECTED_A_SECTION_NAME 111
777 #define X509V3_R_EXTENSION_EXISTS 112
778 #define X509V3_R_EXTENSION_NAME_ERROR 113
779 #define X509V3_R_EXTENSION_NOT_FOUND 114
780 #define X509V3_R_EXTENSION_SETTING_NOT_SUPPORTED 115
781 #define X509V3_R_EXTENSION_VALUE_ERROR 116
782 #define X509V3_R_ILLEGAL_EMPTY_EXTENSION 117
783 #define X509V3_R_ILLEGAL_HEX_DIGIT 118
784 #define X509V3_R_INCORRECT_POLICY_SYNTAX_TAG 119
785 #define X509V3_R_INVALID_BOOLEAN_STRING 120
786 #define X509V3_R_INVALID_EXTENSION_STRING 121
787 #define X509V3_R_INVALID_MULTIPLE_RDNS 122
788 #define X509V3_R_INVALID_NAME 123
789 #define X509V3_R_INVALID_NULL_ARGUMENT 124
790 #define X509V3_R_INVALID_NULL_NAME 125
791 #define X509V3_R_INVALID_NULL_VALUE 126
792 #define X509V3_R_INVALID_NUMBER 127
793 #define X509V3_R_INVALID_NUMBERS 128
794 #define X509V3_R_INVALID_OBJECT_IDENTIFIER 129
795 #define X509V3_R_INVALID_OPTION 130
796 #define X509V3_R_INVALID_POLICY_IDENTIFIER 131
797 #define X509V3_R_INVALID_PROXY_POLICY_SETTING 132
798 #define X509V3_R_INVALID_PURPOSE 133
799 #define X509V3_R_INVALID_SECTION 134
800 #define X509V3_R_INVALID_SYNTAX 135
801 #define X509V3_R_ISSUER_DECODE_ERROR 136
802 #define X509V3_R_MISSING_VALUE 137
803 #define X509V3_R_NEED_ORGANIZATION_AND_NUMBERS 138
804 #define X509V3_R_NO_CONFIG_DATABASE 139
805 #define X509V3_R_NO_ISSUER_CERTIFICATE 140
806 #define X509V3_R_NO_ISSUER_DETAILS 141
807 #define X509V3_R_NO_POLICY_IDENTIFIER 142
808 #define X509V3_R_NO_PROXY_CERT_POLICY_LANGUAGE_DEFINED 143
809 #define X509V3_R_NO_PUBLIC_KEY 144
810 #define X509V3_R_NO_SUBJECT_DETAILS 145
811 #define X509V3_R_ODD_NUMBER_OF_DIGITS 146
812 #define X509V3_R_OPERATION_NOT_DEFINED 147
813 #define X509V3_R_OTHERNAME_ERROR 148
814 #define X509V3_R_POLICY_LANGUAGE_ALREADY_DEFINED 149
815 #define X509V3_R_POLICY_PATH_LENGTH 150
816 #define X509V3_R_POLICY_PATH_LENGTH_ALREADY_DEFINED 151
817 #define X509V3_R_POLICY_WHEN_PROXY_LANGUAGE_REQUIRES_NO_POLICY 152
818 #define X509V3_R_SECTION_NOT_FOUND 153
819 #define X509V3_R_UNABLE_TO_GET_ISSUER_DETAILS 154
820 #define X509V3_R_UNABLE_TO_GET_ISSUER_KEYID 155
821 #define X509V3_R_UNKNOWN_BIT_STRING_ARGUMENT 156
822 #define X509V3_R_UNKNOWN_EXTENSION 157
823 #define X509V3_R_UNKNOWN_EXTENSION_NAME 158
824 #define X509V3_R_UNKNOWN_OPTION 159
825 #define X509V3_R_UNSUPPORTED_OPTION 160
826 #define X509V3_R_UNSUPPORTED_TYPE 161
827 #define X509V3_R_USER_TOO_LONG 162
828 
829 #endif
830