EVP_PKEY_GET_SIZE(3ossl)

📦
version 15.1 · 2 versions
, in freebsd 15.1

💖 NAME 💖

Okay bestie, welcome to the EVP_PKEY_GET_SIZE(3ossl) page — yes, that’s the manual name, and we’re folding it in right here 💅. This is the OpenSSL info-dump for EVP_PKEY_get_size, EVP_PKEY_get_bits, EVP_PKEY_get_security_bits, EVP_PKEY_bits, EVP_PKEY_security_bits, and EVP_PKEY_size: the EVP_PKEY information functions. They’re the key’s little fact cards, no cap.

✨ SYNOPSIS ✨

#include <openssl/evp.h>

int EVP_PKEY_get_size(const EVP_PKEY *pkey);
int EVP_PKEY_get_bits(const EVP_PKEY *pkey);
int EVP_PKEY_get_security_bits(const EVP_PKEY *pkey);

#define EVP_PKEY_bits EVP_PKEY_get_bits
#define EVP_PKEY_security_bits EVP_PKEY_get_security_bits
#define EVP_PKEY_size EVP_PKEY_get_size

🦋 DESCRIPTION 🦋

EVP_PKEY_get_size() is highkey giving maximum suitable size for the output buffers for almost all operations that can be done with pkey. This corresponds to the provider parameter OSSL_PKEY_PARAM_MAX_SIZE. The primary documented use is with EVP_SignFinal(3) and EVP_SealInit(3), but it isn’t limited there — the returned size is also large enough for the output buffer of EVP_PKEY_sign(3), EVP_PKEY_encrypt(3), EVP_PKEY_decrypt(3), and EVP_PKEY_derive(3).

⚠️ It must be stressed that, unless the documentation for the operation that’s being performed says otherwise, the size returned by EVP_PKEY_get_size() is only preliminary and not exact, so the final contents of the target buffer may be smaller. It is therefore crucial to take note of the size given back by the function that performs the operation, such as EVP_PKEY_sign(3) (the siglen argument will receive that length), to avoid bugs. That’s the “trust but verify the returned length” moment, fr fr.

EVP_PKEY_get_bits() — returns the cryptographic length of the cryptosystem to which the key in pkey belongs, in bits. Lowkey important: the definition of cryptographic length is specific to the key cryptosystem. This length corresponds to the provider parameter OSSL_PKEY_PARAM_BITS.

EVP_PKEY_get_security_bits() — returns the number of security bits of the given pkey; bits of security is defined in NIST SP800-57. This corresponds to the provider parameter OSSL_PKEY_PARAM_SECURITY_BITS.

🫶 RETURN VALUES 🫶

EVP_PKEY_get_size(), EVP_PKEY_get_bits(), and EVP_PKEY_get_security_bits() return a positive number, or 0 if this size isn’t available. Short, sweet, slay.

🌸 NOTES 🌸

Most functions that have an output buffer and are mentioned with EVP_PKEY_get_size() have a functionality where you can pass NULL for the buffer and still pass a pointer to an integer and get the exact size that this function call delivers in the context that it’s called in. The way that this works: those functions can be called twice — once to find out the exact buffer size, then allocate the buffer in between, and call that function again to actually output the data. For those functions, it isn’t strictly necessary to call EVP_PKEY_get_size() to find out the buffer size, but it may be useful in cases where it’s desirable to know the upper limit in advance.

It should also be especially noted that EVP_PKEY_get_size() shouldn’t be used to get the output size for EVP_DigestSignFinal(), according to "NOTES" in EVP_DigestSignFinal(3). That’s the don’t-use-the-wrong-size warning, iykyk 💀.

👑 SEE ALSO 👑

🎀 HISTORY 🎀

In OpenSSL 3.0, the EVP_PKEY_bits(), EVP_PKEY_security_bits(), and EVP_PKEY_size() functions were renamed to include "get" in their names, respectively. The old names are kept as non-deprecated alias macros — so the OGs still work, main character energy, periodt.

Copyright 2020-2021 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>.

Signed off with OpenSSL 3.5.6 vibes, dated 2026-04-07 — this EVP_PKEY_GET_SIZE(3ossl) page ate, and that’s on periodt 💅✨.

📦 where this page comes from