shishi_keys_from_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_keys_from_file(3) 💖

okay bestie, welcome to the shishi manual, section 3, and today's main character is shishi_keys_from_file. it's an API function, it's lowkey iconic, and it's about to load up your keyring like it's a group chat. let's go 🦋

✨ NAME ✨

shishi_keys_from_file — API function 👑

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_keys_from_file(Shishi_keys * keys, const char * filename);

like. that's it. that's the whole vibe. two arguments, one int, no drama 💅

✨ ARGUMENTS ✨

  • Shishi_keys * keys — your key set handle, bestie. the one you got from shishi_keys(), no substitutions allowed, this is that handle 🎀
  • const char * filename — the filename you wanna read keys from. yes, the actual file. yes, spelled exactly like that ✨

✨ DESCRIPTION ✨

so here's the tea: this function reads zero or more keys out of the file filename and appends them to the keyset keys. zero! so if the file's giving nothing, that's still valid, no shame 🙈

and if you wanna know what the input is supposed to look like? that's shishi_key_print()'s whole job — go check that one for the format, iykyk 📖

note: it appends. it does not yeet what's already in your keyset. your existing keys stay put, periodt.

✨ RETURN VALUE ✨

returns SHISHI_OK iff successful. that "iff" is doing heavy lifting fr fr — anything else and something went sideways 💀

✨ SINCE ✨

0.0.42 — ancient. elder statesman energy. it was slaying before you were born 👑

✨ REPORTING BUGS ✨

found a bug? don't be shy, report it 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. (translation: go off, just keep the receipt 🧾💖)

✨ SEE ALSO ✨

the full documentation for shishi lives in 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. that's the whole entire lore, bestie 🌈

and that's a wrap!! this page came to you from shishi, version 1.0.3, filed under shishi_keys_from_file(3). stay hydrated, read your man pages, and go append some keys 🫶✨💜

📦 where this page comes from