[#ENGINE_ctrl_cmd]
= ENGINE_ctrl_cmd
:mrdocs:

Invoke an ENGINE control command looked up by name rather than number.

== Synopsis

Declared in `<openssl/engine.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
int
ENGINE_ctrl_cmd(
    xref:ENGINE.adoc[ENGINE]* e,
    char const* cmd_name,
    long i,
    void* p,
    void(* f)(),
    int cmd_optional);
----

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

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *e*
| Structural reference to the ENGINE; many commands also require it to be functional.
| *cmd_name*
| NUL‐terminated name of the command (from the ENGINE's cmd_defns).
| *i*
| Integer argument forwarded to the ENGINE ctrl handler.
| *p*
| Pointer argument forwarded to the ENGINE ctrl handler.
| *f*
| Optional function‐pointer argument forwarded to the ENGINE ctrl handler.
| *cmd_optional*
| Non‐zero to treat an unsupported `cmd_name` as success.
|===


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