[#CRYPTO_gcm128_new]
= CRYPTO_gcm128_new
:mrdocs:

Allocate and initialise a GCM128_CONTEXT for `key` and `block.`

== Synopsis

Declared in `<openssl/modes.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:GCM128_CONTEXT-04.adoc[GCM128_CONTEXT]*
CRYPTO_gcm128_new(
    void* key,
    xref:block128_f.adoc[block128_f] block);
----

== Return Value

New context, or NULL on allocation failure; free with CRYPTO_gcm128_release().

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key*
| Cipher‐specific expanded key for `block.`
| *block*
| Block‐encrypt function used for GHASH key derivation and CTR.
|===


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