NAME
ENGINE_set_flags
,
ENGINE_get_flags
—
modify the behaviour of an ENGINE
object
SYNOPSIS
#include
<openssl/engine.h>
int
ENGINE_set_flags
(ENGINE *e,
int flags);
int
ENGINE_get_flags
(const ENGINE
*e);
DESCRIPTION
ENGINE_set_flags
()
sets the flags attribute of e to the new
flags. The previous state of the flags attribute is
overwritten. Flags that were previously set are cleared unless they are also
present in the new flags.
The flags argument can be the bitwise OR of zero or more of the following constants:
ENGINE_FLAGS_BY_ID_COPY
- ENGINE_by_id(3) returns a shallow copy of the ENGINE object it found rather than incrementing the reference count and returning a pointer to the original.
ENGINE_FLAGS_MANUAL_CMD_CTRL
- ENGINE_ctrl(3) lets the function installed with
ENGINE_set_ctrl_function(3) handle all commands except
ENGINE_CTRL_HAS_CTRL_FUNCTION
, even the builtin commands. ENGINE_FLAGS_NO_REGISTER_ALL
- ENGINE_register_all_complete(3) skips e.
RETURN VALUES
ENGINE_set_flags
() always returns 1.
ENGINE_get_flags
() returns the
flags attribute of e.
SEE ALSO
ENGINE_by_id(3), ENGINE_ctrl(3), ENGINE_init(3), ENGINE_new(3), ENGINE_register_all_complete(3), ENGINE_set_RSA(3)
HISTORY
ENGINE_set_flags
() and
ENGINE_get_flags
() first appeared in OpenSSL 0.9.7
and have been available since OpenBSD 3.2.