OSSL_CMP_STATUSINFO_NEW(3ossl)

📦
version 15.1 · 2 versions
, in freebsd 15.1

💅 OSSL_CMP_STATUSINFO_NEW — the 3ossl manual, bestie edition ✨

okay so this is the page for OSSL_CMP_STATUSINFO_NEW(3ossl), and yes the manual name is 3ossl, that's just how OpenSSL rolls. it's all about managing the CMP PKIStatus and honestly? kind of iconic. let's get into it 🎀

🌸 NAME 🌸

OSSL_CMP_STATUSINFO_new, OSSL_CMP_snprint_PKIStatusInfo, OSSL_CMP_CTX_snprint_PKIStatus — the function(s) for managing the CMP PKIStatus. that's the whole vibe. 🫶

✨ SYNOPSIS ✨

like, here's the receipts, literally exactly this:

#include <openssl/cmp.h>

OSSL_CMP_PKISI *OSSL_CMP_STATUSINFO_new(int status, int fail_info,
                                        const char *text);
char *OSSL_CMP_snprint_PKIStatusInfo(const OSSL_CMP_PKISI *statusInfo,
                                     char *buf, size_t bufsize);
char *OSSL_CMP_CTX_snprint_PKIStatus(const OSSL_CMP_CTX *ctx, char *buf,
                                     size_t bufsize);

🦋 DESCRIPTION 🦋

so this is the PKIStatus API for using CMP (that's the Certificate Management Protocol, iykyk) with OpenSSL. we love a protocol moment. 💜

  • OSSL_CMP_STATUSINFO_new() — creates a new PKIStatusInfo structure and fills in the given values. it sets the status field to status, copies text (unless it's NULL) to statusString, and interprets fail_info as a bit pattern for the failInfo field. slay, all the fields handled. 🔥
  • OSSL_CMP_snprint_PKIStatusInfo() — places a human-readable string representing the given statusInfo in the given buffer, with the given maximal length. cute string, in your buffer, done. 💖
  • OSSL_CMP_CTX_snprint_PKIStatus() — places a human-readable string representing the PKIStatusInfo components of the CMP context ctx in the given buffer, with the given maximal length. same energy, but pulling from the context. ✨

⭐ NOTES ⭐

CMP is defined in RFC 9810. periodt. 📜

🎀 RETURN VALUES 🎀

  • OSSL_CMP_STATUSINFO_new() returns a pointer to the structure on success, or NULL on error. bestie either gets the pointer or gets nothing, no in-between. 😭
  • OSSL_CMP_snprint_PKIStatusInfo() and OSSL_CMP_CTX_snprint_PKIStatus() return a copy of the buffer pointer containing the string, or NULL on error. buffer pointer copy or NULL, that's the deal. 💀

🌈 HISTORY 🌈

the OpenSSL CMP support was added in OpenSSL 3.0. so it's been here, living its main character era since 3.0. 👑

Copyright 2007-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>.

fr fr read the license before you go copying stuff, that's the whole point of the paragraph above 💅

and that's the page!! source/version is 3.5.6 and the date on it is 2026-04-07, so like, shoutout to that timestamp — bye bestie, go snapshot some PKIStatus 💖🦋✨

📦 where this page comes from