Provided by: postfix-policyd-spf-python_0.8.1-2_all bug

NAME

       python-policyd-spf - pure-Python Postfix policy daemon for SPF checking

VERSION

       0.8

USAGE

       Usage:
         policyd-spf [/etc/policyd-spf/policyd-spf.conf]

OTHER DOCUMENTATION

       This documentation assumes you have read Postfix's README_FILES/
       SMTPD_POLICY_README and are generally familiar with Sender Policy
       Framework (SPF).  See RFC 4408 for details.

       man 1 policyd-spf provides general operation documentation for this
       package.

       See man 5 policyd-spf.conf for configuration file information.

SYNOPSIS

       python-policyd-spf operates with a default installed configuration file
       and set of default configuration options that are used if the
       configuration file cannot be found.  These options can be changed by
       changing the installed configuration files or through giving a path to
       an alternate configuration file.

       Additionally, different configurations can be provided on a per user
       basis.  This man page describes setup and user of per user (mail
       recipient) configurations.  Currently these configurations can either
       be stored in a text file or a Berkeley DB (libdb) datase.  If there is
       sufficient interest, other data storage methods may be supported in the
       future.

DESCRIPTION

       Use of per-user configuration is defined in the application
       configuration file with the setting "Per_User".  The value of the
       setting gives the type and location of the per-user configuration
       information.  Currently supported types are text and bsddb.  User is
       defined an email address of a recipient of the message.

       All options available at the application level (See man 5 policyd-
       spf.conf) can be adjusted on a per-user basis.  Per-user checks can
       only be done as part of smtpd_recipient_restrictions.  Per-user actions
       are not possible at other stages of the SMTP dialogue.  The user is not
       yet known for smtpd_client_restrictions, smtpd_helo_restrictions, or
       smtpd_sender_restrictions.  If used during smtpd_data_restrictions or
       smtpd_end_of_data_restrictions, the entire message will be available
       only if the message was only to a single recipient.  If per-user
       configurations are used when recipient information is not available,
       warnings will be logged and the per-user information will be ignored.

       In addition to specifying individual users, regular expression matching
       is also available, but may have performance implications since the
       entire user table has to be traversed for each message recipient.

OPTIONS

Text Per-User Configuration File

       The text file option is useful for testing and when only a small number
       of users require per-user configurations.  It is specified in the main
       configuration file:

       "Per_User = text,/etc/pypolicyd-spf/userconf"

       Lines beginning with "#" are treated as comments and ignored.  The
       location of the file is determined by the system administrator. No
       default file is provided in or installed by the package.

       The configuration of the file is a comma separated combination of user
       and configuration information, with one line per user's configuration
       information (NOTE: due to man page formating requirements, these lines
       are wrapped - in the config file, it must be one line per user):

       postmaster@example.com,{'Mail_From_reject'='No_Check'|'PermError_reject'=
       'False'|'HELO_reject'='SPF_Not_Pass'|'defaultSeedOnly'= 1|'debugLevel'=
       5|'skip_addresses'='127.0.0.0/8,::ffff:127.0.0.0//104,::1//128'|
       'TempError_Defer'='False'}
       strict@example.com,{'PermError_reject'='True'|'HELO_reject'=
       SPF_Not_Pass'|  'TempError_Defer'='True'}

       It is not necessary to specify all configuration parameters for each
       user, only those that are different than the overall configuration need
       to be specified.

SEE ALSO

       man 1 policyd-spf, man 5 policyd-spf.conf, python-spf,
       <http://www.openspf.org>, RFC 4408

AUTHORS

       This version of pypolicyd-spf was written by Copyright (C) 2007,
       2008,2009,2010 Scott Kitterman <scott@kitterman.com>.  It is derived
       from Tumgreyspf, written by Sean Reifschneider, tummy.com, ltd
       <jafo@tummy.com>.

       This man-page was created by Scott Kitterman <scott@kitterman.com>.

                                  2010-01-19             policy-spf.peruser(5)