filter

Hurricane Electric Internet Services: Accounts starting at $9.95/month
Hurricane Electric Internet Services

NAME

       filter - filter incoming messages before adding to mailbox


SYNOPSIS

       filter [-q] [-v] [-l] [-o output] [-f rules-file]
       filter [-n] [-f rules-file]
       filter [-r] [-o output] [-f rules-file]
       filter [-c] [-s] [-o output] [-f rules-file]
       filter [-c] [-S] [-o output] [-f rules-file]


DESCRIPTION

       Filter uses a set of selection rules to  process  incoming
       mail  messages.   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 | sender

               relationship  ::=  =  |  !=

               relop  ::=  =  |  !=  |  <  |  >  |  <=  |  >=

               value  ::=  any  quoted  string

               numvalue  ::=  any  integer  value

       Action can be any of:

               delete
               save  foldername
               savecopy foldername
               execute  command
               executec  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).

       -f rules-file
                 Get rules from specified file instead of default
                 $HOME/.elm/filter-rules

       -l        Log actions only.  Do not log information  about
                 mailed messages.

       -n        Not  really.   Output what would happen if given
                 message from standard input, but don't  actually
                 do anything with it.

       -o file   Redirect  stdout  messages to the specified file
                 or device.  Logging of  filter  actions  is  not
                 affected.   (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.))

       -q        Quiet.  Do not log filtering actions.

       -r        Rules.  List the rules currently being used.

       -s        Summarize.  List a summary of the  message  fil-
                 tering 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

       Elm Development Group


FILES

       $HOME/.elm/filter-rules     Default rules file
       $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
       readmsg(1L), elm(1L), mail(1), mailx(1), sendmail(1,8)


COMMENTS

       Not really smart about pattern matching.



BUG REPORTS TO

       Syd Weinstein  elm@DSI.COM    (dsinc!elm)


COPYRIGHTS

       Copyright 1988-1992 by The USENET Community Trust
       Derived from Elm 2.0,  Copyright 1986, 1987 by Dave Taylor
Hurricane Electric Internet Services: Accounts starting at $9.95/month
Hurricane Electric Internet Services
Copyright (C) 1998 Hurricane Electric. All Rights Reserved.