EVP_PKEY_CTX_SET1_PBE_PASS(3SSL)

📦
version 4.0.3 · 13 versions
, in ubuntu stonking

💖 EVP_PKEY_CTX_SET1_PBE_PASS 💖

okay so bestie, this is a page out of the OpenSSL manual, section 3SSL, and it's all about EVP_PKEY_CTX_set1_pbe_pass — the generic KDF support functions. yes, KDF. key derivation functions. we love a little password-based moment, no cap. 🫶

✨ NAME ✨

EVP_PKEY_CTX_set1_pbe_pass — generic KDF support functions 💅

🌸 SYNOPSIS 🌸

so here's the whole vibe, literally copied so you can't mess it up:

#include <openssl/kdf.h>

int EVP_PKEY_CTX_set1_pbe_pass(EVP_PKEY_CTX *pctx, unsigned char *pass,
                               int passlen);

🦋 DESCRIPTION 🦋

k so these functions? they're generic support functions for all KDF algorithms. all of them. every single one. they're the little backstage crew making the whole show work. 🎀

  • EVP_PKEY_CTX_set1_pbe_pass() — sets the password 🥺 it takes the passlen first bytes from pass. that's it. that's the whole function. it sets your password to the first passlen bytes of pass. periodt.

🌈 STRING CTRLS 🌈

not me about to tell you there's also support for string based control operations via EVP_PKEY_CTX_ctrl_str(3). slay.

so you have two options for getting that password in there, bestie:

  • the password can be directly specified using the type parameter "pass" 💖
  • or you can hand it over in hex encoding using the "hexpass" parameter ✨

choose your fighter. both are iconic. 👑

⭐ RETURN VALUES ⭐

here's the part where we do a vibe check on your return value:

  • 1 means success — we ate, we devoured, we left no crumbs 🔥
  • 0 or a negative value means failure 😭
  • and specifically, a return value of -2 means the operation is not supported by the public key algorithm. it's giving "it's not you, it's your algorithm". 💀
so like, lowkey always check your return values?? okay bestie I'm begging 🙈

👑 SEE ALSO 👑

go read these too, iykyk:

🎀 HISTORY 🎀

a little lore for you: EVP_PKEY_CTX_set1_pbe_pass() was converted from a macro to a function in OpenSSL 3.0. glow up fr fr 💅✨ she used to be a macro, now she's a whole function. main character energy.

Copyright 2018-2020 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

and that's the whole page bestie!! 🥰 this was version 4.0.3, dated 2026-09-29, from the OpenSSL girls themselves. stay encrypted, stay gorgeous, and remember: the password is the first passlen bytes, always. mwah 💋🌸💜

📦 where this page comes from