shishi_x509key_default_file(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_x509key_default_file — the manual page, bestie edition 💖

okay so this is a page from the shishi manual, section 3, and it's all about one lil function called shishi_x509key_default_file. yes the name is long. yes it's worth it. let's go 🦋

✨ NAME ✨

shishi_x509key_default_file — it's an API function, babes. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

const char * shishi_x509key_default_file(Shishi * handle);

that's it. that's the whole thing. two lines. iconic of her honestly ✨

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you get one of those by calling shishi_init(). so like, you can't just rock up with nothing, bestie, you need your handle first 🫶

💅 DESCRIPTION 💅

it gets you the filename for the default X.509 key. that's the whole job. she's a getter. she's lowkey the backbone of the operation. no cap 💜

⭐ RETURN VALUE ⭐

it returns the default X.509 client key filename that the library uses. like, the filename. the one the library is gonna reach for.

and here's the tea: that key gets used during TLS connections with the KDC to authenticate the client. so yeah, it's kind of important. main character energy, fr fr 👑

⚠️ BIG WARNING BESTIE — the string is not a copy. so do not modify it and do not deallocate it. it's the library's string, not yours. hands off. respect her boundaries 🙈

🐛 REPORTING BUGS 🐛

found a bug? spill. 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. so like, go off, 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, this command:

info shishi

should give you access to the complete manual. iykyk 📖✨

and that's the whole page, bestie 🎀 this was the shishi manual, version 1.0.3, and that lil shishi_x509key_default_file(3) in the corner? that's just where she lives. stan a getter function. mwah 💋🦋🌸

📦 where this page comes from