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

FreeBSD Manual Pages

  
 
  

home | help
MAKEIMAPACCESS(8)		 S. Varshavchik.	       MAKEIMAPACCESS(8)

NAME
     makeimapaccess - Build IMAP server access file

SYNOPSIS
     makeimapaccess

DESCRIPTION
     makeimapaccess   rebuilds	 the  contents	of  the  /usr/local/etc/courier-
     imap/imapaccess.dat database from the contents of the files in the /usr/lo-
     cal/etc/courier-imap/imapaccess directory. When  the  imapd  script  starts
     couriertcpd,  the	script specifies the /usr/local/etc/courier-imap/imapac-
     cess.dat file to control access to the Courier mail server's  IMAP  daemon.
     The  makeimapaccess  script  must be run before any changes in the /usr/lo-
     cal/etc/courier-imap/imapaccess directory take effect.

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

   The imapaccess 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, however the IMAP server does not use any special environment vari-
     ables on its own.

SUBDIRECTORY CHECKS
     /usr/local/etc/courier-imap/imapaccess can be a subdirectory instead  of  a
     text file. This has the effect of concatenating all files in that directory
     (subject to the following checks) and then using the result as the /usr/lo-
     cal/etc/courier-imap/imapaccess file. The following checks are made:

     *	 Files whose names contain a tilde, "~" are skipped over.

     *	 Files	whose  names  end with the following suffixes result in an error
	 message: ".rpmsave", ".rpmnew", and  ".dpkg-suffix".  These  files  are
	 backup  files	created by package manager when updating to a newer ver-
	 sion of the package and contain the old or the new version of a config-
	 uration file whose settings may be new or obsolete.

	 The contents of the file whose name does not have the suffix should  be
	 checked  against  the	backup.  The backup file should be deleted after
	 making any needed manual changes to the configuration file.

     *	 Files whose names end with the ".dist" suffix is also treated as a con-
	 figuration file backup or template, but with the  following  exception:
	 the  ".dist"  file gets ignored and automatically skipped over, without
	 any error message, if the suffix-less file exists and its  modification
	 time is more recent than the ".dist" file's modification time.

	 Otherwise  an	error message gets reported. Resolving the error message
	 is done by either copying the ".dist" file or editing	and  saving  the
	 file without the suffix (resulting in a newer timestamp).

SEE ALSO
     couriertcpd(8)[1].

AUTHOR
     Sam Varshavchik
	 Author

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

Courier Mail Server		   05/03/2026		       MAKEIMAPACCESS(8)

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

home | help