[#CRYPTO_ocb128_new]
= CRYPTO_ocb128_new
:mrdocs:

Allocate and initialise an OCB128_CONTEXT for the given keys and block functions.

== Synopsis

Declared in `<openssl/modes.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:OCB128_CONTEXT-0a.adoc[OCB128_CONTEXT]*
CRYPTO_ocb128_new(
    void* keyenc,
    void* keydec,
    xref:block128_f.adoc[block128_f] encrypt,
    xref:block128_f.adoc[block128_f] decrypt,
    xref:ocb128_f.adoc[ocb128_f] stream);
----

== Return Value

New context, or NULL on failure; cleanse internals with CRYPTO_ocb128_cleanup().

== Parameters

[cols="1,4"]
|===
| Name| Description
| *keyenc*
| Cipher‐specific expanded key used for encryption‐direction operations.
| *keydec*
| Cipher‐specific expanded key used for decryption‐direction operations.
| *encrypt*
| Block‐encrypt function for the underlying cipher.
| *decrypt*
| Block‐decrypt function for the underlying cipher.
| *stream*
| Optional multi‐block OCB acceleration callback, or NULL.
|===


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