FILTER
Section: Misc. Reference Manual Pages (1L)
Updated: Elm Version 2.3
Index
Return to Main Contents
NAME
filter - filter incoming messages before adding to mailbox
SYNOPSIS
filter
[-v] [-o output]
filter
[-n]
filter
[-r] [-o output]
filter
[-c] [-s] [-o output]
filter
[-c] [-S] [-o output]
DESCRIPTION
Filter
is a sophisticated program that allows incoming mail to be
filtered against a wide set of criteria. The format for the
rules, located in $HOME/.elm/filter-rules, is;
rule ::= if (expression) then action
where expression is:
expression ::= { not } condition expr2
expr2 ::= NULL | and condition expr2
condition ::= field relationship value
::= lines relop numvalue
or ::= always
These further break down as:
field ::= from | subject | to | lines
relationship ::= = | !=
relop ::= = | != | < | > | <= | >=
value ::= any quoted string
numvalue ::= any integer value
Action can be any of:
delete
save foldername
savecopy foldername
execute command
forward address
leave
For further information about the rules language, please see
The Elm Filter Guide.
The flags the filter program understands are;
- -c
-
Clear logs. If this flag is used, the log files will be removed after
being summarized by either "-s" or "-S" (see below).
- -n
-
Not really. Output what would happen if given message from standard
input, but don't actually do anything with it.
- -o file
-
Redirect all log messages to the specified file or device. (This is
added to more gracefully deal with changes in the file system (since
sendmail is quite picky about modes of files being redirected into.))
- -r
-
Rules. List the rules currently being used.
- -s
-
Summarize. List a summary of the message filtered log.
- -S
-
This is the same as `-s' but includes message-by-message
information additionally.
- -v
-
Verbose. Give output on standard out for each message filtered. Useful
to have redirected to ``/dev/console'' and such. (see -o too).
AUTHOR
Dave Taylor, Hewlett-Packard Laboratories.
FILES
$HOME/.elm/filter-rules The ruleset for the users filter
$HOME/.elm/filterlog A log of what has been done
$HOME/.elm/filtersum A summary of what has been done
/etc/passwd Used to get users home directory
SEE ALSO
The Elm Filter Guide, by Dave Taylor.
readmsg(1L), elm(1L), mail(1), mailx(1), sendmail(1,8)
COMMENTS
Not real smart about pattern matching.
BUG REPORTS TO
Syd Weinstein elm@DSI.COM (dsinc!elm)
COPYRIGHTS
© Copyright 1986, 1987 by Dave Taylor
© Copyright 1988, 1989, 1990 by The USENET Community Trust
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- AUTHOR
-
- FILES
-
- SEE ALSO
-
- COMMENTS
-
- BUG REPORTS TO
-
- COPYRIGHTS
-
This document was created by
man2html,
using the manual pages.
Time: 22:31:57 GMT, February 10, 2023