[#ENGINE_new]
= ENGINE_new
:mrdocs:

Allocate a new empty ENGINE with a structural reference count of one.

== Synopsis

Declared in `<openssl/engine.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
xref:ENGINE.adoc[ENGINE]*
ENGINE_new();
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]. Use of this entity is allowed but discouraged.
====
== Description

Does not initialise the ENGINE for functional use; call ENGINE_init() after populating methods, or ENGINE_add() to insert it into the global list.

== Return Value

New ENGINE ready to configure with ENGINE_set_*(), or NULL on allocation failure.


[.small]#Created with https://www.mrdocs.com[MrDocs]#