SPFQUERY(1) User Contributed Perl Documentation SPFQUERY(1)

NAME
       spfquery - checks if an IP address is an SPF-authorized SMTP sender for
       a domain

VVEERRSSIIOONN
       2.3

SYNOPSIS
       ssppffqquueerryy --mmaaiill-ffrroomm|-mm|--sseennddeerr|-ss email-address|domain --hheelloo|-hh
       hostname --iipp|-ii ip-address [OPTIONS]

       ssppffqquueerryy --hheelloo|-hh hostname --iipp|-ii ip-address [OPTIONS]

       ssppffqquueerryy --ffiillee|-ff filename|- [OPTIONS]

       ssppffqquueerryy --vveerrssiioonn|-VV

       ssppffqquueerryy --hheellpp

DESCRIPTION
       ssppffqquueerryy performs Sender Policy Framework (SPF) authorization checks
       based on the command-line arguments or data given in a file or on
       standard input.  For information on SPF see .

       The --mmaaiill-ffrroomm form checks if the given ip-address is an authorized
       SMTP sender for the given envelope sender domain or email-address and
       "HELO" hostname (so-called "MAIL FROM" check).  If a domain is given,
       "postmaster" will be substituted for the localpart.

       The --hheelloo form checks if the given ip-address is an authorized SMTP
       sender for the given "HELO" hostname (so-called "HELO" check).

       The --ffiillee form reads "ip-address sender-address helo-hostname" tuples
       from the file with the specified filename, or from standard input if
       filename is -.

       The --vveerrssiioonn form prints version information of spfquery.  The --hheellpp
       form prints usage information for spfquery.

OOPPTTIIOONNSS
       The --mmaaiill-ffrroomm, --hheelloo, and --ffiillee forms optionally take any of the
       following additional OPTIONS:

       --ddeebbuugg
           Print out debug information.

       --ddeeffaauulltt-eexxppllaannaattiioonn string
           Use the specified string as the default explanation if the SPF
           record does not specify an explanation string itself.

       --gguueessss spf-terms
           Use spf-terms as a default record if no SPF record is found.  TThhiiss
           iiss aa nnoonn-ssttaannddaarrdd ffeeaattuurree..

       --kkeeeepp-ccoommmmeennttss
       --nnoo-kkeeeepp-ccoommmmeennttss
           Do (not) print any comments found when reading from a file or from
           standard input.

       --llooccaall spf-terms
           Process spf-terms as local policy before resorting to a default
           result (the implicit or explicit "all" mechanism at the end of the
           domain's SPF record).  For example, this could be used for white-
           listing one's secondary MXes: "mx:mydomain.example.org".

       --mmaaxx-llooookkuupp-ccoouunntt n
           Perform a maximum of n SPF record lookups.  Defaults to 1100.

       --nnaammee hostname
           Use hostname as the hostname of the local system instead of auto-
           detecting it.

       --oovveerrrriiddee domain==spf-record
       --ffaallllbbaacckk domain==spf-record
           Set overrides and fallbacks.  Each option can be specified multiple
           times.  For example: "-override example.org='v=spf1 -all'
           -override '*.example.net'='v=spf1 a mx -all' -fallback
           example.com='v=spf1 -all'".  TThhiiss iiss aa nnoonn-ssttaannddaarrdd ffeeaattuurree..

       --rrccpptt-ttoo email-addresses
           Automatically allow the secondary MXes of the comma-separated list
           of email-addresses.

       --ssaanniittiizzee
       --nnoo-ssaanniittiizzee
           Do (not) sanitize the output by condensing consecutive white-space
           into a single space and replacing non-printable characters with
           question marks.  Enabled by default.

       --ttrruusstteedd
       --nnoo-ttrruusstteedd
           Do (not) perform "trusted-forwarder.org" accreditation checking.
           Disabled by default.  TThhiiss iiss aa nnoonn-ssttaannddaarrdd ffeeaattuurree..

RREESSUULLTT CCOODDEESS
       ppaassss      The specified IP address is an authorized mailer for the
                 sender domain/address.

       ffaaiill      The specified IP address is not an authorized mailer for the
                 sender domain/address.

       ssooffttffaaiill  The specified IP address is not an authorized mailer for the
                 sender domain/address, however the domain is still in the
                 process of transitioning to SPF.

       nneeuuttrraall   The sender domain makes no assertion about the status of the
                 IP address.

       uunnkknnoowwnn   The sender domain has a syntax error in its SPF record.

       eerrrroorr     A temporary DNS error occurred while resolving the sender
                 policy.  Try again later.

       nnoonnee      There is no SPF record for the sender domain.

EEXXIITT CCOODDEESS
       00   pass

       11   fail

       22   softfail

       33   neutral

       44   unknown

       55   error

       66   none

EEXXAAMMPPLLEESS
           spfquery -i 11.22.33.44 -m user@example.com -h spammer.example.net
           spfquery -f testdata
           echo "127.0.0.1 user@example.com helohost.example.com" | spfquery -f -

SEE ALSO
       Mail::SPF::Query, spfd

AUTHORS       This version of ssppffqquueerryy was written by Wayne Schlitt
       .

       This man-page was written by Julian Mehnle , based
       on a man-page written by S. Zachariah Sprackett for an older version of
       ssppffqquueerryy.



perl v5.8.8                       2006-01-22                       SPFQUERY(1)