[#PKCS5_PBKDF2_HMAC_SHA1]
= PKCS5_PBKDF2_HMAC_SHA1
:mrdocs:

Derive a key from a password with PBKDF2‐HMAC‐SHA1 (RFC 2898).

== Synopsis

Declared in `<openssl/evp.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
PKCS5_PBKDF2_HMAC_SHA1(
    char const* pass,
    int passlen,
    unsigned char const* salt,
    int saltlen,
    int iter,
    int keylen,
    unsigned char* out);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pass*
| Password bytes, or NULL.
| *passlen*
| Length of `pass` in bytes, or ‐1 to use strlen(`pass).`
| *salt*
| Salt bytes, or NULL when `saltlen` is 0.
| *saltlen*
| Length of `salt` in bytes.
| *iter*
| Iteration count (should be large; typically at least 1000).
| *keylen*
| Desired derived key length in bytes.
| *out*
| Buffer of at least `keylen` bytes that receives the derived key.
|===


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