


FILTER(1L)        MISC. REFERENCE MANUAL PAGES         FILTER(1L)



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
     _F_i_l_t_e_r uses a set of selection  rules  to  process  incoming
     mail  messages.   The  format  for  the  rules,  located  in
     $HOME/.elm/filter-rules, is;

             _r_u_l_e  ::=  if  (_e_x_p_r_e_s_s_i_o_n)  then  _a_c_t_i_o_n

     where _e_x_p_r_e_s_s_i_o_n is:

             _e_x_p_r_e_s_s_i_o_n  ::=  {  not  }  _c_o_n_d_i_t_i_o_n  _e_x_p_r_2

             _e_x_p_r_2  ::=  _N_U_L_L  |  and  _c_o_n_d_i_t_i_o_n  _e_x_p_r_2

             _c_o_n_d_i_t_i_o_n  ::=  _f_i_e_l_d  _r_e_l_a_t_i_o_n_s_h_i_p  _v_a_l_u_e
                        ::=  lines  _r_e_l_o_p  _n_u_m_v_a_l_u_e
     or                 ::=  always

     These further break down as:

             _f_i_e_l_d  ::=  from  |  subject  |  to  |  lines | sender

             _r_e_l_a_t_i_o_n_s_h_i_p  ::=  =  |  !=

             _r_e_l_o_p  ::=  =  |  !=  |  <  |  >  |  <=  |  >=

             _v_a_l_u_e  ::=  _a_n_y  _q_u_o_t_e_d  _s_t_r_i_n_g

             _n_u_m_v_a_l_u_e  ::=  _a_n_y  _i_n_t_e_g_e_r  _v_a_l_u_e

     _A_c_t_i_o_n can be any of:

             delete
             save  _f_o_l_d_e_r_n_a_m_e
             savecopy _f_o_l_d_e_r_n_a_m_e
             execute  _c_o_m_m_a_n_d
             executec  _c_o_m_m_a_n_d
             forward  _a_d_d_r_e_s_s
             leave

     For further information about the rules language, please see
     _T_h_e _E_l_m _F_i_l_t_e_r _G_u_i_d_e.




USENET Community TrustLast change: Elm Version 2.4                 1






FILTER(1L)        MISC. REFERENCE MANUAL PAGES         FILTER(1L)



     The flags the _f_i_l_t_e_r 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 _r_u_l_e_s-_f_i_l_e
               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 _f_i_l_e   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  filter-
               ing 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
     _T_h_e _E_l_m _F_i_l_t_e_r _G_u_i_d_e
     readmsg(1L), elm(1L), mail(1), mailx(1), sendmail(1,8)





USENET Community TrustLast change: Elm Version 2.4                 2






FILTER(1L)        MISC. REFERENCE MANUAL PAGES         FILTER(1L)



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














































USENET Community TrustLast change: Elm Version 2.4                 3



