Apache Jakarta James - James 2.1 - Provided Matchers - Java Mail and News server, SMTP POP3 NNTP

James

- Overview
- James FAQ

Translated

- Japanese (web)

Downloads

- Binaries
- Source Code

Current Documentation

- James 2.1 Documentation
- James Javadocs
- Mailet API
- James and sendmail
- Useful RFCs

Older Documentation

- James Document Archive

Project

- Bug Database
- How Can I Contribute?
- Coding Standards
- License
- TODO
- Changelog
- Who We Are

Jakarta Information (web)

- Front Page
- News & Status
- Mailing Lists
- Get Involved
- CVS Repositories
- Reference Library
- FAQs

Related Projects (web)

- Jakarta
- Ant
- Avalon

Matchers

> James provides a number of implemented Matchers for use by James administrators in their configurations. These are primarily matchers that members of the James developer or user communities have found useful in their own configurations. A description of how to configure Matchers and use them in the James SpoolManager can be found here.

> All

> > Description: This matcher is the trivial one - it matches all mails being processed. All recipients are returned.

> > Configuration string: None.

> CommandForListserv

> > Description: The CommandForListserv matcher is used as a simple filter to recognize emails that are list server commands. It will match any email addressed to the list server host, as well as any email that is addressed to a user named <prefix>-on or <prefix>-off on any host. Only those matching recipients will be returned.

> > Configuration string: An email address of the form <prefix>@<host>, where host is the hostname used for the listserver and prefix is the command prefix.

> FetchedFrom

> > Description: A matcher intended for use with the FetchPOP server. It matches a custom header (X-fetched-from) that is set by the FetchPOP server. FetchPOP sets this header to the name of the FetchPOP task which originally fetched the message. All recipients are returned.

> > Configuration string: The name of the FetchPOP task which originally fetched the message.

> HasAttachment

> > Description: Matches those messages with a MIME type of "multipart/mixed". All recipients are returned.

> > Configuration string: None.

> HasHabeasWarrantMark

> > Description: Matches mails that have the Habeas Warrant (see http://www.habeas.com for details). All recipients are returned.

> > Configuration string: None.

> HasHeader

> > Description: Matches mails that have the specified header. All recipients are returned.

> > Configuration string: The name of the header whose presence determines the match.

> HostIs

> > Description: Matches mails that are sent to email addresses on hosts that are in the configuration list. Only recipients that are on one of the hosts are returned.

> > Configuration string: A list of host names, comma or space delimited.

> HostIsLocal

> > Description: Matches mails that are sent to email addresses on local hosts. Only recipients that are on one of the local hosts are returned.

> > Configuration string: None.

> InSpammerBlacklist

> > Description: Checks the mail against one of a number of mail-abuse.org IP lists.

> > Configuration string: One of three strings - "blackholes.mail-abuse.org", "relays.mail-abuse.org", or "dialups.mail-abuse.org".

> IsSingleRecipient

> > Description: Matches those messages sent to only a single recipient. The single recipient is returned.

> > Configuration string: None.

> NESSpamCheck

> > Description: A matcher derived from a Netscape Mail Server spam filter. If the matcher detects headers that indicate spam, the message is matched. All recipients are returned.

> > Configuration string: None.

> RecipientIs

> > Description: Matches mails that are sent to one of the recipients on a specified list. Only matching recipients are returned.

> > Configuration string: A list of recipient addresses, comma, tab, or space delimited.

> RecipientIsLocal

> > Description: Matches mails that are sent to email addresses on local hosts with users that have local acccunts. Only matching recipients are returned.

> > Configuration string: None.

> RelayLimit

> > Description: Counts the number of Received headers in the mail (each of which represents a server in the relay chain). If the number equals or exceeds the specified limit, the mail is matched. All recipients are returned.

> > Configuration string: a positive integer that is the limit on the number of relays.

> RemoteAddrInNetwork

> > Description: Checks the remote address from which the mail was received against the configured list. If the address matches one on the list, the matcher considers it a match. All recipients are returned.

> > Configuration string: A list of domain names, IP addresses, or wildcarded IP subnets of any class. The list may be comma or space delimited.

> RemoteAddrNotInNetwork

> > Description: Checks the remote address from which the mail was received against the configured list. If the address doesn't match one on the list, the matcher considers it a match. All recipients are returned.

> > Configuration string: A list of domain names, IP addresses, or wildcarded IP subnets of any class. The list may be comma or space delimited.

> SenderInFakeDomain

> > Description: Matches mails where the host name in the address of the sender cannot be resolved. All recipients are returned.

> > Configuration string: None.

> SenderIs

> > Description: Matches mails that are sent by one of the senders on a specified list. All recipients are returned.

> > Configuration string: A list of sender addresses, comma, tab, or space delimited.

> SizeGreaterThan

> > Description: Matches emails with a total message size (headers and body) greater than the specified limit. All recipients are returned.

> > Configuration string: a positive integer followed by an 'm' or a 'k'. This is the maximum message size permitted specified in megabytes or kilobytes respectively.

> SubjectIs

> > Description: Matches emails with the specified subject. All recipients are returned.

> > Configuration string: The string against which mail subject headers are matched.

> SubjectStartsWith

> > Description: Matches emails whose subject header starts with the specified string. All recipients are returned.

> > Configuration string: The string against which mail subject headers are matched.

> UserIs

> > Description: Matches mails that are sent to email addresses that have userids that are in the configuration list. Only matching recipients are returned.

> > Configuration string: A list of user names, comma or space delimited.

Copyright © 1999-2002, Apache Software Foundation