ZBLOCKLIST(1)

💅 ZBLOCKLIST — the zmap IP blocklist tool, bestie edition

okay so you're holding a manual page for zblocklist, which lives in section 1 of the manual. it's the zmap IP blocklist tool and honestly? it's giving gatekeeper energy in the best way. let's get into it 🫶

✨ NAME ✨

zblocklist — the zmap IP blocklist tool. that's it, that's the name, she's iconic 💖

🌸 SYNOPSIS 🌸

zblocklist [ -b <blocklist> ] [ -w <allowlist> ] [ OPTIONS... ]

like, that's the whole vibe. pass a blocklist, or an allowlist, or honestly just vibe with OPTIONS. slay.

🦋 DESCRIPTION 🦋

so ZBlacklist is a network tool, right? and what she does is limit and deduplicate a list of IP addresses — using either a blocklist or an allowlist. no cap, that's the whole job. limiting + deduping, and she eats every time 👑

🎀 OPTIONS 🎀

🌈 BASIC OPTIONS 🌈

• -b, --blocklist-file=path — a file full of subnets to exclude, written in CIDR notation, one per line. and bestie, it is recommended you use this to exclude RFC 1918 addresses, multicast, IANA reserved space, and other IANA special-purpose addresses. there's an example blocklist file called blocklist.conf made exactly for this purpose. use it, fr fr 🙏
• -w, --allowlist-file=name — the opposite queen 💅 a file of subnets to include, CIDR notation, one per line. every other subnet that isn't on this list? excluded. bye.
• -l, --log-file=name — the file you want to log to. that's it. that's the tea ☕
• --disable-syslog — turns off logging messages to syslog. sometimes you just don't want syslog in the group chat, y'know? 🙈
• -v, --verbosity — how much log detail you want, on a scale of 0–5, and the default is 3. so mid. perfectly mid. balanced, as all things should be ⚖️
• --no-duplicate-checking — don't deduplicate input addresses. default is false. (so by default she does dedupe — she's tidy like that 🧚)
• --ignore-blocklist-errors — ignore invalid, malformed, or unresolvable entries in the blocklist/allowlist. default is false. so like, she'll usually call them out. respect 😌
• --ignore-input-errors — don't print invalid entries in the input. default is false. default behavior is printing them, which is honestly so real of her 💀

⭐ ADDITIONAL OPTIONS ⭐

• -h, --help — print help and exit. the classic. the icon. the blueprint 📖
• -V, --version — print version and exit. capital V, bestie, don't mix it up with lowercase -v or you'll be adjusting verbosity instead of checking the version 😭

ngl the option list is short and sweet but every single flag up there matters — don't skip the boring-looking ones, they're load-bearing 🫶

this page comes to you from the fine folks at ZMap, and the version we're looking at is dated February 2024 💜 that's the whole manual, bestie — go block some IPs responsibly and stay hydrated 🌸✨