OSSL_CMP_STATUSINFO_NEW(3SSL)

📦
version 4.0.3 · 13 versions
, in ubuntu stonking

💖 OSSL_CMP_STATUSINFO_NEW 💖

okay bestie, so this is the OpenSSL manual page for OSSL_CMP_STATUSINFO_NEW(3SSL) — like, manual name 3SSL, OpenSSL's own little corner of the docs. it's all about managing the CMP PKIStatus. CMP = Certificate Management Protocol, and yes we're getting into it. 🎀

✨ NAME ✨

OSSL_CMP_STATUSINFO_new, OSSL_CMP_snprint_PKIStatusInfo, OSSL_CMP_CTX_snprint_PKIStatus — the function(s) for managing the CMP PKIStatus, fr fr. 💅

🌸 SYNOPSIS 🌸

#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);

like, just #include <openssl/cmp.h> and you're in. no cap. ✨

🦋 DESCRIPTION 🦋

so this is the PKIStatus API for using CMP (Certificate Management Protocol) with OpenSSL. main character energy, honestly. 👑

  • OSSL_CMP_STATUSINFO_new() — creates a new PKIStatusInfo structure and fills in the values you give it. literally. it sets the status field to status, copies text over to statusString (unless it's NULL, then it just skips that part), and interprets fail_info as a bit pattern for the failInfo field. cute.
  • OSSL_CMP_snprint_PKIStatusInfo() — takes the statusInfo you hand it and places a human-readable string representing it into the given buffer, with the given maximal length. it's giving "make it readable for the girlies". 💅
  • OSSL_CMP_CTX_snprint_PKIStatus() — same deal but for the PKIStatusInfo components of the CMP context ctx. drops a human-readable string into the given buffer, with the given maximal length. iconic.

📌 NOTES 📌

CMP is defined in RFC 9810. that's the whole note. periodt. 💜

🫶 RETURN VALUES 🫶

  • OSSL_CMP_STATUSINFO_new() — returns a pointer to the structure on success. on error? NULL. 😭
  • OSSL_CMP_snprint_PKIStatusInfo() and OSSL_CMP_CTX_snprint_PKIStatus() — return a copy of the buffer pointer that contains the string. or NULL on error, bestie. 💀

🌈 HISTORY 🌈

the OpenSSL CMP support was added in OpenSSL 3.0. so it's been here a minute, but not forever. ⭐

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

okay that's the whole page, bestie!! 🥰 this was OpenSSL version 4.0.3, dated 2026-09-29 — go read your PKIStatusInfo and slay. 🦋💖✨

📦 where this page comes from