NAME
ENGINE_new,
ENGINE_free, ENGINE_init,
ENGINE_finish,
ENGINE_ctrl_cmd,
ENGINE_ctrl_cmd_string,
ENGINE_by_id, ENGINE_get_id,
ENGINE_get_name,
ENGINE_set_default,
ENGINE_get_default_RSA,
ENGINE_set_default_RSA,
ENGINE_load_private_key,
ENGINE_load_public_key,
ENGINE_load_builtin_engines,
ENGINE_load_dynamic,
ENGINE_load_openssl,
ENGINE_register_all_complete,
ENGINE_cleanup —
ENGINE stub functions
SYNOPSIS
#include
<openssl/engine.h>
ENGINE *
ENGINE_new(void);
int
ENGINE_free(ENGINE *engine);
int
ENGINE_init(ENGINE
*engine);
int
ENGINE_finish(ENGINE
*engine);
int
ENGINE_ctrl_cmd(ENGINE *engine,
const char *cmd_name, long i,
void *p, void (*f)(void),
int cmd_optional);
int
ENGINE_ctrl_cmd_string(ENGINE
*engine, const char *cmd_name,
const char *arg, int
cmd_optional);
ENGINE *
ENGINE_by_id(const
char *id);
const char *
ENGINE_get_id(const
ENGINE *engine);
const char *
ENGINE_get_name(const
ENGINE *engine);
int
ENGINE_set_default(ENGINE
*engine, unsigned int
flags);
ENGINE *
ENGINE_get_default_RSA(ENGINE
*engine);
int
ENGINE_set_default_RSA(ENGINE
*engine);
EVP_PKEY *
ENGINE_load_private_key(ENGINE
*engine, const char *key_id,
UI_METHOD *ui_method, void
*callback_data);
EVP_PKEY *
ENGINE_load_public_key(ENGINE
*engine, const char *key_id,
UI_METHOD *ui_method, void
*callback_data);
void
ENGINE_load_builtin_engines(void);
void
ENGINE_load_dynamic(void);
void
ENGINE_load_openssl(void);
int
ENGINE_register_all_complete(void);
void
ENGINE_cleanup(void);
DESCRIPTION
ENGINE objects used to provide alternative implementations of cryptographic algorithms, for example using specialized hardware. LibreSSL no longer supports this feature.
All functions in this manual ignore all their arguments and do nothing except return failure if possible. They are provided only to avoid patching software that expects ENGINE support to be available.
RETURN VALUES
ENGINE_new(),
ENGINE_by_id(),
ENGINE_get_default_RSA(),
ENGINE_load_private_key(), and
ENGINE_load_public_key() always return
NULL.
ENGINE_free(),
ENGINE_init(),
ENGINE_finish(),
ENGINE_ctrl_cmd(),
ENGINE_ctrl_cmd_string(),
ENGINE_set_default(),
ENGINE_set_default_RSA(), and
ENGINE_register_all_complete() always return 0.
ENGINE_get_id() and
ENGINE_get_name() always return the constant empty
string.
SEE ALSO
HISTORY
ENGINE_new(),
ENGINE_free(),
ENGINE_init(),
ENGINE_finish(),
ENGINE_by_id(),
ENGINE_get_id(),
ENGINE_get_name(),
ENGINE_set_default(),
ENGINE_get_default_RSA(),
ENGINE_set_default_RSA(),
ENGINE_load_private_key(), and
ENGINE_load_public_key() first appeared in OpenSSL
0.9.7 and have been available since OpenBSD 2.9.
ENGINE_ctrl_cmd(),
ENGINE_ctrl_cmd_string(),
ENGINE_load_builtin_engines(),
ENGINE_load_openssl(),
ENGINE_register_all_complete(), and
ENGINE_cleanup() first appeared in OpenSSL 0.9.7 and
have been available since OpenBSD 3.4.
All these functions were turned into stubs in OpenBSD 7.4.