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 further 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)