shishi_tkts_add_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_add_ccache_file(3) 💖

okay so bestie, we're in the shishi manual, section 3, and today's main character is shishi_tkts_add_ccache_file — an API function that's literally just out here collecting tickets for you. let's get into it 🎀

✨ NAME ✨

shishi_tkts_add_ccache_file — API function 🫶

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_tkts_add_ccache_file(Shishi * handle, const char * filename,
       Shishi_tkts * tkts);

✨ ARGUMENTS ✨

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). it's giving foundation, it's giving everything-runs-through-me 💅
  • const char * filename — the name of the file we're reading from. yes bestie, that file.
  • Shishi_tkts * tkts — an allocated ticket set, aka the little home where the tickets are gonna live. we're moving them in 🏠

✨ DESCRIPTION ✨

So what does it do? It reads tickets out of a ccache data structure and adds them to the ticket set. simple as that, no cap.

Now here's the tea: the ccache format is proprietary, and this function supports (at least) the 0x0504 format. if you want the full lore, go read the section The Credential Cache Binary File Format in the Shishi manual — it has a whole description of the file format waiting for you 📖✨

✨ RETURNS ✨

  • SHISHI_IO_ERROR — when the file cannot be read 😭 (it's not you, it's the file)
  • SHISHI_CCACHE_ERROR — when the data cannot be parsed as a valid ccache structure 💀
  • SHISHI_OK — success!! we ate, no crumbs 👑

✨ REPORTING BUGS ✨

Found a bug? spill the tea 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. (iconic behaviour tbh, we love a permissive license 🌈)

✨ 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 forth and read, bestie 📚💖

and that's a wrap on the shishi manual, version 1.0.3 — page shishi_tkts_add_ccache_file(3). stay hydrated, read your manpages, and remember: tickets don't add themselves 💅✨🦋

📦 where this page comes from