---
name: "spfquery"
section: "1"
platform: "linux"
package: "libmail-spf-query-perl"
version: "1.997-2"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/spfquery"
---

# spfquery(1)

verifies SMTP sender ip, hello and address

## NAME

spfquery - verifies SMTP sender ip, hello and address

## SYNOPSIS

**spfquery \[**-v**\] \[** -file \<file\> **\|** *VERIFY OPTIONS* **\]**

## DESCRIPTION

**spfquery** *queries the SPF records for a DNS domain.  It then compares* *the arguments as specified in the optional commandline arguments or as read* *from standard input.*  **sqfquery** *will print the result of this comparison* *to standard output and exit with the appropriate error code.*

*For further details on SPF please visit* **http://spf.pobox.com/**

## COMMANDLINE SWITCHES

**-v** Display a brief help message and exit.

- **-file \<file\>**

  Read input from file.

## VERIFY OPTIONS

- **-ipv4=\[IP\_ADDRESS\]**

  The SMTP senders ipv4 IP address.

- **-sender=\[EMAIL\_ADDRESS\]**

  The envelope from address.

- **-helo=\[HELO\_HOST\]**

  The helo host specified by the SMTP sender.

## OUTPUT

- **pass**

  The specified client is a designated mailer for the senders domain.

- **error**

  Temporary failure while resolving designated mailer status for the senders  domain.

- **unknown**

  Senders domain does not designate permitted mailers.

- **fail**

  The specified client is not a designated mailer for the senders domain.

- **softfail**

  The specified client is not a designated mailer for the senders domain, however, the senders domain is still in the process of transitioning to SPF.

## EXAMPLES

**spfquery** -ipv4=127.0.0.1 -sender=me@example.com -help=mail.example.com

echo "127.0.0.1 my@example.com mail.example.com" \| **spfquery** -file -

## EXIT CODE

- **0**

  fail

- **1**

  softfail

- **2**

  unknown

- **3**

  error

- **4**

  pass

## SEE ALSO

**Mail::SPF::Query(3),** **spfd(8)**

## COPYRIGHT

**Copyright (C) 2003 - Meng Weng Wong \<mengwong+spf@pobox.com\>**

**All Rights Reserved.  This module is free software. It may be used,**  **redistributed and/or modified under the same terms as Perl itself.**

**See /usr/share/common-licenses/Artistic.**

## AUTHOR

The **spfquery** executable was written by Meng Weng Wong.

This manual page was written by S. Zachariah Sprackett.