CVS: tmda-cgi/htdocs autoinstall.ht,1.3,1.4 autoinstall.html,1.3,1.4 confirm.ht,1.3,1.4 confirm.html,1.6,1.7 surprise.ht,1.12,1.13 surprise.html,1.13,1.14 virtual.ht,1.3,1.4 virtual.html,1.6,1.7
Gre7g Luterman <[email protected]>
| Newsgroups | gmane.mail.spam.tmda.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/tmda/tmda-cgi/htdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv9281/htdocs
Modified Files:
autoinstall.ht autoinstall.html confirm.ht confirm.html
surprise.ht surprise.html virtual.ht virtual.html
Log Message:
Updated docs. Virtual users are now fully supported.
Minor tweaks to comments.
Added documentation on anomalies files.
Index: autoinstall.ht
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/autoinstall.ht,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- autoinstall.ht 4 May 2003 20:04:21 -0000 1.3
+++ autoinstall.ht 21 May 2003 20:24:53 -0000 1.4
@@ -16,7 +16,12 @@
administrator will need to verify how the installation will be done
beforehand!</p>
-<a href="#Skel"><tt>skel</tt></a><p>
+<a href="#Skel"><tt>skel</tt></a><br>
+<a href="#Anomalies"><tt>anomalies</tt></a><br>
+ <a href="#PERMISSIONS"><tt>PERMISSIONS</tt></a><br>
+ <a href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a><br>
+ <a href="#REAL_ONLY"><tt>REAL_ONLY</tt></a><br>
+ <a href="#VIRTUAL_ONLY"><tt>VIRTUAL_ONLY</tt></a><p>
<h3><a name="Skel"></a><tt>skel</tt></h3>
@@ -82,3 +87,75 @@
for them files here. For example, qmail users should add a
<tt>.qmail-default</tt> file after uninstallation so that any future mail
that comes in for a tagged address will still be accepted.</p>
+
+<h3><a name="Anomalies"></a><tt>anomalies</tt></h3>
+
+<p><tt>skel</tt> directories may optionally have a file called
+ <tt>anomalies</tt>. This file contains <a href="http://python.org">Python</a>
+ code which tells the installer/uninstaller what it should do beyond simply
+ copying the files to the users directory.</p>
+
+<p><tt>anomalies</tt> supports the following variables:</p>
+
+<h4><a name="#PERMISSIONS"></a><tt>PERMISSIONS</tt></h4>
+<blockquote>
+ <p>A dictionary of filenames and what octal permissions should be assigned to
+ them.</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>PERMISSIONS = {".tmda/crypt_key": 0600}</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#VIRTUAL_TEST"></a><tt>VIRTUAL_TEST</tt></h4>
+<blockquote>
+ <p>A regular expression test which can be applied to a user's HOME directory.
+ If the test matches, then the user is assumed to be a virtual user.</p>
+ <p>Example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_TEST = "^/home/vpopmail/domains/"</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#REAL_ONLY"></a><tt>REAL_ONLY</tt></h4>
+<blockquote>
+ <p>A list of files which should only be copied if the user logging in is
+ "real" (i.e. <tt>VIRTUAL_TEST</tt> did not match the user's HOME
+ directory).</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>REAL_ONLY = [".qmail", ".qmail-default"]</td>
+ </tr>
+ </table>
+ <p>Uninstall example:
+ <table class="example">
+ <tr>
+ <td>REAL_ONLY = [".qmail-default"]</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#VIRTUAL_ONLY"></a><tt>VIRTUAL_ONLY</tt></h4>
+<blockquote>
+ <p>A list of files which should only be copied if the user logging in is a
+ virtual user (i.e. <tt>VIRTUAL_TEST</tt> matched the user's HOME
+ directory).</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_ONLY = ["%(Parent)s/.qmail-%(User)s",<br>
+ "%(Parent)s/.qmail-%(User)s-default"]</td>
+ </tr>
+ </table>
+ <p>Uninstall example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_ONLY = ["%(Parent)s/.qmail-%(User)s-default"]</td>
+ </tr>
+ </table>
+</blockquote>
Index: autoinstall.html
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/autoinstall.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- autoinstall.html 4 May 2003 20:04:21 -0000 1.3
+++ autoinstall.html 21 May 2003 20:24:53 -0000 1.4
@@ -2,7 +2,7 @@
<?xml-stylesheet href="display/styles.css" type="text/css"?>
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Sun May 4 13:25:31 2003 -->
+<!-- Wed May 21 15:22:13 2003 -->
<!-- USING HT2HTML 2.1 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -109,7 +109,12 @@
administrator will need to verify how the installation will be done
beforehand!</p>
-<a href="#Skel"><tt>skel</tt></a><p>
+<a href="#Skel"><tt>skel</tt></a><br>
+<a href="#Anomalies"><tt>anomalies</tt></a><br>
+ <a href="#PERMISSIONS"><tt>PERMISSIONS</tt></a><br>
+ <a href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a><br>
+ <a href="#REAL_ONLY"><tt>REAL_ONLY</tt></a><br>
+ <a href="#VIRTUAL_ONLY"><tt>VIRTUAL_ONLY</tt></a><p>
<h3><a name="Skel"></a><tt>skel</tt></h3>
@@ -175,6 +180,78 @@
for them files here. For example, qmail users should add a
<tt>.qmail-default</tt> file after uninstallation so that any future mail
that comes in for a tagged address will still be accepted.</p>
+
+<h3><a name="Anomalies"></a><tt>anomalies</tt></h3>
+
+<p><tt>skel</tt> directories may optionally have a file called
+ <tt>anomalies</tt>. This file contains <a href="http://python.org">Python</a>
+ code which tells the installer/uninstaller what it should do beyond simply
+ copying the files to the users directory.</p>
+
+<p><tt>anomalies</tt> supports the following variables:</p>
+
+<h4><a name="#PERMISSIONS"></a><tt>PERMISSIONS</tt></h4>
+<blockquote>
+ <p>A dictionary of filenames and what octal permissions should be assigned to
+ them.</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>PERMISSIONS = {".tmda/crypt_key": 0600}</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#VIRTUAL_TEST"></a><tt>VIRTUAL_TEST</tt></h4>
+<blockquote>
+ <p>A regular expression test which can be applied to a user's HOME directory.
+ If the test matches, then the user is assumed to be a virtual user.</p>
+ <p>Example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_TEST = "^/home/vpopmail/domains/"</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#REAL_ONLY"></a><tt>REAL_ONLY</tt></h4>
+<blockquote>
+ <p>A list of files which should only be copied if the user logging in is
+ "real" (i.e. <tt>VIRTUAL_TEST</tt> did not match the user's HOME
+ directory).</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>REAL_ONLY = [".qmail", ".qmail-default"]</td>
+ </tr>
+ </table>
+ <p>Uninstall example:
+ <table class="example">
+ <tr>
+ <td>REAL_ONLY = [".qmail-default"]</td>
+ </tr>
+ </table>
+</blockquote>
+
+<h4><a name="#VIRTUAL_ONLY"></a><tt>VIRTUAL_ONLY</tt></h4>
+<blockquote>
+ <p>A list of files which should only be copied if the user logging in is a
+ virtual user (i.e. <tt>VIRTUAL_TEST</tt> matched the user's HOME
+ directory).</p>
+ <p>Install example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_ONLY = ["%(Parent)s/.qmail-%(User)s",<br>
+ "%(Parent)s/.qmail-%(User)s-default"]</td>
+ </tr>
+ </table>
+ <p>Uninstall example:
+ <table class="example">
+ <tr>
+ <td>VIRTUAL_ONLY = ["%(Parent)s/.qmail-%(User)s-default"]</td>
+ </tr>
+ </table>
+</blockquote>
</td>
<!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
Index: confirm.ht
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/confirm.ht,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- confirm.ht 1 May 2003 02:42:39 -0000 1.3
+++ confirm.ht 21 May 2003 20:24:53 -0000 1.4
@@ -32,5 +32,4 @@
<a href="/config-vars.html#ALLOW_MODE_640">ALLOW_MODE_640</a>.
</li>
</ul><p>
- <li>URL confirmation does not currently work for virtual users.</li>
</ul>
Index: confirm.html
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/confirm.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- confirm.html 4 May 2003 20:04:22 -0000 1.6
+++ confirm.html 21 May 2003 20:24:53 -0000 1.7
@@ -2,7 +2,7 @@
<?xml-stylesheet href="display/styles.css" type="text/css"?>
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Sun May 4 13:25:31 2003 -->
+<!-- Wed May 21 14:28:59 2003 -->
<!-- USING HT2HTML 2.1 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -125,7 +125,6 @@
<a href="/config-vars.html#ALLOW_MODE_640">ALLOW_MODE_640</a>.
</li>
</ul><p>
- <li>URL confirmation does not currently work for virtual users.</li>
</ul>
</td>
<!-- end of body cell -->
Index: surprise.ht
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/surprise.ht,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- surprise.ht 14 May 2003 16:19:55 -0000 1.12
+++ surprise.ht 21 May 2003 20:24:54 -0000 1.13
@@ -7,7 +7,6 @@
<p><a href="#Whitelist">Whitelist Woes</a><br>
<a href="#Python">Python Problems</a><br>
-<a href="#Confirm">URL Confirmation Catastrophes</a><br>
<a href="#Authentication">Authentication Ailments</a><br>
<a href="#Attach">Attachment Anxiety</a><br>
<a href="#WhiteBlack">Whitelist, Blacklist... where are the options?</a><br>
@@ -44,10 +43,6 @@
<p>(Assuming that your Python 2.1+ can be found at
<tt>/usr/bin/python2</tt>.) The compiler will save the correct version of
the Python interpreter and use it when tmda-cgi is run.</p>
-
-<h3><a name="Confirm"></a>URL Confirmation Catastrophes</h3>
-<p>URL confirmation does not work for virtual users.</p>
-<p>We hope to add support for this soon.</p>
<h3><a name="Authentication"></a>Authentication Ailments</h3>
<p>If no username/password combination lets you log in, your problem may be due
Index: surprise.html
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/surprise.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- surprise.html 14 May 2003 16:19:55 -0000 1.13
+++ surprise.html 21 May 2003 20:24:54 -0000 1.14
@@ -2,7 +2,7 @@
<?xml-stylesheet href="display/styles.css" type="text/css"?>
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Wed May 14 10:05:14 2003 -->
+<!-- Wed May 21 14:29:00 2003 -->
<!-- USING HT2HTML 2.1 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -85,7 +85,6 @@
<p><a href="#Whitelist">Whitelist Woes</a><br>
<a href="#Python">Python Problems</a><br>
-<a href="#Confirm">URL Confirmation Catastrophes</a><br>
<a href="#Authentication">Authentication Ailments</a><br>
<a href="#Attach">Attachment Anxiety</a><br>
<a href="#WhiteBlack">Whitelist, Blacklist... where are the options?</a><br>
@@ -123,10 +122,6 @@
<tt>/usr/bin/python2</tt>.) The compiler will save the correct version of
the Python interpreter and use it when tmda-cgi is run.</p>
-<h3><a name="Confirm"></a>URL Confirmation Catastrophes</h3>
-<p>URL confirmation does not work for virtual users.</p>
-<p>We hope to add support for this soon.</p>
-
<h3><a name="Authentication"></a>Authentication Ailments</h3>
<p>If no username/password combination lets you log in, your problem may be due
to a misconfigured authentication method. To aid in finding out precisely
@@ -238,10 +233,7 @@
won't work because the user I'm compiling as doesn't have the needed
permissions to put a file in the web tree. Can I do <tt>make install</tt> as
root?</p>
-<p>No, don't do <tt>make install</tt> as root. That will put the wrong
- owner on the binary. Instead, use the *nix <tt>mv</tt> command to move the
- <tt>tmda.cgi</tt> file to its final destination. That will keep the owner
- and group intact.</p>
+<p>Yes, you may do <tt>make install</tt> as root.</p>
<h3><a name="International"></a>International Intrigue</h3>
<p>Instead of Chinese characters in the pending list, the subject lines are
Index: virtual.ht
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/virtual.ht,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- virtual.ht 1 May 2003 02:42:39 -0000 1.3
+++ virtual.ht 21 May 2003 20:24:54 -0000 1.4
@@ -1,42 +1,40 @@
Title: Virtual Users
<h2><a name="Virtual" id="Virtual"></a>Virtual users</h2>
-<p>Virtual users are now mostly* supported. tmda-cgi uses a "stub" program
+<p>Virtual users are now fully supported. tmda-cgi uses a "stub" program
which converts the output of a virtual user information package into a
- format that tmda-cgi can handle. In other words, you must have the
+ format that tmda-cgi can handle. In other words, you must have the
appropriate stub program for tmda-cgi to work on your system.</p>
<p>The current tmda-cgi release includes the following stub:</p>
<ul>
<li>vpopmail1 - compatible with vpopmail 5.2.1</li>
</ul>
-<p>If you use a different program to handle your virtual mail system, you will
- either need to write a stub (they're pretty darn simple) or work with one of
- the developers to get one written. Either way, you'll want to contact the
+<p>If you use a different program to handle your virtual mail system, you will
+ either need to write a stub (they're pretty darn simple) or work with one of
+ the developers to get one written. Either way, you'll want to contact the
developers on the
- <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
+ <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
list</a> so that your new stub can be included in future releases.</p>
-<p>If you have a listed virtual mail system, but the version you are using is
- different, try picking the stub with the closest version number. We don't
- have a good way to test these stubs against every version ever created, so
- there's no saying for sure whether your version will work or not. If you
- can't find a stub that works, you will either need to write one or work with
- one of the developers to get one written. Either way, you'll want to contact
+<p>If you have a listed virtual mail system, but the version you are using is
+ different, try picking the stub with the closest version number. We don't
+ have a good way to test these stubs against every version ever created, so
+ there's no saying for sure whether your version will work or not. If you
+ can't find a stub that works, you will either need to write one or work with
+ one of the developers to get one written. Either way, you'll want to contact
the developers on the
- <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
+ <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
list</a> so that your new stub can be included in future releases.</p>
-<p>If you wish to write your own stub, see <tt>tmda-cgi/stubs/vpopmail1.py</tt>
- as an example of what data will be provided and what data should be
+<p>If you wish to write your own stub, see <tt>tmda-cgi/stubs/vpopmail1.py</tt>
+ as an example of what data will be provided and what data should be
returned.</p>
-<p>Virtual user support must be configured when you <a
- href="compile.html">compile</a> tmda-cgi. You will be asked for a "virtual
+<p>Virtual user support must be configured when you <a
+ href="compile.html">compile</a> tmda-cgi. You will be asked for a "virtual
user stub and parameters". For vpopmail, this is typically:</p>
<blockquote>
<tt>vpopmail1 /home/vpopmail/bin/vuserinfo ~</tt>
</blockquote>
-<p><tt>vpopmail1</tt> is the stub name, <tt>/home/vpopmail/bin/vuserinfo</tt>
- is the vpopmail program which provides user information, and <tt>~</tt> means
- to pass the login name in as the first and only parameter to
- <tt>vuserinfo</tt>. If you use a different stub or keep vuserinfo located
+<p><tt>vpopmail1</tt> is the stub name, <tt>/home/vpopmail/bin/vuserinfo</tt>
+ is the vpopmail program which provides user information, and <tt>~</tt> means
+ to pass the login name in as the first and only parameter to
+ <tt>vuserinfo</tt>. If you use a different stub or keep vuserinfo located
somewhere else, you will need to specify a different string.</p>
-<hr width="50%">
-<p>* URL confirmation does not currently work for virtual users.</p>
Index: virtual.html
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/virtual.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- virtual.html 4 May 2003 20:04:24 -0000 1.6
+++ virtual.html 21 May 2003 20:24:54 -0000 1.7
@@ -2,7 +2,7 @@
<?xml-stylesheet href="display/styles.css" type="text/css"?>
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Sun May 4 13:25:34 2003 -->
+<!-- Wed May 21 14:29:00 2003 -->
<!-- USING HT2HTML 2.1 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -71,45 +71,43 @@
<!-- end of sidebar cell -->
<!-- start of body cell -->
<td valign="top" class="body"><h2><a name="Virtual" id="Virtual"></a>Virtual users</h2>
-<p>Virtual users are now mostly* supported. tmda-cgi uses a "stub" program
+<p>Virtual users are now fully supported. tmda-cgi uses a "stub" program
which converts the output of a virtual user information package into a
- format that tmda-cgi can handle. In other words, you must have the
+ format that tmda-cgi can handle. In other words, you must have the
appropriate stub program for tmda-cgi to work on your system.</p>
<p>The current tmda-cgi release includes the following stub:</p>
<ul>
<li>vpopmail1 - compatible with vpopmail 5.2.1</li>
</ul>
-<p>If you use a different program to handle your virtual mail system, you will
- either need to write a stub (they're pretty darn simple) or work with one of
- the developers to get one written. Either way, you'll want to contact the
+<p>If you use a different program to handle your virtual mail system, you will
+ either need to write a stub (they're pretty darn simple) or work with one of
+ the developers to get one written. Either way, you'll want to contact the
developers on the
- <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
+ <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
list</a> so that your new stub can be included in future releases.</p>
-<p>If you have a listed virtual mail system, but the version you are using is
- different, try picking the stub with the closest version number. We don't
- have a good way to test these stubs against every version ever created, so
- there's no saying for sure whether your version will work or not. If you
- can't find a stub that works, you will either need to write one or work with
- one of the developers to get one written. Either way, you'll want to contact
+<p>If you have a listed virtual mail system, but the version you are using is
+ different, try picking the stub with the closest version number. We don't
+ have a good way to test these stubs against every version ever created, so
+ there's no saying for sure whether your version will work or not. If you
+ can't find a stub that works, you will either need to write one or work with
+ one of the developers to get one written. Either way, you'll want to contact
the developers on the
- <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
+ <a href="http://tmda.net/lists/listinfo/tmda-workers">tmda-workers mailing
list</a> so that your new stub can be included in future releases.</p>
-<p>If you wish to write your own stub, see <tt>tmda-cgi/stubs/vpopmail1.py</tt>
- as an example of what data will be provided and what data should be
+<p>If you wish to write your own stub, see <tt>tmda-cgi/stubs/vpopmail1.py</tt>
+ as an example of what data will be provided and what data should be
returned.</p>
-<p>Virtual user support must be configured when you <a
- href="compile.html">compile</a> tmda-cgi. You will be asked for a "virtual
+<p>Virtual user support must be configured when you <a
+ href="compile.html">compile</a> tmda-cgi. You will be asked for a "virtual
user stub and parameters". For vpopmail, this is typically:</p>
<blockquote>
<tt>vpopmail1 /home/vpopmail/bin/vuserinfo ~</tt>
</blockquote>
-<p><tt>vpopmail1</tt> is the stub name, <tt>/home/vpopmail/bin/vuserinfo</tt>
- is the vpopmail program which provides user information, and <tt>~</tt> means
- to pass the login name in as the first and only parameter to
- <tt>vuserinfo</tt>. If you use a different stub or keep vuserinfo located
+<p><tt>vpopmail1</tt> is the stub name, <tt>/home/vpopmail/bin/vuserinfo</tt>
+ is the vpopmail program which provides user information, and <tt>~</tt> means
+ to pass the login name in as the first and only parameter to
+ <tt>vuserinfo</tt>. If you use a different stub or keep vuserinfo located
somewhere else, you will need to specify a different string.</p>
-<hr width="50%">
-<p>* URL confirmation does not currently work for virtual users.</p>
</td>
<!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
_______________________________________
tmda-cvs mailing list
http://tmda.net/lists/listinfo/tmda-cvs