PKCS12_SAFEBAG_GET0_ATTRS(3ossl)

📦
version 15.1 · 2 versions
, in freebsd 15.1

💅 PKCS12_SAFEBAG_GET0_ATTRS(3ossl) — like, the whole manual page, bestie

okay so this is the PKCS12_SAFEBAG_GET0_ATTRS(3ossl) page from the OpenSSL fam, and it's literally about pulling attributes out of a PKCS#12 safeBag. it's short, it's sweet, it's giving "small but mighty" energy. let's get into it 💖

✨ NAME ✨

PKCS12_SAFEBAG_get0_attrs, PKCS12_get_attr_gen — Retrieve attributes from a PKCS#12 safeBag.

like, that's the whole job. two functions, one mission: get those attributes out. 🎀

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

copy these exactly, bestie, no freestyling the signatures. const is there for a reason and she is NOT decorative 💅

🌸 DESCRIPTION 🌸

  • PKCS12_SAFEBAG_get0_attrs() retrieves the stack of X509_ATTRIBUTEs from a PKCS#12 safeBag. and bag is the PKCS12_SAFEBAG you're pulling the attributes from. that's it. that's the function. iconic behaviour honestly ✨
  • PKCS12_get_attr_gen() retrieves an attribute by NID from a stack of X509_ATTRIBUTEs. attr_nid is the NID of the attribute you want. so you hand her a stack and a NID and she goes digging 🧚

👑 RETURN VALUES 👑

  • PKCS12_SAFEBAG_get0_attrs() returns the stack of X509_ATTRIBUTEs from a PKCS#12 safeBag, which could be empty. so like… don't panic if it's empty, that's just a vibe, not a bug 🫶
  • 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. so NULL is doing double duty here — missing OR broken. iykyk 😭
  • PKCS12_get_attr_gen() does not allocate a new attribute. the returned attribute is still owned by the PKCS12_SAFEBAG in which it resides.
⚠️ real talk: that last bit matters SO much. you did not get a fresh new attribute, you got a loaner. the PKCS12_SAFEBAG still owns it, so don't go freeing it like it's yours — that's not your bag to free (literally) 💀

🎀 SEE ALSO 🎀

go read those too, they're in the same friend group 🌈

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

ngl the legal section is the one place we keep it 100% serious — license text hits different and it is NOT up for remixing 🔥

and that's the page!! congrats, you now know everything this manpage knows, no cap 💖✨

~ signed off with love from the OpenSSL fam, version 3.5.6, dated 2026-04-07, in the manual PKCS12_SAFEBAG_GET0_ATTRS(3ossl) 🎀🦋💅

📦 where this page comes from