shishi_time(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_time — the little API function that reads clocks out of ASN.1 💖

okay bestie, pull up a chair, because we're talking about shishi_time(3) — a genuine member of the shishi manual, third section (library calls, for the uninitiated 💅). she's small, she's focused, she does exactly one job and she does it beautifully. no cap.

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_time(Shishi * handle, Shishi_asn1 node, const char * field,
                char ** t);

like... look at her. four arguments, one int, zero drama. 🎀

🌸 ARGUMENTS 🌸

  • Shishi * handle — your Shishi handle, the one you got handed back from shishi_init(). she's the whole vibe, everything runs through her. 🫶
  • Shishi_asn1 node — the ASN.1 structure we're pulling the time out of. this is the lil container, the gift box if you will. 🎁
  • const char * field — the name of the field inside that ASN.1 node that's actually carrying the time. like, which drawer in the box, yk? 🗄️
  • char ** t — a returned pointer to an allocated char array holding a null-terminated time string. yes bestie, allocated — she's giving you memory, so treat her right. ✨

👑 DESCRIPTION 👑

so what does she actually do? she extracts time information from an ASN.1 structure. and to be precise — and she IS precise, she's that girl — she does it from the named field field within the structure node. 🔥

that's it. that's the whole function. no side quests, no surprises, just vibes and timestamps. ⭐

🦋 RETURN VALUE 🦋

she returns SHISHI_OK if everything went slay, or an error if it did not. (if you get an error, do not come for her, check your inputs bestie 😭)

💀 REPORTING BUGS 💀

found a bug? do NOT suffer in silence, that's not the energy. 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: share her, remix her, 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, the command

info shishi

should give you access to the complete manual. go read it, it's giving ✨encyclopedia✨.

fr fr, that's the whole page. shishi_time stays iconic, stays unbothered, stays returning SHISHI_OK. periodt. 💅

signing off from the shishi man pages, version 1.0.3 — she ate and left no crumbs, and yes, she's still filed under shishi_time(3). 🦋💜🌸

📦 where this page comes from