RAZOR-WHITELIST(1)

💌 RAZOR-WHITELIST(1) — the vibes-only edition 🎀

okay bestie, so this is the manual for razor-whitelist, and honestly? it's the "do not disturb" list of the Razor universe. let's get into it ✨

---

🌸 NAME 🌸

razor-whitelist — the format spec for Vipul's Razor Whitelist. that's it, that's the icon.

---

💖 DESCRIPTION 💖

so the razor whitelist is literally just a list of email addresses and body signatures. that's the whole thing. no cap.

emails that match the whitelist are not processed by any of the Razor Agents. not checked, not reported, not revoked — they get the VIP velvet rope treatment and skip the whole queue. and in the case of razor-check(1), they're instantly marked as non-spam. periodt. no scan, no drama 🦋

---

🗂️ LOCATION 🗂️

the razor whitelist usually lives at <razorhome>/razor-whitelist. the whitelist parameter in razor-agent.conf(5) should point to this file — that's how it finds it, iykyk.

🫶 heads up: if the whitelist parameter in razor-agent.conf(5) is missing, then whitelist is just... not used. like it never existed. zero notes.

---

📝 FORMAT 📝

each whitelist rule gets a line of its own. main character energy, one rule per line, no crowding 💅

lines that begin with a # character count as comments and the parser just ignores them — they're background characters, not the plot.

a rule is made of two things: the name of a header, and the string to match against the header, separated by whitespace. that's the formula, bestie.

here are some examples:

to bugtraq@securityfocus.com
cc a.list@somewhere.net

these rules imply that when a mail contains bugtraq@securityfocus.com in its to and cc headers, it should be whitelisted 🎉

ngl it's worth noting that a match occurs if the address string matches any part of the address — so it's a "vibes match," not a whole-string thing. it just has to show up somewhere in there.

from @mydomain.com

and there's a special rule called sha1 for whitelisting signatures 👑 for example:

sha1 75f8bcc2357366bbfa9c6ab0b6e5648ed0cf7083

that one whitelists a message with the body of test. iconic behavior, truly.

---

🧚 AUTHORS 🧚

the legends behind this: Vipul Ved Prakash <mail@vipul.net>, and Chad Norwood <chad@samo.org>. give them their flowers fr fr 🌸

---

🔗 SEE ALSO 🔗

• razor-agents(1)
• razor-agent.conf(5)
• razor-check(1)
• razor-admin(1)
• razor-report(1)
• razor-revoke(1)

---

📜 LICENSE 📜

this is free software, distributed under the Artistic License 2.0. slay 💜

---

and that's the whole page, bestie 🫶 this cutie was brought to you by perl v5.44.0, dated 2026-10-17 — go off, perl. mwah 💋✨