/usr/share/doc/mailutils-doc/mailutils.html/Virtdomain-Statement.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA

Copyright (C) 1999-2004, 2008-2012, 2014-2015 Free Software
Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover, and no Back-Cover texts.
A copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: Virtdomain Statement</title>

<meta name="description" content="GNU Mailutils Manual: Virtdomain Statement">
<meta name="keywords" content="GNU Mailutils Manual: Virtdomain Statement">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="configuration.html#configuration" rel="up" title="configuration">
<link href="Radius-Statement.html#Radius-Statement" rel="next" title="Radius Statement">
<link href="PAM-Statement.html#PAM-Statement" rel="prev" title="PAM Statement">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="Virtdomain-Statement"></a>
<div class="header">
<p>
Next: <a href="Radius-Statement.html#Radius-Statement" accesskey="n" rel="next">Radius Statement</a>, Previous: <a href="PAM-Statement.html#PAM-Statement" accesskey="p" rel="prev">PAM Statement</a>, Up: <a href="configuration.html#configuration" accesskey="u" rel="up">configuration</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Virtdomain-Statement-1"></a>
<h4 class="subsection">2.2.13 Virtdomain Statement</h4>

<table class="cartouche" border="1"><tr><td>
<div align="center"><strong>Editor&rsquo;s note:</strong>
</div><p>The information in this node may be obsolete or
otherwise inaccurate.  This message will disappear, once this node revised.
</p></td></tr></table>
<a name="index-virtdomain"></a>
<a name="Syntax-11"></a>
<h4 class="subheading">Syntax</h4>
<div class="example">
<pre class="example">virtdomain {
  # <span class="roman">Name of the virtdomain password directory.</span>
  passwd-dir <var>dir</var>;
}
</pre></div>

<a name="Description-9"></a>
<h4 class="subheading">Description</h4>
<p><em>Virtual mail domains</em> make it possible to handle several
mail domains each having a separate set of users, on a single server.
The domains are completely independent of each other, i.e. the same
user name can be present in several domains and represent different
users.
</p>
<p>When authenticating to a server with virtual domain support enabled,
users must supply their user names with domain parts.  The server strips
off the domain part and uses it as a name of UNIX-format password
database file, located in the <em>domain password directory</em>.  The
latter is set using <code>passwd-dir</code> statement.
</p>
<dl>
<dt><a name="index-passwd_002ddir"></a>Configuration: <strong>passwd-dir</strong> <em><var>dir</var></em></dt>
<dd><p>Set virtual domain password directory.
</p></dd></dl>

<p>For example, when authenticating user &lsquo;<samp>smith@domain.tld</samp>&rsquo;,
the server will use password file named <samp><var>dir</var>/domain.tld</samp>.
This file must be in UNIX passwd format (see <a href="../passwd(5)/password-file.html#password-file">password
file</a> in <cite>passwd(5) man page</cite>), with encrypted passwords
stored in it (as of GNU Mailutils version 2.99.99, there is no
support for shadow files in virtual password directories, although
this is planned for future versions).  Here is an example record from
this file:
</p>
<div class="example">
<pre class="example">smith:Wbld/G2Q2Le2w:1000:1000:Email Account:/var/mail/domain/smith:/dev/null
</pre></div>

<p>Notice, that it must contain user names without domain parts.
</p>
<p>The <code>pw_dir</code> field (the 6th field) is used to determine the
location of the maildrop for this user.  It is defined as
<samp><var>pw_dir</var>/INBOX</samp>.  In our example, the maildrop for user
&lsquo;<samp>smith</samp>&rsquo; will be located in file <samp>/var/mail/domain/smith</samp>.
</p>
<p>If user did not supply his domain name, or if no matching record was
found in the password file, or if the file matching the domain name
does not exist, then GNU Mailutils falls back to alternative method.
First, it tries to determine the IP address of the remote party.  Then
the domain name corresponding to that address is looked up in the DNS
system.  Finally, this domain name is used as a name of the password
file.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Radius-Statement.html#Radius-Statement" accesskey="n" rel="next">Radius Statement</a>, Previous: <a href="PAM-Statement.html#PAM-Statement" accesskey="p" rel="prev">PAM Statement</a>, Up: <a href="configuration.html#configuration" accesskey="u" rel="up">configuration</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
mailutils-doc 1:2.99.99-1ubuntu2 / usr / share / doc / mailutils-doc / mailutils.html / Virtdomain-Statement.html
