Procmail

procmail is an email server software component — specifically, a message delivery agent (MDA).

Uses your system voice; voice and rate in settings.

Snapshot

≈ 6 min read

Names in other languages

No names in other languages are held for this entry yet.

Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.

procmail is an email server software component — specifically, a message delivery agent (MDA). It was one of the earliest mail filter programs. It is typically used in Unix-like mail systems, using the mbox and Maildir storage formats.

procmail was first developed in 1990, by Stephen R. van den Berg.[1] Philip Guenther took over maintainership for a number of years, but relinquished the role in 2014.[2] The software remained unmaintained for several years, and was believed to be defunct.[3] In 2020 May, Stephen van den Berg resumed maintenance again.[4] The program has since seen multiple releases and bug-fixes.

Uses

edit edit source

The most common use case for procmail is to filter mail into different mailboxes, based on criteria such as sender address, subject keywords, and/or mailing list address.[5][6]

Another use is to let procmail call an external spam filter program, such as SpamAssassin. This method can allow for spam to be filtered or deleted.

The procmail developers have built a mailing list manager called SmartList[7] on top of procmail.[8]

Procmail is an early example of a mail filtering tool and language. It is a data-driven programming language, similar to earlier line-oriented languages such as sed and AWK.

Operation

edit edit source

procmail reads mail messages given to it on standard input, delivering or otherwise dispositioning each one. procmail is typically not invoked directly by the user. Rather, some other mail program will call upon procmail to deliver a message according to the user's wishes. Message transfer agents (MTAs), such as Sendmail or Postfix), can be configured to use procmail to deliver all mail. A mail retrieval agent such as fetchmail can invoke procmail as needed. The companion tool formail allows procmail to be applied to mail already in a mailbox.

procmail's behavior is controlled by a config file (by default, .procmailrc in the user's home directory) containing one or more recipes, read in order. Each recipe consists of a mode, zero or more conditions, and an action.

Conditions are usually extended regular expressions, although there are other forms. A recipe's action is taken only if all the conditions match (logical AND). If no conditions is given, the recipe is unconditional and the action always runs.

The action specifies what is to be done with the message, such as deliver it to a particular mailbox, or discard it. A recipe and its action can be delivering or non-delivering. Processing of a given message stops with the first delivering recipe (unless the recipe's mode flag specifies otherwise).

Example

edit edit source

A simple .procmailrc config file might look like this:

MAILDIR=$HOME/mail DEFAULT=$MAILDIR/inbox :0: * ^List-Id: .*<foo-announce@lists.example.com> foo-announce

The above routes mail from a hypothetical mailing list to a separate mailbox called foo-announce, while delivering all other mail to the inbox mailbox, both located under the $HOME/mail/ directory.

Criticism

edit edit source

By default, procmail will "bounce" undeliverable mail back to the sender, or discard it entirely. A mistake in the config file can result in all mail being rejected or discarded.

The configuration file format is sometimes regarded as cryptic.

procmail is not well-suited for processing mail involving Multipurpose Internet Mail Extensions (MIME). It cannot decode or recognize MIME-specific headers or international characters.

For approximately ten years, procmail was not maintained, and multiple serious security vulnerabilities[9] were discovered in the intervening time span[3] (since fixed).

See also

edit edit source

Mail architecture

edit edit source

Similar programs and technologies

edit edit source

References

edit edit source
  1. ^ "README". 2022-03-02. Retrieved 2022-04-26. Copyright (c) 1990-2022, S.R. van den Berg, The Netherlands. Copyright (c) 1997-2005, Philip Guenther, The United States of America. Wikipedia revision 1357126670, retrieved 2026-11-18
  2. ^ Gunther, Philip (2014-11-18). "please remove the procmail port". ports@ (Mailing list). OpenBSD. Retrieved 2019-02-25. Wikipedia revision 1357126670, retrieved 2026-11-18
  3. ^ a b Willis, Nathan (24 November 2010). "Reports of procmail's death are not terribly exaggerated". Linux Weekly News. Retrieved 27 October 2013. Wikipedia revision 1357126670, retrieved 2026-11-18
  4. ^ Stephen R. van den Berg (2022-03-02). "#1006633: procmail is unmaintained upstream". Retrieved 2022-04-26. As of May 2020, the dormant state of procmail upstream maintenance has been changed back to active. As Santiago Vila can attest to, I have taken up active maintenance of procmail again since the past two years ... Wikipedia revision 1357126670, retrieved 2026-11-18
  5. ^ Wells, Nicholas; Jang, Michael (3 October 2018). Guide to Linux Installation and Administration. Cengage Learning EMEA. ISBN 9780619000974 – via Google Books. Wikipedia revision 1357126670, retrieved 2026-11-18
  6. ^ Levine, John (24 March 2004). qmail: Managing Unix-Based Mail Systems. O'Reilly Media, Inc. ISBN 9780596552121 – via Google Books. Wikipedia revision 1357126670, retrieved 2026-11-18
  7. ^ SmartList repo Wikipedia revision 1357126670, retrieved 2026-11-18
  8. ^ SmartList Documentations Wikipedia revision 1357126670, retrieved 2026-11-18
  9. ^ "CVEdetails: Procmail Vulnerabilities". CVEdetails.com. 2018-02-03. Retrieved 2020-05-02. Wikipedia revision 1357126670, retrieved 2026-11-18

Further reading

edit edit source
  • McCarthy, Martin (November 2001). The Procmail Companion. Addison-Wesley. ISBN 978-0201737905.
edit edit source

Text derived from https://en.wikipedia.org/w/index.php?oldid=1357126670 under CC BY-SA 4.0; modifications have been made.