shishi_tkts_from_ccache_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_tkts_from_ccache_file ✨

okay bestie, welcome to the shishi manual page for shishi_tkts_from_ccache_file(3) — she's a section 3 function, she's from the shishi fam, and she's here to help you slurp tickets out of a ccache file. let's get into it 💖

🎀 NAME 🎀

shishi_tkts_from_ccache_file — API function

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_tkts_from_ccache_file(Shishi * handle, const char * filename,
       Shishi_tkts ** outtkts);

💅 ARGUMENTS 💅

  • Shishi * handle — the shishi handle, and she has to be one that was allocated by shishi_init(). no bootleg handles, bestie.
  • const char * filename — the name of the file you wanna read. like, the actual name. of the file. 🗂️
  • Shishi_tkts ** outtkts — a pointer to the ticket set that's gonna get allocated and populated for you. heads up though: the caller has to deallocate it on success. it's giving "you break it, you bought it" but make it memory management 🫶

🦋 DESCRIPTION 🦋

So what she does is read tickets from a ccache data structure and add them to the ticket set. iconic behaviour, honestly.

Now, the ccache format is proprietary (iykyk 😭), and this function supports — at minimum — the 0x0504 format. if you want the full lore on how the file is laid out, go read the section The Credential Cache Binary File Format in the Shishi manual. it's all there, fr fr.

⭐ RETURNS ⭐

  • SHISHI_IO_ERROR — she couldn't read the file. the vibe check failed at the I/O level 💀
  • SHISHI_CCACHE_ERROR — the data could not be parsed as a valid ccache structure. the file is not giving ccache, she is not fooled.
  • SHISHI_OK — success!! slay!! 👑

🙈 REPORTING BUGS 🙈

Found a bug? not her fault but also please tell someone: 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. go read it, it's the main character of documentation 💜

and that's the whole page, bestie 🧚 this was shishi version 1.0.3, dated with shishi_tkts_from_ccache_file(3) energy — stay hydrated, free your tickets, and don't forget to deallocate 💖✨

📦 where this page comes from