CUFILTER(1p)

✨ CUFILTER ✨

okay so bestie, this is cufilter — the little Perl script that filters your emails through Mail::CheckUser, from the User Contributed Perl Documentation collection. it's giving procmail's bestie fr fr 💖

---

🦋 NAME

cufilter — filter emails through Mail::CheckUser 💅

---

🌸 SYNOPSIS

literally all you gotta do is add these lines to your ~/.procmailrc and you're golden:

# Filter mail through Mail::CheckUser
:0f
| /usr/bin/cufilter

no cap, that's it 🎀

---

💜 DESCRIPTION

so here's the tea ☕ — when email messages get filtered through this program using the procmail settings we just showed you in the SYNOPSYS (yes, it's spelled like that up there, iykyk), the email address sitting in the "From:" header gets passed through Mail::CheckUser to make sure it's actually valid. vibe check on your senders, basically ✨

and if there's a problem with that email address? the "Subject:" header gets modified to show which email address failed, along with the failure reason. it's literally the most helpful thing ever.

💖 important bestie note: no messages are lost. none. zero. the way this works is it just gives your mail client an easy way to organize, sort, or filter based on those little subject tweaks. main character energy for your inbox 👑

---

🌈 EXAMPLES

okay let's say a spammer (boooo 🍅) sends a message with these headers:

From: god@heaven.org
To: you@host.com
Subject: Happy Pill

then the new headers might change to the following:

From: god@heaven.org
To: you@host.com
Subject: [CU!god@heaven.org!DNS failure: SERVFAIL] Happy Pill

see how that [CU!...!DNS failure: SERVFAIL] got slapped on the front? 🫶 that makes it SO easy to filter for mail clients. ate and left no crumbs 💅

---

🧚 INSTALL

this file can be installed into /usr/bin/cufilter and is intended to be utilized through the procmail functionality by adding the following lines to your ~/.procmailrc configuration:

# Filter mail through Mail::CheckUser
:0f
| /usr/bin/cufilter

literally copy, paste, slay 💖

---

👑 AUTHORS

Rob Brown bbb@cpan.org

---

🎀 COPYRIGHT

Copyright (c) 2003 Rob Brown bbb@cpan.org. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

$Id: cufilter,v 1.3 2003/09/18 15:36:26 hookbot Exp $

---

💀 SEE ALSO

• Mail::CheckUser(3)
• procmail(1)

---

and that's the whole page bestie, ty for coming to my ted talk 🌟

sign-off szn: this lil number is from perl v5.34.0, dated 2022-06-15, and it lives under the CUFILTER(1p) man page name 💜 mwah, go filter some spam ✨