ENGINE_NEW(3)

💅 ENGINE_NEW(3) — Library Functions Manual ✨

okay so this is the ENGINE_NEW(3) page from the Library Functions Manual, and it’s giving “the feature is gone but the function names are still here so your old code doesn’t throw a fit” energy. Let’s get into it, bestie. 🫶

🌸 NAME 🌸

The whole squad, exactly as listed: 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 💖

okay so ENGINE objects used to provide alternative implementations of cryptographic algorithms — like, say, using specialized hardware. But bestie, plot twist: 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. That’s the whole bit. No cap. 🫶

🎀 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 🦋

• crypto(3) — go read that one, bestie. 🌸

👑 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. 💅

💖 source/version: Debian · date: November 19, 2023 · later, bestie! 🫶