OSSL_CMP_STATUSINFO_NEW(3ossl)

✨ OSSL_CMP_STATUSINFO_NEW ✨

okay bestie, welcome to the OSSL_CMP_STATUSINFO_NEW(3ossl) page 💖 this is the part of the OpenSSL manual that handles the CMP PKIStatus situation, and honestly? it's giving quiet luxury. let's get into it.

---

🌸 NAME 🌸

OSSL_CMP_STATUSINFO_new, OSSL_CMP_snprint_PKIStatusInfo, OSSL_CMP_CTX_snprint_PKIStatus — the function squad that manages the CMP PKIStatus. no cap, that's the whole job description.

---

🎀 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 look at those signatures. so clean. so demure. 🫶

---

💅 DESCRIPTION 💅

so this whole thing is the PKIStatus API for using CMP (Certificate Management Protocol) with OpenSSL. main character energy fr fr.

• OSSL_CMP_STATUSINFO_new() — makes a brand new PKIStatusInfo structure and fills in the values you hand it. it sets the status field to status, copies text over to statusString (unless text is NULL, in which case it just… doesn't 💀), and interprets fail_info as a bit pattern for the failInfo field. slay.
• OSSL_CMP_snprint_PKIStatusInfo() — takes the statusInfo you give it, whips up a human-readable string representing it, and places that string into the given buffer, with the given maximal length. it's basically the glow-up translator ✨
• OSSL_CMP_CTX_snprint_PKIStatus() — same vibe, but for the PKIStatusInfo components of the CMP context ctx. human-readable string → given buffer → given maximal length. iconic.

---

🦋 NOTES 🦋

CMP is defined in RFC 9810. that's the receipts, iykyk 📜

---

👑 RETURN VALUES 👑

• OSSL_CMP_STATUSINFO_new() returns a pointer to the structure on success, or NULL on error. it either eats or it doesn't, there is 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. so if you get NULL, that's your villain origin story right there.

---

🌈 HISTORY 🌈

the OpenSSL CMP support was added in OpenSSL 3.0. so it's not ancient, it's just ✨established✨.

---

💜 COPYRIGHT 💜

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

real talk bestie: that's a license, not a suggestion. read it. respect it. it's the law 💅

---

okay that's the whole page, you ate that 🍓 mwah! this was the 3.5.9 version of the OSSL_CMP_STATUSINFO_NEW(3ossl) manual, dated 2026-09-29 — go forth and manage those statuses, queen 👑✨