PKCS12_ADD_FRIENDLYNAME_ASC(3ossl)

💖 PKCS12_ADD_FRIENDLYNAME_ASC — the 3ossl page, bestie edition 💖

okay so. you're in the OpenSSL manual, page PKCS12_ADD_FRIENDLYNAME_ASC(3ossl), and we're talking about the little trio of functions that give your PKCS#12 safeBag a ✨friendly name✨. not a scary name. a friendly one. it's giving "hello, my name is". periodt.

---

🌸 NAME 🌸

PKCS12_add_friendlyname_asc, PKCS12_add_friendlyname_utf8, PKCS12_add_friendlyname_uni — Functions to add the friendlyname attribute to a PKCS#12 safeBag

like literally that's the whole job. three functions, one glow-up: putting a friendlyName on your bag so it doesn't show up looking all anonymous and mysterious. main character naming energy fr fr 💅

---

✨ SYNOPSIS ✨

#include <openssl/pkcs12.h>

int PKCS12_add_friendlyname_asc(PKCS12_SAFEBAG *bag, const char *name,
                                int namelen);

int PKCS12_add_friendlyname_utf8(PKCS12_SAFEBAG *bag, const char *name,
                                int namelen);

int PKCS12_add_friendlyname_uni(PKCS12_SAFEBAG *bag,
                                const unsigned char *name, int namelen);

🎀 not me double-checking that the uni one takes const unsigned char * while the other two take const char *. yes bestie, that's real, that's canon, don't "fix" it. iykyk.

---

🦋 DESCRIPTION 🦋

okay so all three of these do the same iconic thing: they add a PKCS#9 friendlyName attribute to a PKCS#12 safeBag. the only difference is how the name is encoded, and the way that detail matters is so real.

• PKCS12_add_friendlyname_asc() — adds an ASCII string representation of the PKCS#9 friendlyName attribute to a PKCS#12 safeBag. simple, classic, no drama. 🌈
• PKCS12_add_friendlyname_utf8() — adds a UTF-8 string representation of the PKCS#9 friendlyName attribute to a PKCS#12 safeBag. for when your name has ✨flavor✨ — emoji, accents, the whole vibe. 🦋
• PKCS12_add_friendlyname_uni() — adds a Unicode string representation of the PKCS#9 friendlyName attribute to a PKCS#12 safeBag. the unsigned char * girlie of the group. 👑

and then, the parameter that ties them all together:

• bag — this is the PKCS12_SAFEBAG you're adding the attribute to. it's the bag. you're naming the bag. the bag gets a name. that's it, that's the plot. 🫶

---

💀 RETURN VALUES 💀

Returns 1 for success or 0 for failure.

that's it. 1 = slay. 0 = not slay. no in-between, no "maybe", no situationship. binary as hell and we respect it.

---

👀 SEE ALSO 👀

• PKCS12_get_friendlyname(3) — the reverse move, for when you need to read the name back instead of writing it. the "wait, what did i call this thing" function. 🙈

---

📜 COPYRIGHT 📜

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

⚠️ bestie, "you may not use this file except in compliance with the License" is not a vibe, it's a rule. read your license. 💖

---

and that's the page!! 🎀 from OpenSSL version 3.5.9, dated 2026-09-29 — thanks for reading my little PKCS12_ADD_FRIENDLYNAME_ASC(3ossl) moment, you ate, go name a bag, mwah 💋🌸