shishi_authenticator_set_cname(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ shishi_authenticator_set_cname ✨

okay bestie, so this is a page from the shishi manual — section 3, the library-call girlies 🎀 — and it's all about one little function that goes by shishi_authenticator_set_cname. yes the name is a whole mouthful, i know, but she's worth it. let's get into it 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_authenticator_set_cname(Shishi * handle, Shishi_asn1
authenticator, Shishi_name_type name_type, const char * cname[]);

there she is. four args, one int coming back at you. iconic honestly 🫶

🦋 ARGUMENTS 🦋

  • Shishi * handle — your shishi handle, the one you got handed back from shishi_init(). she's the whole vibe, everything runs through her.
  • Shishi_asn1 authenticator — the authenticator itself, allocated by shishi_authenticator(). this is the thing we're editing, the main character of this whole operation 👑
  • Shishi_name_type name_type — the type of principial (yes, that's how the original spells it, and i'm not about to correct the ancestors 💀), see Shishi_name_type for the full list. usually it's SHISHI_NT_UNKNOWN. like, nine times out of ten, that's the one.
  • const char * cname[] — an input array holding the principal name. it's an array, bestie, not a single string. keep that in mind or you WILL be confused later.

💖 DESCRIPTION 💖

so what does she actually do? she sets the principal field inside your authenticator to whatever value you hand her. that's it. that's the whole job. simple, clean, does exactly what it says on the tin. no cap. ✨

🌈 RETURN VALUE 🌈

returns SHISHI_OK iff successful. and that "iff" is doing real work — if it's not SHISHI_OK, something went sideways, so check it, fr fr.

😭 REPORTING BUGS 😭

found a bug? don't just suffer in silence, tell the people:

go on, send the email. the maintainers wanna know. it's giving community care 💜

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(yes you can copy it, yes you can share it, just keep the notice. that's the deal. slay. 💅)

🎀 SEE ALSO 🎀

the full documentation for shishi lives in a Texinfo manual — that's the big one, the whole encyclopedia. if the info pages and the shishi programs are properly installed at your site, then this command:

info shishi

should give you access to the complete manual. go forth and read, bestie 📖✨

so yeah — that's shishi_authenticator_set_cname(3), from shishi version 1.0.3, straight out of the shishi manual. stay safe, check your return values, and don't forget to pass an array for cname 🦋💖

📦 where this page comes from