shishi_ctime(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_ctime — the manual, but make it slay 💖

okay bestie, so this one is a lil function from the shishi manual, section 3 (that's the library-functions section, iykyk). her whole job? pulling a time value out of an ASN.1 structure. that's it. that's the girl. 🕐✨

🌸 NAME 🌸

shishi_ctime — API function. she reads time out of ASN.1 and she does it flawlessly.

✨ SYNOPSIS ✨

#include <shishi.h>

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

like, look at her. four args, one int return, no notes. 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi handle, bestie, and you gotta get it the proper way: as allocated by shishi_init(). no bootleg handles here. 🙅♀️
  • Shishi_asn1 node — the ASN.1 structure we're reading the field out of. this is the house the field lives in. 🏠
  • const char * field — the literal name of the field inside node that you want read. be specific, she's not guessing. 🎯
  • time_t * t — pointer to a C-time valued integer, and it gets updated with the time value that's being extracted. she writes into it, so hand her a real one. ✍️

💖 DESCRIPTION 💖

so what she does is: she extracts time information from an ASN.1 structure node, and she takes it from an arbitrary element field of that structure. that's the whole vibe. you point, she pulls the time out, no cap. 🦋

⭐ RETURN VALUE ⭐

she's got a whole mood ring of return codes, so listen up:

  • SHISHI_OK — she ate. everything worked. 🎉
  • SHISHI_ASN1_NO_ELEMENT — the element straight up does not exist. it's giving ghosted. 👻
  • SHISHI_ASN1_NO_VALUE — the field exists but has no value. empty. vacant. nobody home. 🫥
  • in all other cases, SHISHI_ASN1_ERROR is returned. so like, anything else that goes wrong lands there. periodt.

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, bestie, tell the devs:

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. so yes, share her around, 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 the main character energy the docs deserve. 📚✨

and that's the page, bestie!! this was shishi_ctime, from shishi version 1.0.3, dated 1.0.3 — mwah, love that for us. now go extract some times and be iconic about it 💅💖🎀

📦 where this page comes from