shishi_resolv(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_resolv(3) — the shishi manual, bestie edition ✨

okay so you're in the shishi manual pages (section 3, the library-function corner of the world, we love her) and you clicked on shishi_resolv. buckle up, this one's short but she serves.

🌸 NAME 🌸

shishi_resolv — an API function 🫶 (yes that's literally the whole name section, she's lowkey minimal, respect it)

✨ SYNOPSIS ✨

#include <shishi.h>

Shishi_dns shishi_resolv(const char * zone, uint16_t querytype);

that's it. that's the whole vibe. two args, one function, iconic behavior only 💅

🎀 ARGUMENTS 🎀

  • const char * zone — the domain name of the authentication zone, fr fr. like, example vibes: "EXAMPLE.ORG". that's the territory you're asking about, bestie 🦋
  • uint16_t querytype — the type of domain data you wanna query for. what flavor of DNS tea are we sipping today ✨

🌈 DESCRIPTION 🌈

So the whole thing is: you query the DNS resolver for data of type querytype about the domain name zone. that's her job. that's what she does. no cap 🧚

Important though, bestie: currently the only supported kinds are SHISHI_DNS_TXT and SHISHI_DNS_SRV. that's it. those two. not a buffet, it's a curated menu 😌

🫶 And after you're done using it — like, after after — the returned list should be deallocated by a call to shishi_resolv_free(). not me reminding you to clean up after yourself, but also yes, me reminding you to clean up after yourself. memory leaks are NOT main character energy 💀

👑 RETURN VALUE 👑

Returns a linked list of DNS resource records 💖 — or NULL if the query failed 😭 (sometimes the DNS gods simply say no).

🐛 REPORTING BUGS 🐛

Found a bug? Tell the people, don't suffer in silence, bestie:

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. iykyk 📖

and that's the whole page, bestie!! 🌸 this was shishi_resolv(3) from shishi version 1.0.3 — go forth, resolve responsibly, and free your lists 💖✨🎀🦋💅

📦 where this page comes from