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