RAZOR-REVOKE(1)

💖 RAZOR-REVOKE(1) 💖

okay bestie, so this is the razor-revoke page from the User Contributed Perl Documentation section of your manual — and it's a whole moment. Sit down, hydrate, and let's get into it. 🫶

✨ NAME ✨

razor-revoke — the Razor Revoking Agent. yes, that's her whole job title, she's booked and busy. 💅

🌸 SYNOPSIS 🌸

razor-revoke [options]  file_with_mail_in_rfc822_format

$ cat mail | razor-revoke
$ razor-revoke ./mail
$ razor-revoke -d ./mail

like, feed her mail and she revokes it. iconic behavior tbh. ✨

🦋 DESCRIPTION 🦋

okay so razor-revoke is the Razor Revoking Agent, and what she does is report messages to a Razor Nomination Server as NOT spam. the way that works is — say a check lowkey incorrectly marked a message as spam, or a message got incorrectly reported as spam, you'd call this to undo it. razor-revoke should generally get called from an MUA, but honestly there's no restriction on running her straight from the command line either. she's a filter, bestie, which means spam messages get piped through her. and heads up: by default razor-revoke backgrounds and detaches itself from the control terminal at start-up. main character entrance, honestly. 🎀

if you pass razor-revoke more than one mail, she'll revoke each one against the database. ⚠️ please use this with caution — we do NOT want the database to be holding inaccurate info, that's giving chaos. razor-revoke supports mbox-formatted files with 1 or more mails in them, AND files containing a single RFC 822 (non-mbox) mail. more than one file may be present on the command line, and they can be either non-mbox or mbox in any order. however — and this is the one — more than one non-mbox mail cannot be read from stdin. periodt. 💀

both razor-report(1) and razor-revoke require user authentication to work, see razor-admin(1). this lets the Razor Nomination Server keep track of how many messages a user reports and revokes. the more messages a user correctly reports and/or correctly revokes, the more trust that user earns. 👑 likewise, when messages are incorrectly reported or revoked, the trust goes down for that user. highly trusted users will have the most affect on the Razor database. slay, i guess, with great power etc etc.

ngl, one thing you need to know: even after a successful revoke, a mail might still be considered spam in the Razor Catalogue. for instance, this can occur if more trusted users consider the mail spam than not spam. 😭 so don't come for her if it doesn't stick.

---

🌈 USAGE 🌈

razor-revoke takes following arguments:

• -h — print a usage message and exit. cute and simple.
• -v — print the version number and exit. 🎀
• -d | --verbose — print debugging information. she's telling you everything.
• -debuglevel=n | -dl=n — set debug level to 'n'. default is 3 without -d option, 9 with. so like, -d really turns the volume up.
• -whitelist=file — specify file to use for whitelisting. overrides 'whitelist' option in razor-agent.conf. 💖
• -s — simulate a check. do everything except talk to the server. she's practicing her lines, no cap.
• -conf=filename — specifies an alternate configuration file. if not specified, it is computed, see razor-agents(1) manpage for details. see razor-agent.conf(5) manpage for various configuration options. the default is <razorhome>/razor-agent.conf.
• -home=dir — specify razorhome directory. this is where the configuration file, logfiles, identities, and server files live. if not specified, it is computed, see razor-agents(1) manpage for details. 🏠
• -logfile=file — specify file to log to instead of whats in configuration file. the default is <razorhome>/razor-agent.log.
• -ident=filename — specify an identify file to use for authenticating with Razor Servers. if not specified, <razorhome>/identity-<user> is used. 🔥
• -rs=razor.server.com — use this Razor Nomination Server instead of reading servers.nomination.lst.
• -M | --mbox — accept a mailbox name on the command line and revoke every mail in the mailbox against the database. if in foreground, -f, razor-revoke will print out the mail number of every mail that was accepted by the Catalogue server. iykyk 👀

C<razor-revoke -f -M ~/Mail/incorrectly-marked-spam>

(yes that's literally how it's written in the original, we don't editorialize ✨)

• -i=filename — used identity from filename instead of reading <razorhome>/identity.
• -a — authenticate only. if authenticated, exit 0; if not, exit 1. vibe check: passed or failed. ✅
• -f — stay in foreground, do not detach and run in background. she's staying right here with you. 🫶

---

💜 INTEGRATION WITH MUTT 💜

add the following line to mutt.conf:

macro index R "|/usr/bin/razor-revoke"

then press R on the spam message in mutt to report it with razor-revoke. and since razor-revoke forks, the control will return immediately. no waiting around, we love a fast queen. 💅

---

🎀 AUTHORS 🎀

Vipul Ved Prakash <mail@vipul.net>, and Chad Norwood <chad@samo.org> — legends, both of them. 👑

⭐ SEE ALSO ⭐

razor-agents(1), razor-agent.conf(5), razor-check(1), razor-admin(1), razor-report(1), razor-whitelist(5)

🌸 LICENSE 🌸

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

---

and that's the whole page, bestie! 🌈 this one's rocking perl v5.44.0 and is dated 2026-10-17 — so like, future icon behavior. go revoke responsibly, mwah 💖✨