qmail-s3p

Section: User Commands (1)
Index Return to Main Contents
 

NAME

qmail-s3p - feed message through s3p filter  

SYNOPSIS

Invoked by qmail-qfilter

qmail-s3p [-hr] [-x s3p return code] [-d DNSBL message] [-v virus message] [-m MCPDB message] [-c CIC message] /path/to/s3p

 

DESCRIPTION

If the environment variable QMAILS3P is set and equal to "1", qmail-s3p will pass the message on stdin to s3p for processing. stdin must be a seekable file.

-h
Append a header ("X-S3P: Triggered [DNSBL|VIRUS|MCPDB|CIC] filter") to the message if the message triggers a filter.

-r
Reject the message if the message triggers a filter.

-x N
The exit code base returned by s3p.

-d message
If the message triggers the DNSBL filter , the string message is used in the SMTP response. Default is the standard qmail reject response ("mail server permanently rejected message (#5.3.0)").

-v message
If the message triggers the virus filter , the string message is used in the SMTP response. Default is the standard qmail reject notice.

-m message
If the message triggers the MCPDB filter , the string message is used in the SMTP response. Default is the standard qmail reject notice.

-c message
If the message triggers the CIC filter , the string message is used in the SMTP response. Default is the standard qmail reject notice.

SMTP response messages may be specified in environment variables by using a string of the form "env:ENVVARNAME".

 

USAGE

s3p must be configured to call qmail-s3p when it wants to queue the message. This is done with the q parameter in the s3p configuration file.

 

EXAMPLES

With qmail-qfilter: 

#!/bin/bash

export VMSG='Message classified as virus (#5.3.0)'
/path/to/qmail-qfilter \
        /path/to/qmail-s3p -r -v env:VMSG /path/to/s3p

 

Index

NAME
SYNOPSIS
DESCRIPTION
USAGE
EXAMPLES
This document was created by man2html, using the manual pages.
Time: 09:21:51 GMT, May 04, 2005