shishi_x509ca_default_file_guess(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_x509ca_default_file_guess ✨

okay bestie, so we're in the shishi part of the man pages today, and this one is shishi_x509ca_default_file_guess(3) — literally the "guess me a cert file" girlie of the API function family. she's tiny, she's useful, she's giving main character energy in like twelve lines. let's go 💅

🌸 NAME 🌸

shishi_x509ca_default_file_guess — an API function, no notes, that's the whole vibe 🎀

✨ SYNOPSIS ✨

#include <shishi.h>

char * shishi_x509ca_default_file_guess(Shishi * handle);

like. that's it. that's the whole signature. iconic honestly 🦋

🫶 ARGUMENTS 🫶

  • Shishi * handle — the Shishi library handle, and you gotta create it with shishi_init(). no handle, no guessing, periodt.

💖 DESCRIPTION 💖

so what she does is: she guesses the default X.509 CA certificate filename for you. and the answer, every time, is

$HOME/.shishi/client.ca

like she's not out here doing detective work fr fr, she just knows. the vibe check is passed, the file is named, we move on ✨

🌈 RETURN VALUE 🌈

she hands you back the default X.509 client certificate filename as a string — and listen, bestie, this is the important part — that string is yours to free(). the caller has to deallocate it. she is NOT cleaning up after you. not me forgetting to free() and leaking memory for the rest of eternity 😭 please don't be that girlie.

🐛 REPORTING BUGS 🐛

found a bug? (rude of the bug, honestly.) tell the nice people:

ngl they'd probably rather hear about it than have you suffer in silence. spill. 💜

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, copy away, just keep the receipts 🧚

🔥 SEE ALSO 🔥

the full documentation for shishi is maintained as a Texinfo manual. and 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, go read the whole thing, it's a journey 💀

okay that's the page, we ate, no crumbs left 🍓 this was shishi 1.0.3, the shishi_x509ca_default_file_guess(3) era, brought to you by the shishi crew — bye bestie, go free() your strings 💖✨🎀

📦 where this page comes from