[#ENGINE_ctrl_cmd]
= ENGINE&lowbar;ctrl&lowbar;cmd
:mrdocs:

Invoke an ENGINE control command looked up by name rather than number&period;

== Synopsis

Declared in `&lt;openssl&sol;engine&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lsqb;&lsqb;deprecated&rsqb;&rsqb;
int
ENGINE&lowbar;ctrl&lowbar;cmd(
    xref:ENGINE.adoc[ENGINE]* e,
    char const* cmd&lowbar;name,
    long i,
    void* p,
    void(* f)(),
    int cmd&lowbar;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&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *e*
| Structural reference to the ENGINE&semi; many commands also require it to be functional&period;
| *cmd&lowbar;name*
| NUL&hyphen;terminated name of the command (from the ENGINE&apos;s cmd&lowbar;defns)&period;
| *i*
| Integer argument forwarded to the ENGINE ctrl handler&period;
| *p*
| Pointer argument forwarded to the ENGINE ctrl handler&period;
| *f*
| Optional function&hyphen;pointer argument forwarded to the ENGINE ctrl handler&period;
| *cmd&lowbar;optional*
| Non&hyphen;zero to treat an unsupported `cmd&lowbar;name` as success&period;
|===


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