shishi_krberror_set_sname(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_krberror_set_sname — bestie edition 💖

okay so this is shishi_krberror_set_sname(3), a page from the shishi manual (that's section 3, the library-functions section, iykyk). buckle up, it's short and sweet and we're gonna slay it.

✨ NAME ✨

shishi_krberror_set_sname — it's an API function, bestie. that's the whole name. no notes. 💅

🌸 SYNOPSIS 🌸

so first you gotta pull in the header, like:

#include <shishi.h>

and then the function itself looks like this:

int shishi_krberror_set_sname(Shishi * handle, Shishi_asn1 krberror,
       Shishi_name_type name_type, const char * sname[]);

it returns an int, it takes four things, and it's giving very specific. periodt.

🎀 ARGUMENTS 🎀

here's the rundown of everything you're handing over, no cap:

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). like, you can't do anything without it, she's the main character. 👑
  • Shishi_asn1 krberror — the krberror thing, as allocated by shishi_krberror(). that's the one we're editing, okay? 🦋
  • Shishi_name_type name_type — the type of principial (yes, that's how the original spells it, we're keeping it fr fr), see Shishi_name_type, and usually it's SHISHI_NT_UNKNOWN. that's the default vibe. ✨
  • const char * sname[] — an input array with the principal name. yes, an array, not a single string. she's plural, she contains multitudes. 🌈

💜 DESCRIPTION 💜

Set principal field in krberror to specified value. that's it. that's the whole job. you give her the name, she sets the principal field, we move on with our lives. iconic behavior honestly.

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's the good one, that's the one you want. if you see anything else, something went sideways and we're gonna have a conversation. 😭

🙈 REPORTING BUGS 🙈

found a bug? not me, but okay — report bugs to <bug-shishi@gnu.org>. like, actually email them, they wanna know.

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. so like, go off, redistribute her, just keep the receipts. 🫶

🔥 SEE ALSO 🔥

The full documentation for shishi is maintained as a Texinfo manual. If the info and shishi programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. that's your one-stop shop, bestie, go read the whole thing, it's lowkey fascinating.

and that's the whole page!! this was shishi_krberror_set_sname(3) from shishi version 1.0.3 — thanks for reading, ily, go set some principal fields responsibly 💖✨🎀🦋🌸

📦 where this page comes from