MAILFILTER(1) User Manuals MAILFILTER(1) NNAAMMEE mailfilter - Filters e-mail, gets rid of spam SSYYNNOOPPSSIISS mmaaiillffiilltteerr [_O_P_T_I_O_N]... DDEESSCCRRIIPPTTIIOONN Mailfilter is a very flexible utility to get rid of unwanted spam mails, before having to go through the trouble of downloading them into the local computer. It offers support for one or many POP accounts and is especially useful for dialup connections via modem, ISDN, etc. Mailfilter connects to any POP mail box and compares part of its con- tent to a set of user defined filter rules. That way the spam gets deleted directly on the mail server. With Mailfilter you can define your own filters (rules) to determine which e-mails should be delivered and which are considered waste. Rules are Regular Expressions, so you can make use of familiar options from other mail delivery programs such as pprrooccmmaaiill(1) for example. RREETTUURRNN VVAALLUUEE The mailfilter program normally returns 0 but -1 if an error occurs. However, if it has been invoked with the return-value command line switch, it gives back a positive integer in case there are messages on the POP server. Empty POP accounts would then result in a return value of 0. Using the switch, mailfilter can be embedded into a shell script more easily. CCOONNFFIIGGUURRAATTIIOONN The behaviour of Mailfilter is controlled by command-line options and a configuration file. The program will not start without it. Example con- figurations can be looked up in the mmaaiillffiilltteerreexx(5) man page, in the INSTALL document or inside the doc/ directory of the Mailfilter distri- bution. By default Mailfilter tries to read $HOME/.mailfilterrc to get all its settings from. This is the place where all changes should be made, unless it is explicitly specified otherwise. A comprehensive list of all supported options and keywords can be found in the mmaaiillffiilltteerrrrcc(5) man page. OOPPTTIIOONNSS --hh, ----hheellpp Display help information --LL, ----llooggffiillee=_F_I_L_E Specify logfile location --MM, ----mmaaiillffiilltteerrrrcc=_F_I_L_E Specify rcfile location --rr, ----rreettuurrnn--vvaalluuee Enable additional return values --tt, ----tteesstt Simulate deletes --vv, ----vveerrbboossee=_L_E_V_E_L Specify level of verbosity --VV, ----vveerrssiioonn Display version information SSEEEE AALLSSOO mmaaiillffiilltteerrrrcc(5), mmaaiillffiilltteerreexx(5), pprrooccmmaaiill(1), rreeggeexx(7) CCOOPPYYRRIIGGHHTT Copyright (C) 2000-2007 Andreas Bauer This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Mailfilter June 2004 MAILFILTER(1)