PKCS12_SAFEBAG_GET0_ATTRS(3ossl)

📦
version 3.5.9 · 8 versions
, in fedora 43, fedora 44

💖 PKCS12_SAFEBAG_GET0_ATTRS 💖

okay bestie, so this is a page from the OpenSSL manual — specifically the 3ossl section — and it's all about pulling attributes out of a PKCS#12 safeBag. two little functions, one big glow-up. let's get into it 🎀

✨ NAME ✨

PKCS12_SAFEBAG_get0_attrs, PKCS12_get_attr_gen — retrieve attributes from a PKCS#12 safeBag 🦋

✨ SYNOPSIS ✨

#include <openssl/pkcs12.h>

const STACK_OF(X509_ATTRIBUTE) *PKCS12_SAFEBAG_get0_attrs(const PKCS12_SAFEBAG *bag);

ASN1_TYPE *PKCS12_get_attr_gen(const STACK_OF(X509_ATTRIBUTE) *attrs,
                               int attr_nid);

like, copy that exactly, don't freestyle it 💅

✨ DESCRIPTION ✨

PKCS12_SAFEBAG_get0_attrs() 🌸

she retrieves the stack of X509_ATTRIBUTEs from a PKCS#12 safeBag. and bag? that's the PKCS12_SAFEBAG you're pulling the attributes from, periodt.

PKCS12_get_attr_gen() 🌈

this one retrieves an attribute by NID from a stack of X509_ATTRIBUTEs. attr_nid is the NID of the attribute you want to retrieve. that's the whole vibe, no cap.

✨ RETURN VALUES ✨

  • PKCS12_SAFEBAG_get0_attrs() returns the stack of X509_ATTRIBUTEs from a PKCS#12 safeBag — and bestie, it could be empty. not a bug, just how she is 🙈
  • PKCS12_get_attr_gen() returns an ASN1_TYPE object containing the attribute, or NULL if the attribute was either not present or an error occurred. both roads lead to NULL, so stay alert 💀
  • PKCS12_get_attr_gen() does not allocate a new attribute. the returned attribute is still owned by the PKCS12_SAFEBAG in which it resides. so don't you dare free it, that's not your attribute, that's her attribute 💅
⚠️ real talk: that last one is the moment. no new allocation, ownership stays with the PKCS12_SAFEBAG. treat the return value as borrowed, okay?

✨ SEE ALSO ✨

go read those next, iykyk 🫶

Copyright 2019-2020 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 PKCS12_SAFEBAG_GET0_ATTRS(3ossl) from OpenSSL version 3.5.9, dated 2026-09-29 — mwah, iconic, slay, go forth and retrieve those attributes 💖✨👑

📦 where this page comes from