shishi_principal_set(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_principal_set ✨

okay bestie, welcome to the shishi_principal_set(3) page from the shishi manual 💖 yes it's a C API function, yes it's giving library-girl realness, and yes you're gonna understand it in like thirty seconds. sit with me. 🫶

🌸 NAME 🌸

shishi_principal_set — API function ✨ (that's it, that's the whole name, she's mysterious like that 💅)

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_principal_set(Shishi * handle, Shishi_asn1 namenode, const
       char * namefield, const char * name);

so you pull in <shishi.h> and then you can call her. four args, one int coming back. no cap. 🦋

💜 ARGUMENTS 💜

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). she's the whole vibe, everything runs through her. 🌈
  • Shishi_asn1 namenode — an ASN.1 structure that has a principal chillin' inside namefield. 👑
  • const char * namefield — the actual name of the field inside namenode where the principal name lives. like, which pocket is she in. 🎀
  • const char * name — a null-terminated string holding the principal name in RFC 1964 form. lowercase-and-proud, that's the format. ✨

🦋 DESCRIPTION 🦋

So basically: you take that principal name field inside your ASN.1 structure, and you set it to the name you passed in. that's the whole job. she's a setter, she sets, she slays, she goes home. 💅

⭐ RETURN VALUE ⭐

Returns SHISHI_OK if successful. 🎉 (and if you see SHISHI_OK you know you ate, periodt.)

😭 REPORTING BUGS 😭

found something cursed? do not suffer in silence bestie. report bugs to <bug-shishi@gnu.org>. 📧

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.

🧚 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. iykyk, go read the whole thing, it's a whole saga. 📚

sign-off time 💜 this lil page is from shishi, version 1.0.3, and she lives in section 3 of the manual (shishi_principal_set(3)). take care of her, she's iconic. mwah. 💋✨

📦 where this page comes from