Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
MAKESMTPACCESS, MAKE(8)      Double Precision, Inc.	 MAKESMTPACCESS, MAKE(8)

NAME
     makesmtpaccess - Build ESMTP server access file

SYNOPSIS
     makesmtpaccess

     makesmtpaccess-msa

DESCRIPTION
     makesmtpaccess  rebuilds the contents of the /usr/local/etc/courier/smtpac-
     cess.dat  database  from  the  contents  of  the  files  in  the	/usr/lo-
     cal/etc/courier/smtpaccess  directory. When the esmtpd script starts couri-
     ertcpd, the script specifies /usr/local/etc/courier/smtpaccess.dat file  to
     control  access  to the Courier mail server's ESMTP daemon. The makesmtpac-
     cess  script  must  be   run   before   any   changes   in   the	/usr/lo-
     cal/etc/courier/smtpaccess directory take effect.

     The  couriertcpd(8)[1]  manual  page describes the general format of access
     files.

     The default Courier mail server configuration uses the  same  access  file,
     /usr/local/etc/courier/smtpaccess.dat  for  both  the regular ESMTP server,
     and the message submission server on port 587 (RFC 2476[2]). It is possible
     to use different access files. To do so, create a	different  access  file,
     edit  /usr/local/etc/courier/esmtpd-msa, and set ACCESSFILE to the filename
     of the access file directory  (the  directory  containing	the  plain  text
     files, not the .dat file). Then, use makesmtpaccess-msa instead of makesmt-
     paccess to build the .dat file.

   The smtpaccess configuration file
     The  couriertcpd(8)[1]  manual page describes the generic format of the ac-
     cess file. The access file specifies what should be done  with  connections
     from  defined  IP address ranges. The basic choices are to accept or reject
     the connection. Also, the generic format of the access  file  allows  arbi-
     trary  environment  variables to be set based on the connection's remote IP
     address.

     The Courier mail server's ESMTPD server understands the following	environ-
     ment variables, which may be set in the access file:

     BLOCK
	 If this variable is set to a non-empty value, all mail will be rejected
	 for  this  connection. The contents of the environment variable will be
	 used as the error message. This is not the same as the couriertcpd  ac-
	 cess  file  setting that immediately drops the connection. The incoming
	 connection is accepted, but every message will be rejected.

     FAXRELAYCLIENT
	 Allow the client to send faxes via the courierfax(8)[3] module.

	     Note
	     When ESMTP authentication is enabled, a  successful  authentication
	     automatically sets FAXRELAYCLIENT.

     RELAYCLIENT
	 Allow the client to relay mail.

	     Note
	     When  ESMTP  authentication is enabled, a successful authentication
	     automatically sets RELAYCLIENT.

     The following options are typically set globally in the  esmtpd  configura-
     tion file, but may be overriden in the smtpaccess configuration file:

     BOFHCHECKDNS
	 Do  not  check  the  return address's domain in DNS if this environment
	 variable is set to 0. The default value of BOFHCHECKDNS is 1.

	     Note
	     Turning off the DNS check disables a number of options in the  bofh
	     configuration file. See courier(8)[4] for more information.

     BOFHCHECKHELO
	 Set  this  variable  to  1  to check the hostname argument to the ESMTP
	 HELO/EHLO command, as follows:

	 *   A hostname that's actually an IP address, and is the  same  as  the
	     connecting ESMTP client's IP address, is valid.

	 *   Otherwise	hostname  should  be  a  valid DNS name with MX and/or A
	     records, with at least one record	matching  the  connecting  ESMTP
	     client's IP address.

	 *   An ESMTP client with relaying privileges (either due to RELAYCLIENT
	     explicitly  set,  or  if it succesfully authenticates) may use any-
	     thing for an EHLO/HELO. The EHLO/HELO argument coming from  an  au-
	     thenticated/relaying client is not checked.

     BOFHNOEXPN
	 Disable the EXPN command if this environment variable is set to 1.

     BOFHNOVRFY
	 Disable the VRFY command if this environment variable is set to 1.

     Other  useful  environment  variables are listed in the submit(8)[5] manual
     page.

SEE ALSO
     esmtpd(8)[6], couriertcpd(8)[1], submit(8)[5].

AUTHOR
     Sam Varshavchik
	 Author

NOTES
      1. couriertcpd(8)
	 http://www.courier-mta.org/couriertcpd.html

      2. RFC 2476
	 http://www.rfc-editor.org/rfc/rfc2476.txt

      3. courierfax(8)
	 http://www.courier-mta.org/courierfax.html

      4. courier(8)
	 http://www.courier-mta.org/courier.html

      5. submit(8)
	 http://www.courier-mta.org/submit.html

      6. esmtpd(8)
	 http://www.courier-mta.org/esmtpd.html

Courier Mail Server		   01/22/2022		 MAKESMTPACCESS, MAKE(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=makesmtpaccess-msa&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help