libwget-dns-caching(3)

💅 libwget-dns-caching — DNS caching, bestie edition

okay so this is libwget-dns-caching(3), a Library Functions Manual page, and it's literally all about DNS caching. no cap. it's part of the wget2 crew. let's get into it 🦋

---

✨ NAME ✨

libwget-dns-caching — DNS caching

like. that's it. that's the whole vibe. it caches DNS lookups so you're not out here asking the resolver the same question forty times like a clown 💀

---

🌸 SYNOPSIS 🌸

🎀 Data Structures

• struct cache_entry
• struct wget_dns_cache_st

🧚 Functions

int wget_dns_cache_init (wget_dns_cache **cache)
void wget_dns_cache_free (wget_dns_cache **cache)
struct addrinfo * wget_dns_cache_get (wget_dns_cache *cache, const char
    *host, uint16_t port)
int wget_dns_cache_add (wget_dns_cache *cache, const char *host,
    uint16_t port, struct addrinfo **addrinfo)

---

🔥 DETAILED DESCRIPTION 🔥

DNS cache management functions. that's the whole thing, bestie — the entire job of this lil library is keeping your DNS answers around so you don't have to go ask again. main character energy fr fr 💖

---

⭐ FUNCTION DOCUMENTATION ⭐

💜 int wget_dns_cache_init (wget_dns_cache ** cache)

Parameters

• cache — pointer to return newly allocated and initialized wget_dns_cache instance

Returns

• WGET_E_SUCCESS if OK
• WGET_E_MEMORY if out-of-memory
• WGET_E_INVALID if the mutex initialization failed

Allocates and initializes a wget_dns_cache instance. it's giving "birth of a cache" 🍼✨

---

💖 void wget_dns_cache_free (wget_dns_cache ** cache)

Parameters

• [in/out] cache — pointer to wget_dns_cache instance that will be freed and NULLified

Free the resources allocated by wget_dns_cache_init(). so like, when you're done with your lil cache baby, this is how you let it go. and yes, it NULLifies the pointer too, so no dangling drama afterward. iconic 🫶

---

🦋 struct addrinfo * wget_dns_cache_get (wget_dns_cache * cache, const char * host, uint16_t port)

Parameters

• cache — a wget_dns_cache instance, created by wget_dns_cache_init().
• host — hostname to look up
• port — port to look up

Returns

• the cached addrinfo structure, or NULL if not found

so you hand it a host + port and it's like "oh bestie I already know this one" and hands you back the cached addrinfo. if it doesn't know? NULL. no hard feelings 💀

---

🌈 int wget_dns_cache_add (wget_dns_cache * cache, const char * host, uint16_t port, struct addrinfo ** addrinfo)

Parameters

• cache — a wget_dns_cache instance, created by wget_dns_cache_init().
• host — hostname part of the key
• port — port part of the key
• [in/out] addrinfo — addrinfo structure to cache, returns cached addrinfo

Returns

• WGET_E_SUCCESS on success, else a WGET_E_* error value

this function adds addrinfo to the given DNS cache cache. 👑

If an entry for [host,port] already exists, addrinfo is free'd and replaced by the cached entry.

⚠️ do NOT free addrinfo yourself — this will be done when the whole cache is freed. like, hands off, bestie, that's not yours to yeet 🙈

---

👑 AUTHOR 👑

Generated automatically by Doxygen for wget2 from the source code. so nobody hand-wrote this, it's a robot's lil masterpiece, and honestly? it ate 💅

---

okay that's the whole page!! this was libwget-dns-caching(3) from the wget2 girlies, Version 2.3.0 — cache responsibly, free your caches, and never free an addrinfo you didn't own. periodt. 🎀✨🌸