PKCS12_key_gen_utf8_ex

Derive key material using the PKCS#12 key-generation function (UTF-8 passphrase).

Synopsis

Declared in <openssl/pkcs12.h>

int
PKCS12_key_gen_utf8_ex(
    char const* pass,
    int passlen,
    unsigned char* salt,
    int saltlen,
    int id,
    int iter,
    int n,
    unsigned char* out,
    EVP_MD const* md_type,
    OSSL_LIB_CTX* ctx,
    char const* propq);

Return Value

1 on success, 0 on error.

Parameters

NameDescription
passUTF-8 passphrase.
passlenLength of pass, or -1 to use strlen().
saltSalt for derivation.
saltlenLength of salt in bytes.
idPurpose byte (PKCS12_KEY_ID, PKCS12_IV_ID, or PKCS12_MAC_ID).
iterIteration count (values less than 1 are treated as 1).
nNumber of bytes to derive.
outBuffer to receive derived key material.
md_typeMessage digest for the derivation.
ctxLibrary context for algorithm fetching, or NULL for default.
propqProperty query for algorithm fetching, or NULL.