EXIM_CHECKACCESS(8)                                           System Manager's Manual                                          EXIM_CHECKACCESS(8)

NAME

       exim_checkaccess - Check address acceptance from given IP

SYNOPSIS

       exim_checkaccess IP-address email@address [more Exim options]

DESCRIPTION

       Exim's  -bh command line argument allows you to run a fake SMTP session with debugging output, in order to check what Exim is doing when it
       is applying policy controls to incoming SMTP mail.  However, not everybody is sufficiently familiar with the SMTP protocol to  be  able  to
       make  full  use of -bh, and sometimes you just want to answer the question "Does this address have access?" without bothering with any fur-
       ther details.

       The exim_checkaccess utility is a 'packaged' version of -bh.  It takes two arguments, an IP address and an email address:

         exim_checkaccess 10.9.8.7 A.User@a.domain.example

       The utility runs a call to Exim with the -bh option, to test whether the given email address would be accepted  in  a  RCPT  command  in  a
       TCP/IP  connection  from  the  host  with the given IP address.  The output of the utility is either the word 'accepted', or the SMTP error
       response, for example:

         Rejected:
           550 Relay not permitted

       When running this test, the utility uses "<>" as the envelope sender address for the MAIL command, but you can  change  this  by  providing
       additional  options.   These  are  passed directly to the Exim command.  For example, to specify that the test is to be run with the sender
       address "himself@there.example" you can use:

         exim_checkaccess 10.9.8.7 A.User@a.domain.example 
                          -f himself@there.example

       Note that these additional Exim command line items must be given after the two mandatory arguments.

BUGS

       This manual page needs a major re-work. If somebody knows better groff than us and has more experience in writing manual pages, any patches
       would be greatly appreciated.

SEE ALSO

       exim(8), /usr/share/doc/exim4-base/

AUTHOR

       This  manual  page was stitched together from spec.txt by Andreas Metzler <ametzler at downhill.at.eu.org>, for the Debian GNU/Linux system
       (but may be used by others).

                                                                  March 26, 2003                                               EXIM_CHECKACCESS(8)