CVS: tmda-cgi/htdocs autoinstall.ht,1.6,1.7 autoinstall.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-serv19812/htdocs
Modified Files:
autoinstall.ht autoinstall.html
Log Message:
Changed installer/uninstaller to support multiple type of MAIL_TRANSFER_AGENT
in a single install or uninstall skel directory.
Index: autoinstall.ht
===================================================================
RCS file: /cvsroot/tmda/tmda-cgi/htdocs/autoinstall.ht,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- autoinstall.ht 23 May 2003 22:42:11 -0000 1.6
+++ autoinstall.ht 31 May 2003 17:02:38 -0000 1.7
@@ -9,11 +9,11 @@
<p>This feature does not install TMDA, but configures an already existing
e-mail account so it will work with TMDA.</p>
-<p>To use this feature, the user need only log in to tmda-cgi (<a
- href="auth.html#ProgAuth">program</a> or <a
- href="auth.html#RemtAuth">remote</a> authentication is strongly recommended
- if you wish to use auto-install) and click "Sign up." However, the system
- administrator will need to verify how the installation will be done
+<p>To use this feature, the user need only log in to tmda-cgi (<a
+ href="auth.html#ProgAuth">program</a> or <a
+ href="auth.html#RemtAuth">remote</a> authentication is strongly recommended
+ if you wish to use auto-install) and click "Sign up." However, the system
+ administrator will need to verify how the installation will be done
beforehand!</p>
<a href="#Skel"><tt>skel</tt></a><br>
@@ -25,15 +25,15 @@
<h3><a name="Skel"></a><tt>skel</tt></h3>
-<p>Before allowing users to auto-install or auto-uninstall, carefully check
- over each file in the <tt>skel/install</tt> directory. These files will be
+<p>Before allowing users to auto-install or auto-uninstall, carefully check
+ over each file in the <tt>skel/install</tt> directory. These files will be
copied to the user's directory upon installation.</p>
-<p><b><i>Important note:</i></b> The <tt>skel</tt> directories included with
- tmda-cgi were designed for servers running <a
- href="http://cr.yp.to/qmail.html">qmail</a>. If you use a different mail
- server package, do <b><i>not</i></b> use the files as-is! You should look
- through these files and see how they work, but you will need to create a
+<p><b><i>Important note:</i></b> The <tt>skel</tt> directories included with
+ tmda-cgi were designed for servers running <a
+ href="http://cr.yp.to/qmail.html">qmail</a>. If you use a different mail
+ server package, do <b><i>not</i></b> use the files as-is! You should look
+ through these files and see how they work, but you will need to create a
totally different set of <tt>skel</tt> files.
<p><tt>skel</tt> files allow for variable substitution. All of the following
@@ -74,7 +74,7 @@
</tr>
<tr>
<td valign="top" nowrap><b><tt>%(User)s</tt></b></td>
- <td>The user's login name, or the left-most portion (before the "@") of the
+ <td>The user's login name, or the left-most portion (before the "@") of the
user's e-mail address in the case of virtual users.</td>
</tr>
<tr>
@@ -83,24 +83,24 @@
</tr>
<tr>
<td valign="top" nowrap><b><tt>%(VPop)s</tt></b></td>
- <td>The path to the virtual user's home directory (for example:
+ <td>The path to the virtual user's home directory (for example:
<tt>/home/vpopmail</tt>).</td>
</tr>
<tr>
<td valign="top" nowrap><b><tt>%(VPopBin)s</tt></b></td>
- <td>The path to the virtual user's bin directory (for example:
+ <td>The path to the virtual user's bin directory (for example:
<tt>/home/vpopmail/bin</tt>).</td>
</tr>
</table>
-<p>If you need to put a "%" in one of the <tt>skel</tt> files, you will have to
+<p>If you need to put a "%" in one of the <tt>skel</tt> files, you will have to
type "%%" instead. This will prevent errors during the install process.</p>
-<p>In addition to a <tt>skel/install</tt> directory, there is also a
- <tt>skel/uninstall</tt> directory. If you have any files which should be
- installed after the uninstall process is complete, you may place skeletons
+<p>In addition to a <tt>skel/install</tt> directory, there is also a
+ <tt>skel/uninstall</tt> directory. If you have any files which should be
+ installed after the uninstall process is complete, you may place skeletons
for them files here. For example, qmail users should add a
- <tt>.qmail-default</tt> file after uninstallation so that any future mail
+ <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>
@@ -138,39 +138,49 @@
<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>A list of files or a dictionary of lists which should only be copied if
+ the user logging in is "real" (i.e. <a
+ href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a> did not match the user's
+ HOME directory).</p>
+ <p>The optional dictionary structure of this configuration variable allows
+ you to specify different files based on the mail program (see <tt><a
+ href="/config-vars.html#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></tt>)
+ you're using. You can only have one mail program installed, of course, so
+ if you are creating this skel directory by hand, feel free to simply use a
+ list.</p>
<p>Install example:
<table class="example">
<tr>
- <td>REAL_ONLY = [".qmail", ".qmail-default"]</td>
+ <td>REAL_ONLY = {"qmail": [".qmail", ".qmail-default"]}</td>
</tr>
</table>
<p>Uninstall example:
<table class="example">
<tr>
- <td>REAL_ONLY = [".qmail-default"]</td>
+ <td>REAL_ONLY = {"qmail": [".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
+ <p><tt>VIRTUAL_ONLY</tt> is the compliment to <a
+ href="#REAL_ONLY"><tt>REAL_ONLY</tt></a>, above. These files should only
+ be copied if the user logging in is a virtual user (i.e. <a
+ href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a> 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>
+ <td>VIRTUAL_ONLY = {"qmail": ["%(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>
+ <td>VIRTUAL_ONLY = {"qmail":
+ ["%(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.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- autoinstall.html 23 May 2003 22:42:11 -0000 1.6
+++ autoinstall.html 31 May 2003 17:02:38 -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. -->
-<!-- Thu May 22 16:36:50 2003 -->
+<!-- Sat May 31 11:59:28 2003 -->
<!-- USING HT2HTML 2.1 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -102,11 +102,11 @@
<p>This feature does not install TMDA, but configures an already existing
e-mail account so it will work with TMDA.</p>
-<p>To use this feature, the user need only log in to tmda-cgi (<a
- href="auth.html#ProgAuth">program</a> or <a
- href="auth.html#RemtAuth">remote</a> authentication is strongly recommended
- if you wish to use auto-install) and click "Sign up." However, the system
- administrator will need to verify how the installation will be done
+<p>To use this feature, the user need only log in to tmda-cgi (<a
+ href="auth.html#ProgAuth">program</a> or <a
+ href="auth.html#RemtAuth">remote</a> authentication is strongly recommended
+ if you wish to use auto-install) and click "Sign up." However, the system
+ administrator will need to verify how the installation will be done
beforehand!</p>
<a href="#Skel"><tt>skel</tt></a><br>
@@ -118,15 +118,15 @@
<h3><a name="Skel"></a><tt>skel</tt></h3>
-<p>Before allowing users to auto-install or auto-uninstall, carefully check
- over each file in the <tt>skel/install</tt> directory. These files will be
+<p>Before allowing users to auto-install or auto-uninstall, carefully check
+ over each file in the <tt>skel/install</tt> directory. These files will be
copied to the user's directory upon installation.</p>
-<p><b><i>Important note:</i></b> The <tt>skel</tt> directories included with
- tmda-cgi were designed for servers running <a
- href="http://cr.yp.to/qmail.html">qmail</a>. If you use a different mail
- server package, do <b><i>not</i></b> use the files as-is! You should look
- through these files and see how they work, but you will need to create a
+<p><b><i>Important note:</i></b> The <tt>skel</tt> directories included with
+ tmda-cgi were designed for servers running <a
+ href="http://cr.yp.to/qmail.html">qmail</a>. If you use a different mail
+ server package, do <b><i>not</i></b> use the files as-is! You should look
+ through these files and see how they work, but you will need to create a
totally different set of <tt>skel</tt> files.
<p><tt>skel</tt> files allow for variable substitution. All of the following
@@ -155,8 +155,19 @@
<td>The constant string "<tt>..</tt>".</td>
</tr>
<tr>
+ <td valign="top" nowrap><b><tt>%(ShortUrlDom)s</tt></b></td>
+ <td>The domain name portion of the URL the user surfed up, without any
+ "www.", if present.<br>
+ Also see <tt>%(UrlDomain)s</tt>, below.</td>
+ </tr>
+ <tr>
+ <td valign="top" nowrap><b><tt>%(UrlDomain)s</tt></b></td>
+ <td>The domain name portion of the URL the user surfed up.<br>
+ Also see <tt>%(ShortUrlDom)s</tt>, above.</td>
+ </tr>
+ <tr>
<td valign="top" nowrap><b><tt>%(User)s</tt></b></td>
- <td>The user's login name, or the left-most portion (before the "@") of the
+ <td>The user's login name, or the left-most portion (before the "@") of the
user's e-mail address in the case of virtual users.</td>
</tr>
<tr>
@@ -165,24 +176,24 @@
</tr>
<tr>
<td valign="top" nowrap><b><tt>%(VPop)s</tt></b></td>
- <td>The path to the virtual user's home directory (for example:
+ <td>The path to the virtual user's home directory (for example:
<tt>/home/vpopmail</tt>).</td>
</tr>
<tr>
<td valign="top" nowrap><b><tt>%(VPopBin)s</tt></b></td>
- <td>The path to the virtual user's bin directory (for example:
+ <td>The path to the virtual user's bin directory (for example:
<tt>/home/vpopmail/bin</tt>).</td>
</tr>
</table>
-<p>If you need to put a "%" in one of the <tt>skel</tt> files, you will have to
+<p>If you need to put a "%" in one of the <tt>skel</tt> files, you will have to
type "%%" instead. This will prevent errors during the install process.</p>
-<p>In addition to a <tt>skel/install</tt> directory, there is also a
- <tt>skel/uninstall</tt> directory. If you have any files which should be
- installed after the uninstall process is complete, you may place skeletons
+<p>In addition to a <tt>skel/install</tt> directory, there is also a
+ <tt>skel/uninstall</tt> directory. If you have any files which should be
+ installed after the uninstall process is complete, you may place skeletons
for them files here. For example, qmail users should add a
- <tt>.qmail-default</tt> file after uninstallation so that any future mail
+ <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>
@@ -220,39 +231,49 @@
<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>A list of files or a dictionary of lists which should only be copied if
+ the user logging in is "real" (i.e. <a
+ href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a> did not match the user's
+ HOME directory).</p>
+ <p>The optional dictionary structure of this configuration variable allows
+ you to specify different files based on the mail program (see <tt><a
+ href="/config-vars.html#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></tt>)
+ you're using. You can only have one mail program installed, of course, so
+ if you are creating this skel directory by hand, feel free to simply use a
+ list.</p>
<p>Install example:
<table class="example">
<tr>
- <td>REAL_ONLY = [".qmail", ".qmail-default"]</td>
+ <td>REAL_ONLY = {"qmail": [".qmail", ".qmail-default"]}</td>
</tr>
</table>
<p>Uninstall example:
<table class="example">
<tr>
- <td>REAL_ONLY = [".qmail-default"]</td>
+ <td>REAL_ONLY = {"qmail": [".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
+ <p><tt>VIRTUAL_ONLY</tt> is the compliment to <a
+ href="#REAL_ONLY"><tt>REAL_ONLY</tt></a>, above. These files should only
+ be copied if the user logging in is a virtual user (i.e. <a
+ href="#VIRTUAL_TEST"><tt>VIRTUAL_TEST</tt></a> 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>
+ <td>VIRTUAL_ONLY = {"qmail": ["%(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>
+ <td>VIRTUAL_ONLY = {"qmail":
+ ["%(Parent)s/.qmail-%(User)s-default"]}</td>
</tr>
</table>
</blockquote>
_______________________________________
tmda-cvs mailing list
http://tmda.net/lists/listinfo/tmda-cvs