Annotation of src/usr.bin/openssl/apps.h, Revision 1.18
1.18 ! deraadt 1: /* $OpenBSD: apps.h,v 1.17 2015/10/10 22:28:51 doug Exp $ */
1.1 jsing 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: * Copyright (c) 1998-2001 The OpenSSL Project. All rights reserved.
60: *
61: * Redistribution and use in source and binary forms, with or without
62: * modification, are permitted provided that the following conditions
63: * are met:
64: *
65: * 1. Redistributions of source code must retain the above copyright
66: * notice, this list of conditions and the following disclaimer.
67: *
68: * 2. Redistributions in binary form must reproduce the above copyright
69: * notice, this list of conditions and the following disclaimer in
70: * the documentation and/or other materials provided with the
71: * distribution.
72: *
73: * 3. All advertising materials mentioning features or use of this
74: * software must display the following acknowledgment:
75: * "This product includes software developed by the OpenSSL Project
76: * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
77: *
78: * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
79: * endorse or promote products derived from this software without
80: * prior written permission. For written permission, please contact
81: * openssl-core@openssl.org.
82: *
83: * 5. Products derived from this software may not be called "OpenSSL"
84: * nor may "OpenSSL" appear in their names without prior written
85: * permission of the OpenSSL Project.
86: *
87: * 6. Redistributions of any form whatsoever must retain the following
88: * acknowledgment:
89: * "This product includes software developed by the OpenSSL Project
90: * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
91: *
92: * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
93: * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
94: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
95: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
96: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
98: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
99: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
100: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
101: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
102: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
103: * OF THE POSSIBILITY OF SUCH DAMAGE.
104: * ====================================================================
105: *
106: * This product includes cryptographic software written by Eric Young
107: * (eay@cryptsoft.com). This product includes software written by Tim
108: * Hudson (tjh@cryptsoft.com).
109: *
110: */
111:
112: #ifndef HEADER_APPS_H
113: #define HEADER_APPS_H
114:
115: #include <openssl/opensslconf.h>
116:
117: #include <openssl/bio.h>
118: #include <openssl/conf.h>
119: #include <openssl/lhash.h>
120: #include <openssl/ossl_typ.h>
121: #include <openssl/txt_db.h>
122: #include <openssl/x509.h>
1.16 bcook 123: #include <openssl/ui.h>
1.1 jsing 124:
125: #ifndef OPENSSL_NO_OCSP
126: #include <openssl/ocsp.h>
127: #endif
1.17 doug 128:
129: #include <unistd.h>
130: extern int single_execution;
1.1 jsing 131:
132: extern CONF *config;
133: extern char *default_config_file;
134: extern BIO *bio_err;
135:
136: typedef struct args_st {
137: char **data;
138: int count;
139: } ARGS;
140:
141: #define PW_MIN_LENGTH 4
142: typedef struct pw_cb_data {
143: const void *password;
144: const char *prompt_info;
145: } PW_CB_DATA;
146:
147: int password_callback(char *buf, int bufsiz, int verify, void *cb_data);
148:
1.16 bcook 149: int setup_ui(void);
150: void destroy_ui(void);
151:
152: extern UI_METHOD *ui_method;
153: int ui_open(UI *ui);
154: int ui_read(UI *ui, UI_STRING *uis);
155: int ui_write(UI *ui, UI_STRING *uis);
156: int ui_close(UI *ui);
1.1 jsing 157:
158: int should_retry(int i);
159: int args_from_file(char *file, int *argc, char **argv[]);
160: int str2fmt(char *s);
161: void program_name(char *in, char *out, int size);
162: int chopup_args(ARGS *arg, char *buf, int *argc, char **argv[]);
163: #ifdef HEADER_X509_H
164: int dump_cert_text(BIO *out, X509 *x);
165: void print_name(BIO *out, const char *title, X509_NAME *nm,
166: unsigned long lflags);
167: #endif
168: int set_cert_ex(unsigned long *flags, const char *arg);
169: int set_name_ex(unsigned long *flags, const char *arg);
170: int set_ext_copy(int *copy_type, const char *arg);
171: int copy_extensions(X509 *x, X509_REQ *req, int copy_type);
172: int app_passwd(BIO *err, char *arg1, char *arg2, char **pass1, char **pass2);
173: int add_oid_section(BIO *err, CONF *conf);
174: X509 *load_cert(BIO *err, const char *file, int format,
1.15 bcook 175: const char *pass, const char *cert_descrip);
1.1 jsing 176: EVP_PKEY *load_key(BIO *err, const char *file, int format, int maybe_stdin,
1.15 bcook 177: const char *pass, const char *key_descrip);
1.1 jsing 178: EVP_PKEY *load_pubkey(BIO *err, const char *file, int format, int maybe_stdin,
1.15 bcook 179: const char *pass, const char *key_descrip);
1.1 jsing 180: STACK_OF(X509) *load_certs(BIO *err, const char *file, int format,
1.15 bcook 181: const char *pass, const char *cert_descrip);
1.1 jsing 182: STACK_OF(X509_CRL) *load_crls(BIO *err, const char *file, int format,
1.15 bcook 183: const char *pass, const char *cert_descrip);
1.1 jsing 184: X509_STORE *setup_verify(BIO *bp, char *CAfile, char *CApath);
185:
186: #ifndef OPENSSL_NO_OCSP
187: OCSP_RESPONSE *process_responder(BIO *err, OCSP_REQUEST *req,
188: char *host, char *path, char *port, int use_ssl,
189: STACK_OF(CONF_VALUE) *headers, int req_timeout);
190: #endif
191:
192: int load_config(BIO *err, CONF *cnf);
193: char *make_config_name(void);
194:
195: /* Functions defined in ca.c and also used in ocsp.c */
196: int unpack_revinfo(ASN1_TIME **prevtm, int *preason, ASN1_OBJECT **phold,
197: ASN1_GENERALIZEDTIME **pinvtm, const char *str);
198:
199: #define DB_type 0
200: #define DB_exp_date 1
201: #define DB_rev_date 2
202: #define DB_serial 3 /* index - unique */
203: #define DB_file 4
204: #define DB_name 5 /* index - unique when active and not disabled */
205: #define DB_NUMBER 6
206:
207: #define DB_TYPE_REV 'R'
208: #define DB_TYPE_EXP 'E'
209: #define DB_TYPE_VAL 'V'
210:
211: typedef struct db_attr_st {
212: int unique_subject;
213: } DB_ATTR;
214: typedef struct ca_db_st {
215: DB_ATTR attributes;
216: TXT_DB *db;
217: } CA_DB;
218:
219: BIGNUM *load_serial(char *serialfile, int create, ASN1_INTEGER **retai);
220: int save_serial(char *serialfile, char *suffix, BIGNUM *serial,
221: ASN1_INTEGER **retai);
222: int rotate_serial(char *serialfile, char *new_suffix, char *old_suffix);
223: int rand_serial(BIGNUM *b, ASN1_INTEGER *ai);
224: CA_DB *load_index(char *dbfile, DB_ATTR *dbattr);
225: int index_index(CA_DB *db);
226: int save_index(const char *dbfile, const char *suffix, CA_DB *db);
227: int rotate_index(const char *dbfile, const char *new_suffix,
228: const char *old_suffix);
229: void free_index(CA_DB *db);
230: #define index_name_cmp_noconst(a, b) \
231: index_name_cmp((const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, a), \
232: (const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, b))
233: int index_name_cmp(const OPENSSL_CSTRING *a, const OPENSSL_CSTRING *b);
234: int parse_yesno(const char *str, int def);
235:
236: X509_NAME *parse_name(char *str, long chtype, int multirdn);
237: int args_verify(char ***pargs, int *pargc, int *badarg, BIO *err,
238: X509_VERIFY_PARAM **pm);
239: void policies_print(BIO *out, X509_STORE_CTX *ctx);
240: int bio_to_mem(unsigned char **out, int maxlen, BIO *in);
241: int pkey_ctrl_string(EVP_PKEY_CTX *ctx, char *value);
1.15 bcook 242: int init_gen_str(BIO *err, EVP_PKEY_CTX **pctx, const char *algname,
1.1 jsing 243: int do_param);
244: int do_X509_sign(BIO *err, X509 *x, EVP_PKEY *pkey, const EVP_MD *md,
245: STACK_OF(OPENSSL_STRING) *sigopts);
246: int do_X509_REQ_sign(BIO *err, X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md,
247: STACK_OF(OPENSSL_STRING) *sigopts);
248: int do_X509_CRL_sign(BIO *err, X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md,
249: STACK_OF(OPENSSL_STRING) *sigopts);
250:
251: unsigned char *next_protos_parse(unsigned short *outlen, const char *in);
252:
253: #define FORMAT_UNDEF 0
254: #define FORMAT_ASN1 1
255: #define FORMAT_TEXT 2
256: #define FORMAT_PEM 3
257: #define FORMAT_NETSCAPE 4
258: #define FORMAT_PKCS12 5
259: #define FORMAT_SMIME 6
1.15 bcook 260:
1.1 jsing 261: #define FORMAT_IISSGC 8 /* XXX this stupid macro helps us to avoid
262: * adding yet another param to load_*key() */
263: #define FORMAT_PEMRSA 9 /* PEM RSAPubicKey format */
264: #define FORMAT_ASN1RSA 10 /* DER RSAPubicKey format */
265: #define FORMAT_MSBLOB 11 /* MS Key blob format */
266: #define FORMAT_PVK 12 /* MS PVK file format */
267:
268: #define EXT_COPY_NONE 0
269: #define EXT_COPY_ADD 1
270: #define EXT_COPY_ALL 2
271:
272: #define NETSCAPE_CERT_HDR "certificate"
273:
274: #define APP_PASS_LEN 1024
275:
276: #define SERIAL_RAND_BITS 64
277:
278: int app_isdir(const char *);
279:
280: #define TM_START 0
281: #define TM_STOP 1
282: double app_tminterval (int stop, int usertime);
283:
284: #define OPENSSL_NO_SSL_INTERN
1.2 jsing 285:
286: struct option {
287: const char *name;
288: const char *argname;
289: const char *desc;
290: enum {
291: OPTION_ARG,
1.12 jsing 292: OPTION_ARGV_FUNC,
1.4 jsing 293: OPTION_ARG_FORMAT,
1.6 jsing 294: OPTION_ARG_FUNC,
1.3 jsing 295: OPTION_ARG_INT,
1.14 jsing 296: OPTION_ARG_LONG,
1.13 jsing 297: OPTION_DISCARD,
1.7 jsing 298: OPTION_FUNC,
1.2 jsing 299: OPTION_FLAG,
1.5 jsing 300: OPTION_FLAG_ORD,
1.2 jsing 301: OPTION_VALUE,
1.13 jsing 302: OPTION_VALUE_AND,
303: OPTION_VALUE_OR,
1.2 jsing 304: } type;
305: union {
306: char **arg;
1.10 jsing 307: int (*argfunc)(char *arg);
1.12 jsing 308: int (*argvfunc)(int argc, char **argv, int *argsused);
1.2 jsing 309: int *flag;
1.10 jsing 310: int (*func)(void);
1.14 jsing 311: long *lvalue;
1.2 jsing 312: int *value;
1.18 ! deraadt 313: time_t *tvalue;
1.2 jsing 314: } opt;
315: const int value;
316: };
317:
318: void options_usage(struct option *opts);
1.11 jsing 319: int options_parse(int argc, char **argv, struct option *opts, char **unnamed,
320: int *argsused);
1.1 jsing 321:
322: #endif