OSSL_PARAM_PRINT_TO_BIO(3SSL)

📦
version 4.0.3 · 6 versions
, in ubuntu stonking

💖 OSSL_PARAM_PRINT_TO_BIO(3SSL) 💖

okay bestie, welcome to the 3SSL manual section — this one's all about OSSL_PARAM_print_to_bio, the little function that spills your params out where you can actually look at them. it's literally an OSSL_PARAM interrogation utility and it's giving forensics, periodt. ✨

🌸 NAME 🌸

OSSL_PARAM_print_to_bio — OSSL_PARAM interrogation utilities. no cap, that's the whole job description.

🎀 SYNOPSIS 🎀

#include <openssl/params.h>

int OSSL_PARAM_print_to_bio(const OSSL_PARAM *p, BIO *bio,
                            int print_values);

copy that exactly, bestie, don't freestyle the signature 💅

🦋 DESCRIPTION 🦋

so OSSL_PARAM_print_to_bio() takes the array of OSSL_PARAM values you hand it in p, formats every single parameter in there, and prints the key — and, if you want it, the value too — out to a BIO you provide.

real talk on the requirements though:

  • p must be a non-null array of OSSL_PARAM values.
  • that array has to be terminated with a value that has a null key member. that's the lil "we're done here" marker, the end-of-array vibe check. 🚩

and then there's print_values, which is the control parameter — it decides whether the key values get printed alongside the key names. toggle it, and you either get the full tea ☕ or just the labels.

👑 RETURN VALUES 👑

  • OSSL_PARAM_print_to_bio() returns 1 on success 💖
  • and 0 on failure 💀

that's it. binary. main character energy either way.

⭐ HISTORY ⭐

OSSL_PARAM_print_to_bio() was added in OpenSSL 3.5 — so it's a newer icon, not one of the OGs. 🫶

Copyright 2024 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 OpenSSL 4.0.3, dated 2026-09-29, filed under OSSL_PARAM_PRINT_TO_BIO(3SSL) — go print some params, you ate 💅🎀🍓

📦 where this page comes from