<?xml version="1.0"?>
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>makeimapaccess</title><link rel="stylesheet" type="text/css" href="style.css"/><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"/><link rel="home" href="#makeimapaccess" title="makeimapaccess"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--

Copyright 1998 - 2009 S. Varshavchik.  See COPYING for distribution
information.

--></head><body><div class="refentry"><a id="makeimapaccess" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>makeimapaccess — Build IMAP server access file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">makeimapaccess</code> </p></div></div><div class="refsect1"><a id="makeimapaccess_description" shape="rect"> </a><h2>DESCRIPTION</h2><p>
      <span class="command"><strong>makeimapaccess</strong></span> rebuilds the contents of the
      <code class="filename">@sysconfdir@/imapaccess.dat</code> database from the
      contents of the
      files in the <code class="filename">@sysconfdir@/imapaccess</code> directory.
      When the
      <span class="command"><strong>imapd</strong></span> script starts <span class="command"><strong>couriertcpd</strong></span>,
      the script specifies the
      <code class="filename">@sysconfdir@/imapaccess.dat</code> file to control
      access to
      the <span class="application">Courier</span> mail server's
      IMAP daemon. The <span class="command"><strong>makeimapaccess</strong></span> script
      must be
      run before any changes in the <code class="filename">@sysconfdir@/imapaccess</code>
      directory take effect.</p><p>
      The
      <a class="ulink" href="couriertcpd.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">couriertcpd</span>(8)</span></a> manual page
      describes the general format of access files.</p><div class="refsect2"><a id="makeimapaccess_the_imapaccess_configuration_file" shape="rect"> </a><h3>The <code class="filename">imapaccess</code> configuration file</h3><p>
	The
	<a class="ulink" href="couriertcpd.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">couriertcpd</span>(8)</span></a> manual page
	describes the generic format of the access 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 arbitrary environment
	variables to be set based on the connection's remote IP address,
	however the IMAP server does not use any special environment variables
	on its own.
      </p></div></div><div class="refsect1"><a id="makeimapaccess_subdir" shape="rect"> </a><h2>Subdirectory checks</h2><p>
      <code class="filename">@sysconfdir@/imapaccess</code>
      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
      <code class="filename">@sysconfdir@/imapaccess</code> file.
      The following checks are made:
    </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
	  Files whose names contain a tilde, <span class="quote">“<span class="quote">~</span>”</span> are skipped over.
	</p></li><li class="listitem"><p>
	  Files whose names end with the following suffixes result in an error
	  message: <span class="quote">“<span class="quote">.rpmsave</span>”</span>, <span class="quote">“<span class="quote">.rpmnew</span>”</span>, and
	  <span class="quote">“<span class="quote">.dpkg-<em class="replaceable"><code>suffix</code></em></span>”</span>. These files
	  are backup files created by package manager when updating to a newer
	  version of the package and contain the old or the new version of a
	  configuration file whose settings may be new or obsolete.
	</p><p>
	  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.
	</p></li><li class="listitem"><p>
	  Files whose names end with the <span class="quote">“<span class="quote">.dist</span>”</span> suffix is also
	  treated as a configuration file backup or template, but with the
	  following exception: the <span class="quote">“<span class="quote">.dist</span>”</span> 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 <span class="quote">“<span class="quote">.dist</span>”</span> file's modification time.
	</p><p>
	  Otherwise an error message gets reported. Resolving the error
	  message is done by either copying the
	  <span class="quote">“<span class="quote">.dist</span>”</span> file or editing and saving the file without
	  the suffix (resulting in a newer timestamp).
	</p></li></ul></div></div><div class="refsect1"><a id="makeimapaccess_see_also" shape="rect"> </a><h2>SEE ALSO</h2><p>
      <a class="ulink" href="couriertcpd.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">couriertcpd</span>(8)</span></a>.
    </p></div></div></body></html>
