RAZOR-REVOKE(1p)

💖 RAZOR-REVOKE(1p) 💖

okay bestie, welcome to the User Contributed Perl Documentation corner of the universe, where razor-revoke lives. This is the manual page for it. Buckle up, it's giving "actually useful" ✨

---

✨ NAME ✨

razor-revoke — the Razor Revoking Agent 🫶

---

🌸 SYNOPSIS 🌸

razor-revoke [options]  file_with_mail_in_rfc822_format

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

---

🦋 DESCRIPTION 🦋

so like. razor-revoke is the Razor Revoking Agent, and its whole job is reporting messages as NOT spam to a Razor Nomination Server. Think of it as the apology tour for your mail. You'd run it if a check incorrectly marked a message as spam, or if a message got incorrectly reported as spam earlier. It should generally be called from a MUA (yeah, a mail user agent), though literally nobody is stopping you from running it from the command line. no cap.

razor-revoke is a filter, which means spam messages should be piped through it. And by default? it backgrounds and detaches itself from the control terminal at start-up. main character energy, it does not want to be perceived 👑

If razor-revoke gets passed more than one mail, it will revoke each one against the database. Please use this with caution — we do not want the database to have inaccurate information, bestie, that's so not the vibe. 😭

Here's the file situation: razor-revoke supports mbox-formatted files with 1 or more mails in them, AND files containing a single RFC 822 (non-mbox) mail. You can put more than one file on the command line — each can be non-mbox or mbox, in any order, go off. However, more than one non-mbox mail cannot be read from stdin. that's the rule.

Both razor-report(1) and razor-revoke require user authentication to work — peep razor-admin(1). This is so the Razor Nomination Server can 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. And 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. periodt. 💅

⚠️ Important lil caveat: even after a successful revoke, a mail might still be considered spam in the Razor Catalogue. For instance, this can happen if more trusted users consider the mail spam than not spam. So yeah. the trust economy is real. 💀

---

⭐ USAGE ⭐

razor-revoke takes the following arguments:

• -h — print a usage message and exit. bye 👋
• -v — print the version number and exit. ✨
• -d | --verbose — print debugging information. spill the tea, queen 🍓
• -debuglevel=n | -dl=n — set debug level to n. Default is 3 without the -d option, and 9 with it.
• -whitelist=file — specify file to use for whitelisting. Overrides the whitelist option in razor-agent.conf. 💖
• -s — simulate a check. Do everything except talk to the server. (the introvert option, honestly 🙈)
• -conf=filename — specifies an alternate configuration file. If not specified, it is computed, see the razor-agents(1) manpage for details. See the 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 the razor-agents(1) manpage for details.
• -logfile=file — specify file to log to instead of whats in the 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. 📬

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

• -i=filename — used identity from filename instead of reading <razorhome>/identity.
• -a — authenticate only. If authenticated, exit 0; if not, exit 1. it's giving binary, slay ✅❌
• -f — stay in foreground, do not detach and run in background. (the "please perceive me" flag 🥺)

---

🧚 INTEGRATION WITH MUTT 🧚

add this 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. Since razor-revoke forks, the control will return immediately. iconic behavior, no waiting around 💅

---

👑 AUTHORS 👑

Vipul Ved Prakash <mail@vipul.net>, and Chad Norwood <chad@samo.org>

(legends, fr fr 🫶)

---

🌈 SEE ALSO 🌈

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

go read them, iykyk 📚✨

---

💜 LICENSE 💜

This is free software, distributed under the Artistic License 2.0. 🎀

---

okay that's the whole page, bestie!! this was rendered for you by perl v5.40.1, dated 2025-05-24, and yes that's the RAZOR-REVOKE(1p) energy we're closing on 💖 bye, go revoke some spam, you got this 🌸