xref: /openbsd/lib/libcrypto/objects/objects.h (revision f09dc5a5)
1 /* $OpenBSD: objects.h,v 1.29 2024/03/02 09:51:36 tb Exp $ */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  *
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  *
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  *
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  *
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  *
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58 
59 #ifndef HEADER_OBJECTS_H
60 #define HEADER_OBJECTS_H
61 
62 #include <openssl/obj_mac.h>
63 
64 #define SN_ED25519			SN_Ed25519
65 #define NID_ED25519			NID_Ed25519
66 #define OBJ_ED25519			OBJ_Ed25519
67 
68 #include <openssl/bio.h>
69 #include <openssl/asn1.h>
70 
71 #define	OBJ_NAME_TYPE_UNDEF		0x00
72 #define	OBJ_NAME_TYPE_MD_METH		0x01
73 #define	OBJ_NAME_TYPE_CIPHER_METH	0x02
74 #define	OBJ_NAME_TYPE_NUM		0x03
75 
76 #define	OBJ_NAME_ALIAS			0x8000
77 
78 #ifdef  __cplusplus
79 extern "C" {
80 #endif
81 
82 typedef struct obj_name_st {
83 	int type;
84 	int alias;
85 	const char *name;
86 	const void *data;
87 } OBJ_NAME;
88 
89 void OBJ_NAME_do_all(int type, void (*fn)(const OBJ_NAME *, void *arg),
90     void *arg);
91 void OBJ_NAME_do_all_sorted(int type, void (*fn)(const OBJ_NAME *, void *arg),
92     void *arg);
93 
94 ASN1_OBJECT *	OBJ_dup(const ASN1_OBJECT *o);
95 ASN1_OBJECT *	OBJ_nid2obj(int n);
96 const char *	OBJ_nid2ln(int n);
97 const char *	OBJ_nid2sn(int n);
98 int		OBJ_obj2nid(const ASN1_OBJECT *o);
99 ASN1_OBJECT *	OBJ_txt2obj(const char *s, int no_name);
100 int	OBJ_obj2txt(char *buf, int buf_len, const ASN1_OBJECT *a, int no_name);
101 int		OBJ_txt2nid(const char *s);
102 int		OBJ_ln2nid(const char *s);
103 int		OBJ_sn2nid(const char *s);
104 int		OBJ_cmp(const ASN1_OBJECT *a, const ASN1_OBJECT *b);
105 
106 int		OBJ_new_nid(int num);
107 int		OBJ_create(const char *oid, const char *sn, const char *ln);
108 void		OBJ_cleanup(void);
109 int		OBJ_create_objects(BIO *in);
110 
111 size_t OBJ_length(const ASN1_OBJECT *obj);
112 const unsigned char *OBJ_get0_data(const ASN1_OBJECT *obj);
113 
114 int OBJ_find_sigid_algs(int signid, int *pdig_nid, int *ppkey_nid);
115 int OBJ_find_sigid_by_algs(int *psignid, int dig_nid, int pkey_nid);
116 
117 void ERR_load_OBJ_strings(void);
118 
119 /* Error codes for the OBJ functions. */
120 
121 /* Function codes. */
122 #define OBJ_F_OBJ_ADD_OBJECT				 105
123 #define OBJ_F_OBJ_CREATE				 100
124 #define OBJ_F_OBJ_DUP					 101
125 #define OBJ_F_OBJ_NAME_NEW_INDEX			 106
126 #define OBJ_F_OBJ_NID2LN				 102
127 #define OBJ_F_OBJ_NID2OBJ				 103
128 #define OBJ_F_OBJ_NID2SN				 104
129 
130 /* Reason codes. */
131 #define OBJ_R_MALLOC_FAILURE				 100
132 #define OBJ_R_UNKNOWN_NID				 101
133 
134 #ifdef  __cplusplus
135 }
136 #endif
137 #endif
138