rbldns-data(8)

💖 rbldns-data — data tool for rbldns 💖

okay bestie, so this one's from the System Manager's Manual, and it's literally the little data goblin that feeds rbldns(8). it's giving backstage crew energy — never on the poster, always doing the work. 🎀

✨ NAME ✨

rbldns-data — data tool for rbldns

🌸 DESCRIPTION 🌸

okay so here's the whole vibe: rbldns-data reads an IP address list from a file named data in the current directory. then it creates data.cdb in a binary format designed for fast access by rbldns(8). it may also create some other files with names beginning with data. no cap, it just shows up, does its thing, and leaves. 💅

and here's the iconic part: rbldns-data updates data.cdb atomically, so you can use it safely while rbldns(8) is running. 🫶

⚠️ but if anything goes wrong with the creation of data.cdb, rbldns-data stops and leaves the old data.cdb in place. so like… no half-baked file, no chaos. it either slays or it steps back. periodt.

🦋 Data format 🦋

here's where you write your little entries, and each one has a very specific job. pay attention bestie, this is the main character section. 👑

• ip

the IP address ip is on the list. simple as that. ✨

• ip/n

all IP addresses that share the first n bits of the IP address ip are on the list. for example, 1.2.3.0/24 means all 1.2.3.* addresses. 🔥

🚨 okay important: n must be at least 8, and all bits past the nth in ip must be 0. like, that's the rule, don't fight it.

• :a:txt

DNS queries for addresses on the list will receive an A record of a and a TXT record of txt. typically a is 127.0.0.2 and txt is a pointer to a web page about the list. cute, right? 🎀

if txt ends with $, rbldns(8) replaces the $ with the IP address. 🪄 (not me thinking that's lowkey iconic)

• #comment

comment line. the line is ignored. it's just there to look pretty, and honestly? valid. 💅

🌈 SEE ALSO 🌈

• rbldns(8)
• http://cr.yp.to/djbdns.html

and that's the whole page, bestie!! 🦋✨ it's from the System Manager's Manual, filed under rbldns-data(8), and yeah — that's literally the same name as the header because manpages love a full-circle moment. 🫶 go make your data file, run it, and let the atomic update do its thing. mwah. 💖🎀👑