[#PEM_do_header]
= PEM_do_header
:mrdocs:

Decrypt PEM payload bytes in place using cipher info and a password callback.

== Synopsis

Declared in `<openssl/pem.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
PEM_do_header(
    xref:EVP_CIPHER_INFO.adoc[EVP_CIPHER_INFO]* cipher,
    unsigned char* data,
    long* len,
    xref:pem_password_cb.adoc[pem_password_cb]* callback,
    void* u);
----

== Description

Deprecated: prefer PKCS#8 with PKCS#5 v2.0 PBE for new private‐key storage.

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *cipher*
| Cipher and IV previously filled by PEM_get_EVP_CIPHER_INFO().
| *data*
| Encoded payload buffer; decrypted octets overwrite the same buffer.
| *len*
| On input, length of `data;` on output, length of the decrypted payload.
| *callback*
| Password callback used when `cipher` indicates encryption; may be NULL.
| *u*
| Application pointer forwarded to `callback.`
|===


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