epoc32/include/stdapis/openssl/engine.h
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
     1.1 --- a/epoc32/include/stdapis/openssl/engine.h	Tue Nov 24 13:55:44 2009 +0000
     1.2 +++ b/epoc32/include/stdapis/openssl/engine.h	Tue Mar 16 16:12:26 2010 +0000
     1.3 @@ -1,1 +1,763 @@
     1.4 -engine.h
     1.5 +/* openssl/engine.h */
     1.6 +/* Written by Geoff Thorpe (geoff@geoffthorpe.net) for the OpenSSL
     1.7 + * project 2000.
     1.8 + */
     1.9 +/* ====================================================================
    1.10 + * Copyright (c) 1999-2004 The OpenSSL Project.  All rights reserved.
    1.11 + *
    1.12 + * Redistribution and use in source and binary forms, with or without
    1.13 + * modification, are permitted provided that the following conditions
    1.14 + * are met:
    1.15 + *
    1.16 + * 1. Redistributions of source code must retain the above copyright
    1.17 + *    notice, this list of conditions and the following disclaimer. 
    1.18 + *
    1.19 + * 2. Redistributions in binary form must reproduce the above copyright
    1.20 + *    notice, this list of conditions and the following disclaimer in
    1.21 + *    the documentation and/or other materials provided with the
    1.22 + *    distribution.
    1.23 + *
    1.24 + * 3. All advertising materials mentioning features or use of this
    1.25 + *    software must display the following acknowledgment:
    1.26 + *    "This product includes software developed by the OpenSSL Project
    1.27 + *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
    1.28 + *
    1.29 + * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
    1.30 + *    endorse or promote products derived from this software without
    1.31 + *    prior written permission. For written permission, please contact
    1.32 + *    licensing@OpenSSL.org.
    1.33 + *
    1.34 + * 5. Products derived from this software may not be called "OpenSSL"
    1.35 + *    nor may "OpenSSL" appear in their names without prior written
    1.36 + *    permission of the OpenSSL Project.
    1.37 + *
    1.38 + * 6. Redistributions of any form whatsoever must retain the following
    1.39 + *    acknowledgment:
    1.40 + *    "This product includes software developed by the OpenSSL Project
    1.41 + *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
    1.42 + *
    1.43 + * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
    1.44 + * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    1.45 + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    1.46 + * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
    1.47 + * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    1.48 + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
    1.49 + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
    1.50 + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    1.51 + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
    1.52 + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    1.53 + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
    1.54 + * OF THE POSSIBILITY OF SUCH DAMAGE.
    1.55 + * ====================================================================
    1.56 + *
    1.57 + * This product includes cryptographic software written by Eric Young
    1.58 + * (eay@cryptsoft.com).  This product includes software written by Tim
    1.59 + * Hudson (tjh@cryptsoft.com).
    1.60 + *
    1.61 + */
    1.62 +/* ====================================================================
    1.63 + * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
    1.64 + * ECDH support in OpenSSL originally developed by 
    1.65 + * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
    1.66 + */
    1.67 +
    1.68 +#ifndef HEADER_ENGINE_H
    1.69 +#define HEADER_ENGINE_H
    1.70 +
    1.71 +#if (defined(__SYMBIAN32__) && !defined(SYMBIAN))
    1.72 +#define SYMBIAN
    1.73 +#endif
    1.74 +
    1.75 +#include <openssl/opensslconf.h>
    1.76 +
    1.77 +#ifdef OPENSSL_NO_ENGINE
    1.78 +#error ENGINE is disabled.
    1.79 +#endif
    1.80 +
    1.81 +#ifndef OPENSSL_NO_DEPRECATED
    1.82 +#include <openssl/bn.h>
    1.83 +#ifndef OPENSSL_NO_RSA
    1.84 +#include <openssl/rsa.h>
    1.85 +#endif
    1.86 +#ifndef OPENSSL_NO_DSA
    1.87 +#include <openssl/dsa.h>
    1.88 +#endif
    1.89 +#ifndef OPENSSL_NO_DH
    1.90 +#include <openssl/dh.h>
    1.91 +#endif
    1.92 +#ifndef OPENSSL_NO_ECDH
    1.93 +#include <openssl/ecdh.h>
    1.94 +#endif
    1.95 +#ifndef OPENSSL_NO_ECDSA
    1.96 +#include <openssl/ecdsa.h>
    1.97 +#endif
    1.98 +#include <openssl/rand.h>
    1.99 +#include <openssl/store.h>
   1.100 +#include <openssl/ui.h>
   1.101 +#include <openssl/err.h>
   1.102 +#endif
   1.103 +
   1.104 +#include <openssl/ossl_typ.h>
   1.105 +#include <openssl/symhacks.h>
   1.106 +
   1.107 +#ifdef  __cplusplus
   1.108 +extern "C" {
   1.109 +#endif
   1.110 +
   1.111 +/* These flags are used to control combinations of algorithm (methods)
   1.112 + * by bitwise "OR"ing. */
   1.113 +#define ENGINE_METHOD_RSA		(unsigned int)0x0001
   1.114 +#define ENGINE_METHOD_DSA		(unsigned int)0x0002
   1.115 +#define ENGINE_METHOD_DH		(unsigned int)0x0004
   1.116 +#define ENGINE_METHOD_RAND		(unsigned int)0x0008
   1.117 +#define ENGINE_METHOD_ECDH		(unsigned int)0x0010
   1.118 +#define ENGINE_METHOD_ECDSA		(unsigned int)0x0020
   1.119 +#define ENGINE_METHOD_CIPHERS		(unsigned int)0x0040
   1.120 +#define ENGINE_METHOD_DIGESTS		(unsigned int)0x0080
   1.121 +#define ENGINE_METHOD_STORE		(unsigned int)0x0100
   1.122 +/* Obvious all-or-nothing cases. */
   1.123 +#define ENGINE_METHOD_ALL		(unsigned int)0xFFFF
   1.124 +#define ENGINE_METHOD_NONE		(unsigned int)0x0000
   1.125 +
   1.126 +/* This(ese) flag(s) controls behaviour of the ENGINE_TABLE mechanism used
   1.127 + * internally to control registration of ENGINE implementations, and can be set
   1.128 + * by ENGINE_set_table_flags(). The "NOINIT" flag prevents attempts to
   1.129 + * initialise registered ENGINEs if they are not already initialised. */
   1.130 +#define ENGINE_TABLE_FLAG_NOINIT	(unsigned int)0x0001
   1.131 +
   1.132 +/* ENGINE flags that can be set by ENGINE_set_flags(). */
   1.133 +/* #define ENGINE_FLAGS_MALLOCED	0x0001 */ /* Not used */
   1.134 +
   1.135 +/* This flag is for ENGINEs that wish to handle the various 'CMD'-related
   1.136 + * control commands on their own. Without this flag, ENGINE_ctrl() handles these
   1.137 + * control commands on behalf of the ENGINE using their "cmd_defns" data. */
   1.138 +#define ENGINE_FLAGS_MANUAL_CMD_CTRL	(int)0x0002
   1.139 +
   1.140 +/* This flag is for ENGINEs who return new duplicate structures when found via
   1.141 + * "ENGINE_by_id()". When an ENGINE must store state (eg. if ENGINE_ctrl()
   1.142 + * commands are called in sequence as part of some stateful process like
   1.143 + * key-generation setup and execution), it can set this flag - then each attempt
   1.144 + * to obtain the ENGINE will result in it being copied into a new structure.
   1.145 + * Normally, ENGINEs don't declare this flag so ENGINE_by_id() just increments
   1.146 + * the existing ENGINE's structural reference count. */
   1.147 +#define ENGINE_FLAGS_BY_ID_COPY		(int)0x0004
   1.148 +
   1.149 +/* ENGINEs can support their own command types, and these flags are used in
   1.150 + * ENGINE_CTRL_GET_CMD_FLAGS to indicate to the caller what kind of input each
   1.151 + * command expects. Currently only numeric and string input is supported. If a
   1.152 + * control command supports none of the _NUMERIC, _STRING, or _NO_INPUT options,
   1.153 + * then it is regarded as an "internal" control command - and not for use in
   1.154 + * config setting situations. As such, they're not available to the
   1.155 + * ENGINE_ctrl_cmd_string() function, only raw ENGINE_ctrl() access. Changes to
   1.156 + * this list of 'command types' should be reflected carefully in
   1.157 + * ENGINE_cmd_is_executable() and ENGINE_ctrl_cmd_string(). */
   1.158 +
   1.159 +/* accepts a 'long' input value (3rd parameter to ENGINE_ctrl) */
   1.160 +#define ENGINE_CMD_FLAG_NUMERIC		(unsigned int)0x0001
   1.161 +/* accepts string input (cast from 'void*' to 'const char *', 4th parameter to
   1.162 + * ENGINE_ctrl) */
   1.163 +#define ENGINE_CMD_FLAG_STRING		(unsigned int)0x0002
   1.164 +/* Indicates that the control command takes *no* input. Ie. the control command
   1.165 + * is unparameterised. */
   1.166 +#define ENGINE_CMD_FLAG_NO_INPUT	(unsigned int)0x0004
   1.167 +/* Indicates that the control command is internal. This control command won't
   1.168 + * be shown in any output, and is only usable through the ENGINE_ctrl_cmd()
   1.169 + * function. */
   1.170 +#define ENGINE_CMD_FLAG_INTERNAL	(unsigned int)0x0008
   1.171 +
   1.172 +/* NB: These 3 control commands are deprecated and should not be used. ENGINEs
   1.173 + * relying on these commands should compile conditional support for
   1.174 + * compatibility (eg. if these symbols are defined) but should also migrate the
   1.175 + * same functionality to their own ENGINE-specific control functions that can be
   1.176 + * "discovered" by calling applications. The fact these control commands
   1.177 + * wouldn't be "executable" (ie. usable by text-based config) doesn't change the
   1.178 + * fact that application code can find and use them without requiring per-ENGINE
   1.179 + * hacking. */
   1.180 +
   1.181 +/* These flags are used to tell the ctrl function what should be done.
   1.182 + * All command numbers are shared between all engines, even if some don't
   1.183 + * make sense to some engines.  In such a case, they do nothing but return
   1.184 + * the error ENGINE_R_CTRL_COMMAND_NOT_IMPLEMENTED. */
   1.185 +#define ENGINE_CTRL_SET_LOGSTREAM		1
   1.186 +#define ENGINE_CTRL_SET_PASSWORD_CALLBACK	2
   1.187 +#define ENGINE_CTRL_HUP				3 /* Close and reinitialise any
   1.188 +						     handles/connections etc. */
   1.189 +#define ENGINE_CTRL_SET_USER_INTERFACE          4 /* Alternative to callback */
   1.190 +#define ENGINE_CTRL_SET_CALLBACK_DATA           5 /* User-specific data, used
   1.191 +						     when calling the password
   1.192 +						     callback and the user
   1.193 +						     interface */
   1.194 +#define ENGINE_CTRL_LOAD_CONFIGURATION		6 /* Load a configuration, given
   1.195 +						     a string that represents a
   1.196 +						     file name or so */
   1.197 +#define ENGINE_CTRL_LOAD_SECTION		7 /* Load data from a given
   1.198 +						     section in the already loaded
   1.199 +						     configuration */
   1.200 +
   1.201 +/* These control commands allow an application to deal with an arbitrary engine
   1.202 + * in a dynamic way. Warn: Negative return values indicate errors FOR THESE
   1.203 + * COMMANDS because zero is used to indicate 'end-of-list'. Other commands,
   1.204 + * including ENGINE-specific command types, return zero for an error.
   1.205 + *
   1.206 + * An ENGINE can choose to implement these ctrl functions, and can internally
   1.207 + * manage things however it chooses - it does so by setting the
   1.208 + * ENGINE_FLAGS_MANUAL_CMD_CTRL flag (using ENGINE_set_flags()). Otherwise the
   1.209 + * ENGINE_ctrl() code handles this on the ENGINE's behalf using the cmd_defns
   1.210 + * data (set using ENGINE_set_cmd_defns()). This means an ENGINE's ctrl()
   1.211 + * handler need only implement its own commands - the above "meta" commands will
   1.212 + * be taken care of. */
   1.213 +
   1.214 +/* Returns non-zero if the supplied ENGINE has a ctrl() handler. If "not", then
   1.215 + * all the remaining control commands will return failure, so it is worth
   1.216 + * checking this first if the caller is trying to "discover" the engine's
   1.217 + * capabilities and doesn't want errors generated unnecessarily. */
   1.218 +#define ENGINE_CTRL_HAS_CTRL_FUNCTION		10
   1.219 +/* Returns a positive command number for the first command supported by the
   1.220 + * engine. Returns zero if no ctrl commands are supported. */
   1.221 +#define ENGINE_CTRL_GET_FIRST_CMD_TYPE		11
   1.222 +/* The 'long' argument specifies a command implemented by the engine, and the
   1.223 + * return value is the next command supported, or zero if there are no more. */
   1.224 +#define ENGINE_CTRL_GET_NEXT_CMD_TYPE		12
   1.225 +/* The 'void*' argument is a command name (cast from 'const char *'), and the
   1.226 + * return value is the command that corresponds to it. */
   1.227 +#define ENGINE_CTRL_GET_CMD_FROM_NAME		13
   1.228 +/* The next two allow a command to be converted into its corresponding string
   1.229 + * form. In each case, the 'long' argument supplies the command. In the NAME_LEN
   1.230 + * case, the return value is the length of the command name (not counting a
   1.231 + * trailing EOL). In the NAME case, the 'void*' argument must be a string buffer
   1.232 + * large enough, and it will be populated with the name of the command (WITH a
   1.233 + * trailing EOL). */
   1.234 +#define ENGINE_CTRL_GET_NAME_LEN_FROM_CMD	14
   1.235 +#define ENGINE_CTRL_GET_NAME_FROM_CMD		15
   1.236 +/* The next two are similar but give a "short description" of a command. */
   1.237 +#define ENGINE_CTRL_GET_DESC_LEN_FROM_CMD	16
   1.238 +#define ENGINE_CTRL_GET_DESC_FROM_CMD		17
   1.239 +/* With this command, the return value is the OR'd combination of
   1.240 + * ENGINE_CMD_FLAG_*** values that indicate what kind of input a given
   1.241 + * engine-specific ctrl command expects. */
   1.242 +#define ENGINE_CTRL_GET_CMD_FLAGS		18
   1.243 +
   1.244 +/* ENGINE implementations should start the numbering of their own control
   1.245 + * commands from this value. (ie. ENGINE_CMD_BASE, ENGINE_CMD_BASE + 1, etc). */
   1.246 +#define ENGINE_CMD_BASE				200
   1.247 +
   1.248 +/* NB: These 2 nCipher "chil" control commands are deprecated, and their
   1.249 + * functionality is now available through ENGINE-specific control commands
   1.250 + * (exposed through the above-mentioned 'CMD'-handling). Code using these 2
   1.251 + * commands should be migrated to the more general command handling before these
   1.252 + * are removed. */
   1.253 +
   1.254 +/* Flags specific to the nCipher "chil" engine */
   1.255 +#define ENGINE_CTRL_CHIL_SET_FORKCHECK		100
   1.256 +	/* Depending on the value of the (long)i argument, this sets or
   1.257 +	 * unsets the SimpleForkCheck flag in the CHIL API to enable or
   1.258 +	 * disable checking and workarounds for applications that fork().
   1.259 +	 */
   1.260 +#define ENGINE_CTRL_CHIL_NO_LOCKING		101
   1.261 +	/* This prevents the initialisation function from providing mutex
   1.262 +	 * callbacks to the nCipher library. */
   1.263 +
   1.264 +/* If an ENGINE supports its own specific control commands and wishes the
   1.265 + * framework to handle the above 'ENGINE_CMD_***'-manipulation commands on its
   1.266 + * behalf, it should supply a null-terminated array of ENGINE_CMD_DEFN entries
   1.267 + * to ENGINE_set_cmd_defns(). It should also implement a ctrl() handler that
   1.268 + * supports the stated commands (ie. the "cmd_num" entries as described by the
   1.269 + * array). NB: The array must be ordered in increasing order of cmd_num.
   1.270 + * "null-terminated" means that the last ENGINE_CMD_DEFN element has cmd_num set
   1.271 + * to zero and/or cmd_name set to NULL. */
   1.272 +typedef struct ENGINE_CMD_DEFN_st
   1.273 +	{
   1.274 +	unsigned int cmd_num; /* The command number */
   1.275 +	const char *cmd_name; /* The command name itself */
   1.276 +	const char *cmd_desc; /* A short description of the command */
   1.277 +	unsigned int cmd_flags; /* The input the command expects */
   1.278 +	} ENGINE_CMD_DEFN;
   1.279 +
   1.280 +/* Generic function pointer */
   1.281 +typedef int (*ENGINE_GEN_FUNC_PTR)(void);
   1.282 +/* Generic function pointer taking no arguments */
   1.283 +typedef int (*ENGINE_GEN_INT_FUNC_PTR)(ENGINE *);
   1.284 +/* Specific control function pointer */
   1.285 +typedef int (*ENGINE_CTRL_FUNC_PTR)(ENGINE *, int, long, void *, void (*f)(void));
   1.286 +/* Generic load_key function pointer */
   1.287 +typedef EVP_PKEY * (*ENGINE_LOAD_KEY_PTR)(ENGINE *, const char *,
   1.288 +	UI_METHOD *ui_method, void *callback_data);
   1.289 +/* These callback types are for an ENGINE's handler for cipher and digest logic.
   1.290 + * These handlers have these prototypes;
   1.291 + *   int foo(ENGINE *e, const EVP_CIPHER **cipher, const int **nids, int nid);
   1.292 + *   int foo(ENGINE *e, const EVP_MD **digest, const int **nids, int nid);
   1.293 + * Looking at how to implement these handlers in the case of cipher support, if
   1.294 + * the framework wants the EVP_CIPHER for 'nid', it will call;
   1.295 + *   foo(e, &p_evp_cipher, NULL, nid);    (return zero for failure)
   1.296 + * If the framework wants a list of supported 'nid's, it will call;
   1.297 + *   foo(e, NULL, &p_nids, 0); (returns number of 'nids' or -1 for error)
   1.298 + */
   1.299 +/* Returns to a pointer to the array of supported cipher 'nid's. If the second
   1.300 + * parameter is non-NULL it is set to the size of the returned array. */
   1.301 +typedef int (*ENGINE_CIPHERS_PTR)(ENGINE *, const EVP_CIPHER **, const int **, int);
   1.302 +typedef int (*ENGINE_DIGESTS_PTR)(ENGINE *, const EVP_MD **, const int **, int);
   1.303 +
   1.304 +/* STRUCTURE functions ... all of these functions deal with pointers to ENGINE
   1.305 + * structures where the pointers have a "structural reference". This means that
   1.306 + * their reference is to allowed access to the structure but it does not imply
   1.307 + * that the structure is functional. To simply increment or decrement the
   1.308 + * structural reference count, use ENGINE_by_id and ENGINE_free. NB: This is not
   1.309 + * required when iterating using ENGINE_get_next as it will automatically
   1.310 + * decrement the structural reference count of the "current" ENGINE and
   1.311 + * increment the structural reference count of the ENGINE it returns (unless it
   1.312 + * is NULL). */
   1.313 +
   1.314 +/* Get the first/last "ENGINE" type available. */
   1.315 +IMPORT_C ENGINE *ENGINE_get_first(void);
   1.316 +IMPORT_C ENGINE *ENGINE_get_last(void);
   1.317 +/* Iterate to the next/previous "ENGINE" type (NULL = end of the list). */
   1.318 +IMPORT_C ENGINE *ENGINE_get_next(ENGINE *e);
   1.319 +IMPORT_C ENGINE *ENGINE_get_prev(ENGINE *e);
   1.320 +/* Add another "ENGINE" type into the array. */
   1.321 +IMPORT_C int ENGINE_add(ENGINE *e);
   1.322 +/* Remove an existing "ENGINE" type from the array. */
   1.323 +IMPORT_C int ENGINE_remove(ENGINE *e);
   1.324 +/* Retrieve an engine from the list by its unique "id" value. */
   1.325 +IMPORT_C ENGINE *ENGINE_by_id(const char *id);
   1.326 +/* Add all the built-in engines. */
   1.327 +IMPORT_C void ENGINE_load_openssl(void);
   1.328 +IMPORT_C void ENGINE_load_dynamic(void);
   1.329 +#ifndef OPENSSL_NO_STATIC_ENGINE
   1.330 +#ifndef OPENSSL_NO_GMP
   1.331 +void ENGINE_load_gmp(void);
   1.332 +#endif
   1.333 +#endif
   1.334 +IMPORT_C void ENGINE_load_cryptodev(void);
   1.335 +IMPORT_C void ENGINE_load_builtin_engines(void);
   1.336 +
   1.337 +/* Get and set global flags (ENGINE_TABLE_FLAG_***) for the implementation
   1.338 + * "registry" handling. */
   1.339 +IMPORT_C unsigned int ENGINE_get_table_flags(void);
   1.340 +IMPORT_C void ENGINE_set_table_flags(unsigned int flags);
   1.341 +
   1.342 +/* Manage registration of ENGINEs per "table". For each type, there are 3
   1.343 + * functions;
   1.344 + *   ENGINE_register_***(e) - registers the implementation from 'e' (if it has one)
   1.345 + *   ENGINE_unregister_***(e) - unregister the implementation from 'e'
   1.346 + *   ENGINE_register_all_***() - call ENGINE_register_***() for each 'e' in the list
   1.347 + * Cleanup is automatically registered from each table when required, so
   1.348 + * ENGINE_cleanup() will reverse any "register" operations. */
   1.349 +
   1.350 +IMPORT_C int ENGINE_register_RSA(ENGINE *e);
   1.351 +IMPORT_C void ENGINE_unregister_RSA(ENGINE *e);
   1.352 +IMPORT_C void ENGINE_register_all_RSA(void);
   1.353 +
   1.354 +IMPORT_C int ENGINE_register_DSA(ENGINE *e);
   1.355 +IMPORT_C void ENGINE_unregister_DSA(ENGINE *e);
   1.356 +IMPORT_C void ENGINE_register_all_DSA(void);
   1.357 +
   1.358 +
   1.359 +IMPORT_C int ENGINE_register_DH(ENGINE *e);
   1.360 +IMPORT_C void ENGINE_unregister_DH(ENGINE *e);
   1.361 +IMPORT_C void ENGINE_register_all_DH(void);
   1.362 +
   1.363 +IMPORT_C int ENGINE_register_RAND(ENGINE *e);
   1.364 +IMPORT_C void ENGINE_unregister_RAND(ENGINE *e);
   1.365 +IMPORT_C void ENGINE_register_all_RAND(void);
   1.366 +
   1.367 +IMPORT_C int ENGINE_register_STORE(ENGINE *e);
   1.368 +IMPORT_C void ENGINE_unregister_STORE(ENGINE *e);
   1.369 +IMPORT_C void ENGINE_register_all_STORE(void);
   1.370 +
   1.371 +IMPORT_C int ENGINE_register_ciphers(ENGINE *e);
   1.372 +IMPORT_C void ENGINE_unregister_ciphers(ENGINE *e);
   1.373 +IMPORT_C void ENGINE_register_all_ciphers(void);
   1.374 +
   1.375 +IMPORT_C int ENGINE_register_digests(ENGINE *e);
   1.376 +IMPORT_C void ENGINE_unregister_digests(ENGINE *e);
   1.377 +IMPORT_C void ENGINE_register_all_digests(void);
   1.378 +
   1.379 +/* These functions register all support from the above categories. Note, use of
   1.380 + * these functions can result in static linkage of code your application may not
   1.381 + * need. If you only need a subset of functionality, consider using more
   1.382 + * selective initialisation. */
   1.383 +IMPORT_C int ENGINE_register_complete(ENGINE *e);
   1.384 +IMPORT_C int ENGINE_register_all_complete(void);
   1.385 +
   1.386 +/* Send parametrised control commands to the engine. The possibilities to send
   1.387 + * down an integer, a pointer to data or a function pointer are provided. Any of
   1.388 + * the parameters may or may not be NULL, depending on the command number. In
   1.389 + * actuality, this function only requires a structural (rather than functional)
   1.390 + * reference to an engine, but many control commands may require the engine be
   1.391 + * functional. The caller should be aware of trying commands that require an
   1.392 + * operational ENGINE, and only use functional references in such situations. */
   1.393 +IMPORT_C int ENGINE_ctrl(ENGINE *e, int cmd, long i, void *p, void (*f)(void));
   1.394 +
   1.395 +/* This function tests if an ENGINE-specific command is usable as a "setting".
   1.396 + * Eg. in an application's config file that gets processed through
   1.397 + * ENGINE_ctrl_cmd_string(). If this returns zero, it is not available to
   1.398 + * ENGINE_ctrl_cmd_string(), only ENGINE_ctrl(). */
   1.399 +IMPORT_C int ENGINE_cmd_is_executable(ENGINE *e, int cmd);
   1.400 +
   1.401 +/* This function works like ENGINE_ctrl() with the exception of taking a
   1.402 + * command name instead of a command number, and can handle optional commands.
   1.403 + * See the comment on ENGINE_ctrl_cmd_string() for an explanation on how to
   1.404 + * use the cmd_name and cmd_optional. */
   1.405 +IMPORT_C int ENGINE_ctrl_cmd(ENGINE *e, const char *cmd_name,
   1.406 +        long i, void *p, void (*f)(void), int cmd_optional);
   1.407 +
   1.408 +/* This function passes a command-name and argument to an ENGINE. The cmd_name
   1.409 + * is converted to a command number and the control command is called using
   1.410 + * 'arg' as an argument (unless the ENGINE doesn't support such a command, in
   1.411 + * which case no control command is called). The command is checked for input
   1.412 + * flags, and if necessary the argument will be converted to a numeric value. If
   1.413 + * cmd_optional is non-zero, then if the ENGINE doesn't support the given
   1.414 + * cmd_name the return value will be success anyway. This function is intended
   1.415 + * for applications to use so that users (or config files) can supply
   1.416 + * engine-specific config data to the ENGINE at run-time to control behaviour of
   1.417 + * specific engines. As such, it shouldn't be used for calling ENGINE_ctrl()
   1.418 + * functions that return data, deal with binary data, or that are otherwise
   1.419 + * supposed to be used directly through ENGINE_ctrl() in application code. Any
   1.420 + * "return" data from an ENGINE_ctrl() operation in this function will be lost -
   1.421 + * the return value is interpreted as failure if the return value is zero,
   1.422 + * success otherwise, and this function returns a boolean value as a result. In
   1.423 + * other words, vendors of 'ENGINE'-enabled devices should write ENGINE
   1.424 + * implementations with parameterisations that work in this scheme, so that
   1.425 + * compliant ENGINE-based applications can work consistently with the same
   1.426 + * configuration for the same ENGINE-enabled devices, across applications. */
   1.427 +IMPORT_C int ENGINE_ctrl_cmd_string(ENGINE *e, const char *cmd_name, const char *arg,
   1.428 +				int cmd_optional);
   1.429 +
   1.430 +/* These functions are useful for manufacturing new ENGINE structures. They
   1.431 + * don't address reference counting at all - one uses them to populate an ENGINE
   1.432 + * structure with personalised implementations of things prior to using it
   1.433 + * directly or adding it to the builtin ENGINE list in OpenSSL. These are also
   1.434 + * here so that the ENGINE structure doesn't have to be exposed and break binary
   1.435 + * compatibility! */
   1.436 +IMPORT_C ENGINE *ENGINE_new(void);
   1.437 +IMPORT_C int ENGINE_free(ENGINE *e);
   1.438 +IMPORT_C int ENGINE_up_ref(ENGINE *e);
   1.439 +IMPORT_C int ENGINE_set_id(ENGINE *e, const char *id);
   1.440 +IMPORT_C int ENGINE_set_name(ENGINE *e, const char *name);
   1.441 +IMPORT_C int ENGINE_set_RSA(ENGINE *e, const RSA_METHOD *rsa_meth);
   1.442 +IMPORT_C int ENGINE_set_DSA(ENGINE *e, const DSA_METHOD *dsa_meth);
   1.443 +IMPORT_C int ENGINE_set_DH(ENGINE *e, const DH_METHOD *dh_meth);
   1.444 +IMPORT_C int ENGINE_set_RAND(ENGINE *e, const RAND_METHOD *rand_meth);
   1.445 +IMPORT_C int ENGINE_set_STORE(ENGINE *e, const STORE_METHOD *store_meth);
   1.446 +IMPORT_C int ENGINE_set_destroy_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR destroy_f);
   1.447 +IMPORT_C int ENGINE_set_init_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR init_f);
   1.448 +IMPORT_C int ENGINE_set_finish_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR finish_f);
   1.449 +IMPORT_C int ENGINE_set_ctrl_function(ENGINE *e, ENGINE_CTRL_FUNC_PTR ctrl_f);
   1.450 +IMPORT_C int ENGINE_set_load_privkey_function(ENGINE *e, ENGINE_LOAD_KEY_PTR loadpriv_f);
   1.451 +IMPORT_C int ENGINE_set_load_pubkey_function(ENGINE *e, ENGINE_LOAD_KEY_PTR loadpub_f);
   1.452 +IMPORT_C int ENGINE_set_ciphers(ENGINE *e, ENGINE_CIPHERS_PTR f);
   1.453 +IMPORT_C int ENGINE_set_digests(ENGINE *e, ENGINE_DIGESTS_PTR f);
   1.454 +IMPORT_C int ENGINE_set_flags(ENGINE *e, int flags);
   1.455 +IMPORT_C int ENGINE_set_cmd_defns(ENGINE *e, const ENGINE_CMD_DEFN *defns);
   1.456 +/* These functions allow control over any per-structure ENGINE data. */
   1.457 +IMPORT_C int ENGINE_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
   1.458 +		CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
   1.459 +IMPORT_C int ENGINE_set_ex_data(ENGINE *e, int idx, void *arg);
   1.460 +IMPORT_C void *ENGINE_get_ex_data(const ENGINE *e, int idx);
   1.461 +
   1.462 +/* This function cleans up anything that needs it. Eg. the ENGINE_add() function
   1.463 + * automatically ensures the list cleanup function is registered to be called
   1.464 + * from ENGINE_cleanup(). Similarly, all ENGINE_register_*** functions ensure
   1.465 + * ENGINE_cleanup() will clean up after them. */
   1.466 +IMPORT_C void ENGINE_cleanup(void);
   1.467 +
   1.468 +/* These return values from within the ENGINE structure. These can be useful
   1.469 + * with functional references as well as structural references - it depends
   1.470 + * which you obtained. Using the result for functional purposes if you only
   1.471 + * obtained a structural reference may be problematic! */
   1.472 +IMPORT_C const char *ENGINE_get_id(const ENGINE *e);
   1.473 +IMPORT_C const char *ENGINE_get_name(const ENGINE *e);
   1.474 +IMPORT_C const RSA_METHOD *ENGINE_get_RSA(const ENGINE *e);
   1.475 +IMPORT_C const DSA_METHOD *ENGINE_get_DSA(const ENGINE *e);
   1.476 +IMPORT_C const DH_METHOD *ENGINE_get_DH(const ENGINE *e);
   1.477 +IMPORT_C const RAND_METHOD *ENGINE_get_RAND(const ENGINE *e);
   1.478 +IMPORT_C const STORE_METHOD *ENGINE_get_STORE(const ENGINE *e);
   1.479 +IMPORT_C ENGINE_GEN_INT_FUNC_PTR ENGINE_get_destroy_function(const ENGINE *e);
   1.480 +IMPORT_C ENGINE_GEN_INT_FUNC_PTR ENGINE_get_init_function(const ENGINE *e);
   1.481 +IMPORT_C ENGINE_GEN_INT_FUNC_PTR ENGINE_get_finish_function(const ENGINE *e);
   1.482 +IMPORT_C ENGINE_CTRL_FUNC_PTR ENGINE_get_ctrl_function(const ENGINE *e);
   1.483 +IMPORT_C ENGINE_LOAD_KEY_PTR ENGINE_get_load_privkey_function(const ENGINE *e);
   1.484 +IMPORT_C ENGINE_LOAD_KEY_PTR ENGINE_get_load_pubkey_function(const ENGINE *e);
   1.485 +IMPORT_C ENGINE_CIPHERS_PTR ENGINE_get_ciphers(const ENGINE *e);
   1.486 +IMPORT_C ENGINE_DIGESTS_PTR ENGINE_get_digests(const ENGINE *e);
   1.487 +IMPORT_C const EVP_CIPHER *ENGINE_get_cipher(ENGINE *e, int nid);
   1.488 +IMPORT_C const EVP_MD *ENGINE_get_digest(ENGINE *e, int nid);
   1.489 +IMPORT_C const ENGINE_CMD_DEFN *ENGINE_get_cmd_defns(const ENGINE *e);
   1.490 +IMPORT_C int ENGINE_get_flags(const ENGINE *e);
   1.491 +
   1.492 +/* FUNCTIONAL functions. These functions deal with ENGINE structures
   1.493 + * that have (or will) be initialised for use. Broadly speaking, the
   1.494 + * structural functions are useful for iterating the list of available
   1.495 + * engine types, creating new engine types, and other "list" operations.
   1.496 + * These functions actually deal with ENGINEs that are to be used. As
   1.497 + * such these functions can fail (if applicable) when particular
   1.498 + * engines are unavailable - eg. if a hardware accelerator is not
   1.499 + * attached or not functioning correctly. Each ENGINE has 2 reference
   1.500 + * counts; structural and functional. Every time a functional reference
   1.501 + * is obtained or released, a corresponding structural reference is
   1.502 + * automatically obtained or released too. */
   1.503 +
   1.504 +/* Initialise a engine type for use (or up its reference count if it's
   1.505 + * already in use). This will fail if the engine is not currently
   1.506 + * operational and cannot initialise. */
   1.507 +IMPORT_C int ENGINE_init(ENGINE *e);
   1.508 +/* Free a functional reference to a engine type. This does not require
   1.509 + * a corresponding call to ENGINE_free as it also releases a structural
   1.510 + * reference. */
   1.511 +IMPORT_C int ENGINE_finish(ENGINE *e);
   1.512 +
   1.513 +/* The following functions handle keys that are stored in some secondary
   1.514 + * location, handled by the engine.  The storage may be on a card or
   1.515 + * whatever. */
   1.516 +IMPORT_C EVP_PKEY *ENGINE_load_private_key(ENGINE *e, const char *key_id,
   1.517 +	UI_METHOD *ui_method, void *callback_data);
   1.518 +IMPORT_C EVP_PKEY *ENGINE_load_public_key(ENGINE *e, const char *key_id,
   1.519 +	UI_METHOD *ui_method, void *callback_data);
   1.520 +
   1.521 +/* This returns a pointer for the current ENGINE structure that
   1.522 + * is (by default) performing any RSA operations. The value returned
   1.523 + * is an incremented reference, so it should be free'd (ENGINE_finish)
   1.524 + * before it is discarded. */
   1.525 +IMPORT_C ENGINE *ENGINE_get_default_RSA(void);
   1.526 +/* Same for the other "methods" */
   1.527 +IMPORT_C ENGINE *ENGINE_get_default_DSA(void);
   1.528 +IMPORT_C ENGINE *ENGINE_get_default_DH(void);
   1.529 +IMPORT_C ENGINE *ENGINE_get_default_RAND(void);
   1.530 +/* These functions can be used to get a functional reference to perform
   1.531 + * ciphering or digesting corresponding to "nid". */
   1.532 +IMPORT_C ENGINE *ENGINE_get_cipher_engine(int nid);
   1.533 +IMPORT_C ENGINE *ENGINE_get_digest_engine(int nid);
   1.534 +
   1.535 +/* This sets a new default ENGINE structure for performing RSA
   1.536 + * operations. If the result is non-zero (success) then the ENGINE
   1.537 + * structure will have had its reference count up'd so the caller
   1.538 + * should still free their own reference 'e'. */
   1.539 +IMPORT_C int ENGINE_set_default_RSA(ENGINE *e);
   1.540 +IMPORT_C int ENGINE_set_default_string(ENGINE *e, const char *def_list);
   1.541 +/* Same for the other "methods" */
   1.542 +IMPORT_C int ENGINE_set_default_DSA(ENGINE *e);
   1.543 +int ENGINE_set_default_ECDH(ENGINE *e);
   1.544 +int ENGINE_set_default_ECDSA(ENGINE *e);
   1.545 +IMPORT_C int ENGINE_set_default_DH(ENGINE *e);
   1.546 +IMPORT_C int ENGINE_set_default_RAND(ENGINE *e);
   1.547 +IMPORT_C int ENGINE_set_default_ciphers(ENGINE *e);
   1.548 +IMPORT_C int ENGINE_set_default_digests(ENGINE *e);
   1.549 +
   1.550 +/* The combination "set" - the flags are bitwise "OR"d from the
   1.551 + * ENGINE_METHOD_*** defines above. As with the "ENGINE_register_complete()"
   1.552 + * function, this function can result in unnecessary static linkage. If your
   1.553 + * application requires only specific functionality, consider using more
   1.554 + * selective functions. */
   1.555 +IMPORT_C int ENGINE_set_default(ENGINE *e, unsigned int flags);
   1.556 +
   1.557 +IMPORT_C void ENGINE_add_conf_module(void);
   1.558 +
   1.559 +/* Deprecated functions ... */
   1.560 +/* int ENGINE_clear_defaults(void); */
   1.561 +
   1.562 +/**************************/
   1.563 +/* DYNAMIC ENGINE SUPPORT */
   1.564 +/**************************/
   1.565 +
   1.566 +/* Binary/behaviour compatibility levels */
   1.567 +#define OSSL_DYNAMIC_VERSION		(unsigned long)0x00020000
   1.568 +/* Binary versions older than this are too old for us (whether we're a loader or
   1.569 + * a loadee) */
   1.570 +#define OSSL_DYNAMIC_OLDEST		(unsigned long)0x00020000
   1.571 +
   1.572 +/* When compiling an ENGINE entirely as an external shared library, loadable by
   1.573 + * the "dynamic" ENGINE, these types are needed. The 'dynamic_fns' structure
   1.574 + * type provides the calling application's (or library's) error functionality
   1.575 + * and memory management function pointers to the loaded library. These should
   1.576 + * be used/set in the loaded library code so that the loading application's
   1.577 + * 'state' will be used/changed in all operations. The 'static_state' pointer
   1.578 + * allows the loaded library to know if it shares the same static data as the
   1.579 + * calling application (or library), and thus whether these callbacks need to be
   1.580 + * set or not. */
   1.581 +typedef void *(*dyn_MEM_malloc_cb)(size_t);
   1.582 +typedef void *(*dyn_MEM_realloc_cb)(void *, size_t);
   1.583 +typedef void (*dyn_MEM_free_cb)(void *);
   1.584 +typedef struct st_dynamic_MEM_fns {
   1.585 +	dyn_MEM_malloc_cb			malloc_cb;
   1.586 +	dyn_MEM_realloc_cb			realloc_cb;
   1.587 +	dyn_MEM_free_cb				free_cb;
   1.588 +	} dynamic_MEM_fns;
   1.589 +/* FIXME: Perhaps the memory and locking code (crypto.h) should declare and use
   1.590 + * these types so we (and any other dependant code) can simplify a bit?? */
   1.591 +typedef void (*dyn_lock_locking_cb)(int,int,const char *,int);
   1.592 +typedef int (*dyn_lock_add_lock_cb)(int*,int,int,const char *,int);
   1.593 +typedef struct CRYPTO_dynlock_value *(*dyn_dynlock_create_cb)(
   1.594 +						const char *,int);
   1.595 +typedef void (*dyn_dynlock_lock_cb)(int,struct CRYPTO_dynlock_value *,
   1.596 +						const char *,int);
   1.597 +typedef void (*dyn_dynlock_destroy_cb)(struct CRYPTO_dynlock_value *,
   1.598 +						const char *,int);
   1.599 +typedef struct st_dynamic_LOCK_fns {
   1.600 +	dyn_lock_locking_cb			lock_locking_cb;
   1.601 +	dyn_lock_add_lock_cb			lock_add_lock_cb;
   1.602 +	dyn_dynlock_create_cb			dynlock_create_cb;
   1.603 +	dyn_dynlock_lock_cb			dynlock_lock_cb;
   1.604 +	dyn_dynlock_destroy_cb			dynlock_destroy_cb;
   1.605 +	} dynamic_LOCK_fns;
   1.606 +/* The top-level structure */
   1.607 +typedef struct st_dynamic_fns {
   1.608 +	void 					*static_state;
   1.609 +	const ERR_FNS				*err_fns;
   1.610 +	const CRYPTO_EX_DATA_IMPL		*ex_data_fns;
   1.611 +	dynamic_MEM_fns				mem_fns;
   1.612 +	dynamic_LOCK_fns			lock_fns;
   1.613 +	} dynamic_fns;
   1.614 +
   1.615 +/* The version checking function should be of this prototype. NB: The
   1.616 + * ossl_version value passed in is the OSSL_DYNAMIC_VERSION of the loading code.
   1.617 + * If this function returns zero, it indicates a (potential) version
   1.618 + * incompatibility and the loaded library doesn't believe it can proceed.
   1.619 + * Otherwise, the returned value is the (latest) version supported by the
   1.620 + * loading library. The loader may still decide that the loaded code's version
   1.621 + * is unsatisfactory and could veto the load. The function is expected to
   1.622 + * be implemented with the symbol name "v_check", and a default implementation
   1.623 + * can be fully instantiated with IMPLEMENT_DYNAMIC_CHECK_FN(). */
   1.624 +typedef unsigned long (*dynamic_v_check_fn)(unsigned long ossl_version);
   1.625 +#define IMPLEMENT_DYNAMIC_CHECK_FN() \
   1.626 +	unsigned long v_check(unsigned long v) { \
   1.627 +		if(v >= OSSL_DYNAMIC_OLDEST) return OSSL_DYNAMIC_VERSION; \
   1.628 +		return 0; }
   1.629 +
   1.630 +/* This function is passed the ENGINE structure to initialise with its own
   1.631 + * function and command settings. It should not adjust the structural or
   1.632 + * functional reference counts. If this function returns zero, (a) the load will
   1.633 + * be aborted, (b) the previous ENGINE state will be memcpy'd back onto the
   1.634 + * structure, and (c) the shared library will be unloaded. So implementations
   1.635 + * should do their own internal cleanup in failure circumstances otherwise they
   1.636 + * could leak. The 'id' parameter, if non-NULL, represents the ENGINE id that
   1.637 + * the loader is looking for. If this is NULL, the shared library can choose to
   1.638 + * return failure or to initialise a 'default' ENGINE. If non-NULL, the shared
   1.639 + * library must initialise only an ENGINE matching the passed 'id'. The function
   1.640 + * is expected to be implemented with the symbol name "bind_engine". A standard
   1.641 + * implementation can be instantiated with IMPLEMENT_DYNAMIC_BIND_FN(fn) where
   1.642 + * the parameter 'fn' is a callback function that populates the ENGINE structure
   1.643 + * and returns an int value (zero for failure). 'fn' should have prototype;
   1.644 + *    [static] int fn(ENGINE *e, const char *id); */
   1.645 +typedef int (*dynamic_bind_engine)(ENGINE *e, const char *id,
   1.646 +				const dynamic_fns *fns);
   1.647 +#define IMPLEMENT_DYNAMIC_BIND_FN(fn) \
   1.648 +	int bind_engine(ENGINE *e, const char *id, const dynamic_fns *fns) { \
   1.649 +		if(ENGINE_get_static_state() == fns->static_state) goto skip_cbs; \
   1.650 +		if(!CRYPTO_set_mem_functions(fns->mem_fns.malloc_cb, \
   1.651 +			fns->mem_fns.realloc_cb, fns->mem_fns.free_cb)) \
   1.652 +			return 0; \
   1.653 +		CRYPTO_set_locking_callback(fns->lock_fns.lock_locking_cb); \
   1.654 +		CRYPTO_set_add_lock_callback(fns->lock_fns.lock_add_lock_cb); \
   1.655 +		CRYPTO_set_dynlock_create_callback(fns->lock_fns.dynlock_create_cb); \
   1.656 +		CRYPTO_set_dynlock_lock_callback(fns->lock_fns.dynlock_lock_cb); \
   1.657 +		CRYPTO_set_dynlock_destroy_callback(fns->lock_fns.dynlock_destroy_cb); \
   1.658 +		if(!CRYPTO_set_ex_data_implementation(fns->ex_data_fns)) \
   1.659 +			return 0; \
   1.660 +		if(!ERR_set_implementation(fns->err_fns)) return 0; \
   1.661 +	skip_cbs: \
   1.662 +		if(!fn(e,id)) return 0; \
   1.663 +		return 1; }
   1.664 +
   1.665 +/* If the loading application (or library) and the loaded ENGINE library share
   1.666 + * the same static data (eg. they're both dynamically linked to the same
   1.667 + * libcrypto.so) we need a way to avoid trying to set system callbacks - this
   1.668 + * would fail, and for the same reason that it's unnecessary to try. If the
   1.669 + * loaded ENGINE has (or gets from through the loader) its own copy of the
   1.670 + * libcrypto static data, we will need to set the callbacks. The easiest way to
   1.671 + * detect this is to have a function that returns a pointer to some static data
   1.672 + * and let the loading application and loaded ENGINE compare their respective
   1.673 + * values. */
   1.674 +IMPORT_C void *ENGINE_get_static_state(void);
   1.675 +
   1.676 +
   1.677 +/* BEGIN ERROR CODES */
   1.678 +/* The following lines are auto generated by the script mkerr.pl. Any changes
   1.679 + * made after this point may be overwritten when the script is next run.
   1.680 + */
   1.681 +IMPORT_C void ERR_load_ENGINE_strings(void);
   1.682 +
   1.683 +/* Error codes for the ENGINE functions. */
   1.684 +
   1.685 +/* Function codes. */
   1.686 +#define ENGINE_F_DYNAMIC_CTRL				 180
   1.687 +#define ENGINE_F_DYNAMIC_GET_DATA_CTX			 181
   1.688 +#define ENGINE_F_DYNAMIC_LOAD				 182
   1.689 +#define ENGINE_F_DYNAMIC_SET_DATA_CTX			 183
   1.690 +#define ENGINE_F_ENGINE_ADD				 105
   1.691 +#define ENGINE_F_ENGINE_BY_ID				 106
   1.692 +#define ENGINE_F_ENGINE_CMD_IS_EXECUTABLE		 170
   1.693 +#define ENGINE_F_ENGINE_CTRL				 142
   1.694 +#define ENGINE_F_ENGINE_CTRL_CMD			 178
   1.695 +#define ENGINE_F_ENGINE_CTRL_CMD_STRING			 171
   1.696 +#define ENGINE_F_ENGINE_FINISH				 107
   1.697 +#define ENGINE_F_ENGINE_FREE_UTIL			 108
   1.698 +#define ENGINE_F_ENGINE_GET_CIPHER			 185
   1.699 +#define ENGINE_F_ENGINE_GET_DEFAULT_TYPE		 177
   1.700 +#define ENGINE_F_ENGINE_GET_DIGEST			 186
   1.701 +#define ENGINE_F_ENGINE_GET_NEXT			 115
   1.702 +#define ENGINE_F_ENGINE_GET_PREV			 116
   1.703 +#define ENGINE_F_ENGINE_INIT				 119
   1.704 +#define ENGINE_F_ENGINE_LIST_ADD			 120
   1.705 +#define ENGINE_F_ENGINE_LIST_REMOVE			 121
   1.706 +#define ENGINE_F_ENGINE_LOAD_PRIVATE_KEY		 150
   1.707 +#define ENGINE_F_ENGINE_LOAD_PUBLIC_KEY			 151
   1.708 +#define ENGINE_F_ENGINE_NEW				 122
   1.709 +#define ENGINE_F_ENGINE_REMOVE				 123
   1.710 +#define ENGINE_F_ENGINE_SET_DEFAULT_STRING		 189
   1.711 +#define ENGINE_F_ENGINE_SET_DEFAULT_TYPE		 126
   1.712 +#define ENGINE_F_ENGINE_SET_ID				 129
   1.713 +#define ENGINE_F_ENGINE_SET_NAME			 130
   1.714 +#define ENGINE_F_ENGINE_TABLE_REGISTER			 184
   1.715 +#define ENGINE_F_ENGINE_UNLOAD_KEY			 152
   1.716 +#define ENGINE_F_ENGINE_UNLOCKED_FINISH			 191
   1.717 +#define ENGINE_F_ENGINE_UP_REF				 190
   1.718 +#define ENGINE_F_INT_CTRL_HELPER			 172
   1.719 +#define ENGINE_F_INT_ENGINE_CONFIGURE			 188
   1.720 +#define ENGINE_F_INT_ENGINE_MODULE_INIT			 187
   1.721 +#define ENGINE_F_LOG_MESSAGE				 141
   1.722 +
   1.723 +/* Reason codes. */
   1.724 +#define ENGINE_R_ALREADY_LOADED				 100
   1.725 +#define ENGINE_R_ARGUMENT_IS_NOT_A_NUMBER		 133
   1.726 +#define ENGINE_R_CMD_NOT_EXECUTABLE			 134
   1.727 +#define ENGINE_R_COMMAND_TAKES_INPUT			 135
   1.728 +#define ENGINE_R_COMMAND_TAKES_NO_INPUT			 136
   1.729 +#define ENGINE_R_CONFLICTING_ENGINE_ID			 103
   1.730 +#define ENGINE_R_CTRL_COMMAND_NOT_IMPLEMENTED		 119
   1.731 +#define ENGINE_R_DH_NOT_IMPLEMENTED			 139
   1.732 +#define ENGINE_R_DSA_NOT_IMPLEMENTED			 140
   1.733 +#define ENGINE_R_DSO_FAILURE				 104
   1.734 +#define ENGINE_R_DSO_NOT_FOUND				 132
   1.735 +#define ENGINE_R_ENGINES_SECTION_ERROR			 148
   1.736 +#define ENGINE_R_ENGINE_IS_NOT_IN_LIST			 105
   1.737 +#define ENGINE_R_ENGINE_SECTION_ERROR			 149
   1.738 +#define ENGINE_R_FAILED_LOADING_PRIVATE_KEY		 128
   1.739 +#define ENGINE_R_FAILED_LOADING_PUBLIC_KEY		 129
   1.740 +#define ENGINE_R_FINISH_FAILED				 106
   1.741 +#define ENGINE_R_GET_HANDLE_FAILED			 107
   1.742 +#define ENGINE_R_ID_OR_NAME_MISSING			 108
   1.743 +#define ENGINE_R_INIT_FAILED				 109
   1.744 +#define ENGINE_R_INTERNAL_LIST_ERROR			 110
   1.745 +#define ENGINE_R_INVALID_ARGUMENT			 143
   1.746 +#define ENGINE_R_INVALID_CMD_NAME			 137
   1.747 +#define ENGINE_R_INVALID_CMD_NUMBER			 138
   1.748 +#define ENGINE_R_INVALID_INIT_VALUE			 151
   1.749 +#define ENGINE_R_INVALID_STRING				 150
   1.750 +#define ENGINE_R_NOT_INITIALISED			 117
   1.751 +#define ENGINE_R_NOT_LOADED				 112
   1.752 +#define ENGINE_R_NO_CONTROL_FUNCTION			 120
   1.753 +#define ENGINE_R_NO_INDEX				 144
   1.754 +#define ENGINE_R_NO_LOAD_FUNCTION			 125
   1.755 +#define ENGINE_R_NO_REFERENCE				 130
   1.756 +#define ENGINE_R_NO_SUCH_ENGINE				 116
   1.757 +#define ENGINE_R_NO_UNLOAD_FUNCTION			 126
   1.758 +#define ENGINE_R_PROVIDE_PARAMETERS			 113
   1.759 +#define ENGINE_R_RSA_NOT_IMPLEMENTED			 141
   1.760 +#define ENGINE_R_UNIMPLEMENTED_CIPHER			 146
   1.761 +#define ENGINE_R_UNIMPLEMENTED_DIGEST			 147
   1.762 +#define ENGINE_R_VERSION_INCOMPATIBILITY		 145
   1.763 +
   1.764 +#ifdef  __cplusplus
   1.765 +}
   1.766 +#endif
   1.767 +#endif