1 /* $OpenBSD: asn1_locl.h,v 1.6 2015/10/02 15:04:45 beck Exp $ */
2 /* Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
3  * project 2006.
4  */
5 /* ====================================================================
6  * Copyright (c) 2006 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 
59 /* Internal ASN1 structures and functions: not for application use */
60 
61 /* ASN1 print context structure */
62 
63 struct asn1_pctx_st {
64 	unsigned long flags;
65 	unsigned long nm_flags;
66 	unsigned long cert_flags;
67 	unsigned long oid_flags;
68 	unsigned long str_flags;
69 } /* ASN1_PCTX */;
70 
71 /* ASN1 public key method structure */
72 
73 struct evp_pkey_asn1_method_st {
74 	int pkey_id;
75 	int pkey_base_id;
76 	unsigned long pkey_flags;
77 
78 	char *pem_str;
79 	char *info;
80 
81 	int (*pub_decode)(EVP_PKEY *pk, X509_PUBKEY *pub);
82 	int (*pub_encode)(X509_PUBKEY *pub, const EVP_PKEY *pk);
83 	int (*pub_cmp)(const EVP_PKEY *a, const EVP_PKEY *b);
84 	int (*pub_print)(BIO *out, const EVP_PKEY *pkey, int indent,
85 	    ASN1_PCTX *pctx);
86 
87 	int (*priv_decode)(EVP_PKEY *pk, PKCS8_PRIV_KEY_INFO *p8inf);
88 	int (*priv_encode)(PKCS8_PRIV_KEY_INFO *p8, const EVP_PKEY *pk);
89 	int (*priv_print)(BIO *out, const EVP_PKEY *pkey, int indent,
90 	    ASN1_PCTX *pctx);
91 
92 	int (*pkey_size)(const EVP_PKEY *pk);
93 	int (*pkey_bits)(const EVP_PKEY *pk);
94 
95 	int (*param_decode)(EVP_PKEY *pkey, const unsigned char **pder,
96 	    int derlen);
97 	int (*param_encode)(const EVP_PKEY *pkey, unsigned char **pder);
98 	int (*param_missing)(const EVP_PKEY *pk);
99 	int (*param_copy)(EVP_PKEY *to, const EVP_PKEY *from);
100 	int (*param_cmp)(const EVP_PKEY *a, const EVP_PKEY *b);
101 	int (*param_print)(BIO *out, const EVP_PKEY *pkey, int indent,
102 	    ASN1_PCTX *pctx);
103 	int (*sig_print)(BIO *out, const X509_ALGOR *sigalg,
104 	    const ASN1_STRING *sig, int indent, ASN1_PCTX *pctx);
105 
106 	void (*pkey_free)(EVP_PKEY *pkey);
107 	int (*pkey_ctrl)(EVP_PKEY *pkey, int op, long arg1, void *arg2);
108 
109 	/* Legacy functions for old PEM */
110 
111 	int (*old_priv_decode)(EVP_PKEY *pkey, const unsigned char **pder,
112 	    int derlen);
113 	int (*old_priv_encode)(const EVP_PKEY *pkey, unsigned char **pder);
114 	/* Custom ASN1 signature verification */
115 	int (*item_verify)(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
116 	    X509_ALGOR *a, ASN1_BIT_STRING *sig, EVP_PKEY *pkey);
117 	int (*item_sign)(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
118 	    X509_ALGOR *alg1, X509_ALGOR *alg2, ASN1_BIT_STRING *sig);
119 
120 } /* EVP_PKEY_ASN1_METHOD */;
121 
122 /* Method to handle CRL access.
123  * In general a CRL could be very large (several Mb) and can consume large
124  * amounts of resources if stored in memory by multiple processes.
125  * This method allows general CRL operations to be redirected to more
126  * efficient callbacks: for example a CRL entry database.
127  */
128 
129 #define X509_CRL_METHOD_DYNAMIC		1
130 
131 struct x509_crl_method_st {
132 	int flags;
133 	int (*crl_init)(X509_CRL *crl);
134 	int (*crl_free)(X509_CRL *crl);
135 	int (*crl_lookup)(X509_CRL *crl, X509_REVOKED **ret,
136 	    ASN1_INTEGER *ser, X509_NAME *issuer);
137 	int (*crl_verify)(X509_CRL *crl, EVP_PKEY *pk);
138 };
139 
140 /*
141  * Unicode codepoint constants
142  */
143 #define	UNICODE_MAX		0x10FFFF
144 #define	UNICODE_SURROGATE_MIN	0x00D800
145 #define	UNICODE_SURROGATE_MAX	0x00DFFF
146 
147 #define	UNICODE_IS_SURROGATE(x) \
148 	((x) >= UNICODE_SURROGATE_MIN && (x) <= UNICODE_SURROGATE_MAX)
149 
150 int UTF8_getc(const unsigned char *str, int len, unsigned long *val);
151 int UTF8_putc(unsigned char *str, int len, unsigned long value);
152