OSSL_CMP_HDR...TRANSACTIONID(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 OSSL_CMP_HDR...TRANSACTIONID 💅

okay so bestie, this is a page from the OpenSSL manual — it's OSSL_CMP_HDR...TRANSACTIONID(3ossl), and it's all about the little getter functions that reach into a CMP message header and pull stuff out. no cap, it's short, it's sweet, and it's giving "small API, big purpose" energy. ✨

🌸 NAME 🌸

OSSL_CMP_HDR_get0_transactionID, OSSL_CMP_HDR_get0_recipNonce, OSSL_CMP_HDR_get0_geninfo_ITAVs — the girlies that manipulate (well, read from) CMP message headers. 🎀

✨ SYNOPSIS ✨

#include <openssl/cmp.h>

ASN1_OCTET_STRING *OSSL_CMP_HDR_get0_transactionID(const
                                                   OSSL_CMP_PKIHEADER *hdr);
ASN1_OCTET_STRING *OSSL_CMP_HDR_get0_recipNonce(const
                                                OSSL_CMP_PKIHEADER *hdr);
STACK_OF(OSSL_CMP_ITAV)
    *OSSL_CMP_HDR_get0_geninfo_ITAVs(const OSSL_CMP_PKIHEADER *hdr);

like, yes, the wrapping is a lil chaotic but it's literally exactly that, don't come for me 🙈

🦋 DESCRIPTION 🦋

So you've got a PKIHeader — the header of a CMP message — and you want the tea inside it. That's what these three do. 💖

  • OSSL_CMP_HDR_get0_transactionID returns the transaction ID of the given PKIHeader. that's the "which convo is this" tag, periodt.
  • OSSL_CMP_HDR_get0_recipNonce returns the recipient nonce of the given PKIHeader. the nonce that was meant for you, bestie. 🎯
  • OSSL_CMP_HDR_get0_geninfo_ITAVs() returns the list of ITAVs in the generalInfo field of the given PKIHeader. yes, the whole stack of them, iconic. 👑

🧚 NOTES 🧚

CMP is defined in RFC 4210. that's the source of truth, iykyk. 📜

💜 RETURN VALUES 💜

The functions return the intended pointer value as described above — or NULL if the respective entry does not exist, and also on error. so like, NULL means "nope, not there" or "something went wrong", and you'll have to vibe-check which one it is. 😭

🌈 HISTORY 🌈

  • The OpenSSL CMP support was added in OpenSSL 3.0. OG era.
  • OSSL_CMP_HDR_get0_geninfo_ITAVs() was added in OpenSSL 3.3. she's newer, she's fresh, we love her. 🫶

Copyright 2007-2019 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 please actually read the license, it's not a suggestion, it's the whole rule 🫡

alright that's the page!! mwah 💋 — this lil rewrite was served to you from version 3.5.0, dated 2026-09-2, so if that's stale, blame the timestamp not me 😌⭐

📦 where this page comes from