NAME

f-prot-milter - Sendmail/libmilter plugin for F-PROT Antivirus Mail Scanner

 

SYNTAX

fp-milter -p <socket address>

Note that fp-milter is not intended to be started as a stand-alone program.

 

DESCRIPTION

fp-milter is a plugin for the libmilter framework for Sendmail. It should be started via the "--milter" argument to scan-mail.pl(8)
It works by listening on the address given by its -p command line option for connections from Sendmail. When Sendmail receives an e-mail message, it notifies fp-milter , which checks if the optional {FP_SCANONLY} sendmail macro exists and if so it parses it as a list of colon separated regular expressions which are applied to the recipient addresses of the mail. If one or more recipient address match a regular expression, or if the {FP_SCANONLY} macro is undefined, then fp-milter will scan the e-mail. fp-milter doesn't actually scan the e-mail itself, but instead requests a scan from scan-mail.pl(8)
via a TCP/IP connection to port 11200 on the loopback address. After scan-mail.pl(8)
finishes scanning the e-mail, fp-milter hands the scanned e-mail to sendmail.
For fp-milter to work, scan-mail.pl must be running with either the -milter, -server or -daemon command line options

 

COMMANDLINE OPTIONS

-p socket address

This option sets the address at which fp-milter listens for connections from sendmail(8)
The format of this string is "local:/path/to/socket" for UNIX sockets, and "inet:port@host" for TCP/IP sockets.

 

SENDMAIL CONFIGURATION

Some configuration of sendmail is required. Add the following two lines into sendmails .mc file to instruct sendmail to pipe in-transit mail to fp-milter:

define(`_FFR_MILTER', `true')
INPUT_MAIL_FILTER(`fp-milter', `S=<socket address>, F=T, T=E:8m;C:5m;R:4m;S:2m')

-p <socket address> is the same address f-prot-milter should receive with it's "-p" command line option, for example inet:12200@127.0.0.1.

Optionally, add these 3 lines to your sendmail.mc file to restrict scanning to recipient addresses matching a list of regular expressions:

define(`confMILTER_MACROS_ENVRCPT', `{rcpt_mailer}, {rcpt_host}, {rcpt_addr}, {FP_SCANONLY}')
LOCAL_CONFIG
D{FP_SCANONLY}@domain1\\.net$$:@domain2\\.net$$:@domain3\\.net$$

After editing your sendmail.mc file, recompile the sendmail.cf file using the Makefile included with sendmail (make sure you have the sendmail-cf package installed, or equivalent). Then restart sendmail.

 

LICENSING

For information about Licensing, see the LICENSE file that comes with F-PROT Antivirus.

 

CONTACT INFORMATION

Please direct any feedback to:

http://www.f-prot.com/support/contact_support.html

Updates will be advertised on: http://www.f-prot.com/

 

SEE ALSO

f-prot.conf(5)
scan-mail.pl(8)
sendmail(8)