Update of /cvsroot/tmda/tmda/htdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv1412/htdocs

Modified Files:
        bugs.html config-client.html config-filter.html 
        config-pre.html config-server.html config-vars.ht 
        config-vars.html config.html download.html features.html 
        filter-sources.html history.html howto-links.h 
        howto-template.html howtos.ht howtos.html index.html 
        install.html inuse.html press.html requirements.html 
        resources.html results.html support-commercial.html 
        tmda-cgi.ht tmda-ofmipd.html trouble.html 
Added Files:
        tmda-cgi.html 
Log Message:
Integrate tmda-cgi.html.


--- NEW FILE ---
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Sat Nov 30 22:15:47 2002 -->
<!-- USING HT2HTML 1.2 -->
<!-- SEE http://barry.wooz.org/software/ht2html -->
<!-- User-specified headers:
Title: tmda-cgi HOWTO

-->

<HEAD>
<TITLE>tmda-cgi HOWTO</TITLE>

</HEAD>
<BODY BGCOLOR="#ffffff" TEXT="#000000"
      TOPMARGIN="0" LEFTMARGIN="0" MARGINWIDTH="0" MARGINHEIGHT="0"
      LINK="#0000bb"  VLINK="#551a8b"
      ALINK="#ff0000">
<!-- start of page table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=0>
<!-- start of banner row -->
<TR>
<!-- start of corner cells -->
<TD WIDTH=150 VALIGN=CENTER BGCOLOR="#afeeee">
<center><font size="+2"
        >&gt;&gt;&gt;&nbsp;TMDA&nbsp</font></center> </TD>
<TD WIDTH=15 BGCOLOR="#cccccc">&nbsp;&nbsp;</TD><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<TD WIDTH="90%" BGCOLOR="#cccccc">
<!-- start of site links table -->
<TABLE WIDTH="100%" BORDER=0
CELLSPACING=0 CELLPADDING=0
       COLS=4 ROWS=1 BGCOLOR="#ffffff">
<TR>
    <TD BGCOLOR="#cccccc">
<a href="./index.html">TMDA Homepage</a>
    </TD>
    <TD BGCOLOR="#cccccc">
<a href="http://sourceforge.net/projects/tmda";>TMDA @ SourceForge</a>
    </TD>
    <TD BGCOLOR="#cccccc">
&nbsp;&nbsp;</TD>
    <TD BGCOLOR="#cccccc">
&nbsp;&nbsp;</TD>
</TR>
</TABLE><!-- end of site links table -->

</TD><!-- end of banner -->
</TR><!-- end of banner row -->
<TR><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<TD WIDTH=150 VALIGN=TOP BGCOLOR="#cccccc">
<!-- start of sidebar table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3
       BGCOLOR="#ffffff">
<TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
Overview
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="index.html">Introduction</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="history.html">History</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="features.html">Features</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="results.html">Results &amp; Testimonials</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="inuse.html">TMDA In Use</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="press.html">Press Coverage</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">&nbsp;
<TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
Usage
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="requirements.html">Requirements</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="download.html">Download</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="install.html">Installation</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="config.html">Configuration</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="howtos.html">HOWTOs</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">&nbsp;
<TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
HOWTOs
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="howtos.html">Overview</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="howto-template.html">Templates</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="tmda-ofmipd.html">tmda-ofmipd</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<b>tmda-cgi</b>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">&nbsp;
<TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
Support
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="trouble.html">Troubleshooting</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<a href="http://tmda.net/faq.cgi"; TARGET="Resource Window">FAQ</a>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="bugs.html">Bugs &amp; Patches</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<a href="http://tmda.net/lists/listinfo/"; TARGET="Resource Window">Mailing Lists</a>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<a href="http://mla.libertine.org/"; TARGET="Resource Window">List Archive</a> 
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="support-commercial.html">Commercial Support</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="resources.html">External Resources</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">&nbsp;
<TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
Author
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cccccc">
<A HREF="mailto:[EMAIL PROTECTED]";>Jason R. Mastaler</A>
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
&nbsp;
</TD></TR>
<TR><TD BGCOLOR="#cccccc">
&copy; 2001-2002
</TD></TR>
</TABLE><!-- end of sidebar table -->

</TD>
<TD WIDTH=15>&nbsp;&nbsp;</TD><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<TD VALIGN=TOP WIDTH="90%"><BR>
<h1>tmda-cgi</h1>
<hr>
<h2>What is it?</h2>
<p>tmda-cgi is an alpha-release program for managing your TMDA account over the 
  web. At the time of this writing, tmda-cgi can:</p>
<ul>
  <li>Page through lists of pending e-mail (mail received by your MTA, but still 
    awaiting confirmation) 
  <li>View the text content (and see what sorts of attachments are included) in 
    any of your pending e-mails 
  <li>Release (move into your mail folder as if a confirmation had been received) 
    any of your pending e-mails. 
  <li>Delete any pending e-mail 
  <li>Whitelist or blacklist the author of any pending e-mails. 
</ul>
<p>At the moment, tmda-cgi's focus is clearly manipulating pending e-mails. At 
  some point, I would like tmda-cgi to become more of a general system tool. Features 
  I hope to add soon include:</p>
<ul>
  <li>Filter configuration</li>
  <li>List editing</li>
  <li>Automated clean-ups of pending e-mails</li>
  <li>E-mail address generation (keyword, dated, or sender)</li>
</ul>
<p>tmda-cgi provides quick and easy access to your pending e-mails. This is an 
  ideal tool for users who either do not have access to a shell account or are 
  intimidated by operating in a command-line environment.</p>
<p>Although TMDA users do not generally need to mess with their pending e-mails, 
  there are times when this is the most convenient way to go. For instance:</p>
<ul>
  <li>When you use a web site that says it will automatically mail you a password, 
    authentication link, or a receipt for a transaction you are making right now, 
    but you're not interested in any follow-up e-mail they will likely send you 
    in the future (and you don't feel like generating a dated address). 
    <p> Simply fill out the web form like you normally would and give your regular, 
      filtered e-mail address. The web site will send the e-mail to your mail 
      server, and your mail server will send a confirmation request back to the 
      web site (which will most likely never be seen by a human being). Then log 
      into tmda-cgi and manually release their letter. Any further mail they send 
      you will sit quietly in your pending directory like the one you released. 
  </li>
  <li>To search your incoming mail for automated mailings you want to receive. 
    <p> Using tmda-cgi regularly for a few weeks or months after you begin filtering 
      your e-mail is a good way to make sure your filters are configured correctly. 
  <li> 
    <p>To look for &quot;lost&quot; e-mail. 
    <p> It's really rare that e-mail will get lost, but it's bound to happen 
sometimes. 
      Perhaps Aunt Margaret can't figure out what the confirmation e-mail meant 
      (even though it is written in a very obvious way). Perhaps your boss was 
      in a hurry and deleted the confirmation request thinking 
<em><strong>it</strong></em> 
      was spam (or perhaps he has a really crappy spam filter that mistook the 
      confirmation for spam). Perhaps Grandpa Joe sent you some e-mail from someone 
      else's e-mail account and they deleted the confirmation request, not realizing 
      what it was. 
  <li> 
    <p>To remind you <em><strong>why</strong></em> you got TMDA in the first place. 
    <p> &quot;Wow, I would have gotten 100 e-mails about Viagara, cheap cigarettes, 
      weight loss drugs, penis enlargement, and Nigerian swindles today! Now I 
      remember why the rest of my family thinks that e-mail is a pain.&quot;</ul>
<hr>
<h2>Requirements</h2>
<p>TBD. Until we do more testing it isn't clear what systems have problems with 
  tmda-cgi.</p>
<hr>
<h2>Installation</h2>
<p>tmda-cgi is provided in your distribution's <tt>contrib/cgi</tt> directory, 
  however with this being alpha-revision software, revisions come out quite 
frequently. 
  You should consider downloading from <a 
href="http://sourceforge.net/cvs/?group_id=24680"; target="_blank">CVS</a> 
  and joining the <a href="mailto:[EMAIL PROTECTED]";>tmda-cgi mailing 
  list</a> to keep up on the sub-project's current state of development.</p>
<p>Once you've obtained a copy of tmda-cgi, you need to decide how you want to 
  use tmda-cgi. tmda-cgi has been designed to run three different ways: system-wide, 
  single-user, and in no-su modes.</p>
<ul>
  <li>In system-wide mode, multiple users can use tmda-cgi to access their TMDA 
    system. The program launches as root and then performs a <tt>seteuid</tt> 
    to run as the requested user once password authentication has been accomplished. 
    This is the best solution for system administrators who wish to set up their 
    TMDA system for use by multiple users.<br>
  </li>
  <li>In single-user mode, only one user can access tmda-cgi. That user will still 
    need to authenticate their access with a password, but the program runs as 
    the user who compiled it and therefore cannot access anyone else's personal 
    data. If multiple users wish to install tmda-cgi in single-user mode (strange, 
    but not absurd) then each user can compile a different 14k shell that launches 
    the Python code. This method is less convenient than the system-wide installation, 
    but it is the best solution for users without root access to their server, 
    or for users who don't trust any program running as root that does not absolutely 
    have to run as root.<br>
  </li>
  <li>no-su mode, which is in testing, runs the program with no special privileges 
    of any sort. The downside of such an installation is that to allow the program 
    access to your personal files (such as pending e-mails) you will have to make 
    some of your files and directories group or world readable and writable. no-su 
    mode is a good solution for an unusual breed of user: someone who doesn't 
    trust the software, but trusts the other users on the server (since they could 
    get read/write access to his/er pending e-mail)</li>
</ul>
<p><b><i>Notes:</i></b></p>
<ul>
  <li>tmda-cgi assumes it will run from within the source tree. No testing has 
    been done to date to see if it will work in other locations.<br>
  </li>
  <li>You will have to recompile tmda-cgi if you move your configuration files 
    or source tree.<br></li>
  <li>You will have to recompile tmda-cgi if you change which mode (system-wide, 
    single-user, or no-su) you run in.</li>
</ul>
<h3>Installing system-wide</h3>
<p>As root, change to the cgi directory.</p>
<blockquote> 
  <pre># cd contrib/cgi</pre>
</blockquote>
<p>Compile tmda-cgi to a web directory that is configured to execute CGI. The 
  filename you use is completely up to you. For example:</p>
<blockquote> 
  <pre># ./compile -t /path/to/cgi-bin/directory</pre>
</blockquote>
<p> or</p>
<blockquote> 
  <pre># ./compile -t /path/to/webpage/directory/index.cgi</pre>
</blockquote>
<p>Finally, tmda-cgi expects to find a variety of visual elements in a subdirectory 
  called &quot;display&quot;. This directory should be located directly below 
  the CGI itself. Sample files are provided in <tt>contrib/cgi/display</tt>. Feel 
  free to use these files as-is or modify/replace them to personalize the program.</p>
<p>The simplest way to provide this directory is with a symbolic link (assuming 
  you have you web server configured to follow symbolic links). For example:</p>
<blockquote>
  <pre># ln -s display /path/to/webpage/directory</pre>
</blockquote>
<h3>Installing single-user</h3>
<p>As the (only) user who will be able to access tmda-cgi, change to the cgi 
directory.</p>
<blockquote> 
  <pre>$ cd contrib/cgi</pre>
</blockquote>
<p>Compile tmda-cgi to a web directory that is configured to execute CGI. The 
  filename you use is completely up to you. For example:</p>
<blockquote> 
  <pre>$ ./compile -t /path/to/cgi-bin/directory</pre>
</blockquote>
<p>or</p>
<blockquote> 
  <pre>$ ./compile -t /path/to/webpage/directory/index.cgi</pre>
</blockquote>
<p>Finally, tmda-cgi expects to find a variety of visual elements in a subdirectory 
  called &quot;display&quot;. This directory should be located directly below 
  the CGI itself. Sample files are provided in <tt>contrib/cgi/display</tt>. Feel 
  free to use these files as-is or modify/replace them to personalize the program.</p>
<p>The simplest way to provide this directory is with a symbolic link (assuming 
  you have you web server configured to follow symbolic links). For example:</p>
<blockquote> 
  <pre>$ ln -s display /path/to/webpage/directory</pre>
</blockquote>
<h3>Installing no-su</h3>
<p>To compile tmda-cgi for no-su mode, first change to the cgi directory.</p>
<blockquote> 
  <pre>$ cd contrib/cgi</pre>
</blockquote>
<p>Compile tmda-cgi to a web directory that is configured to execute CGI. The 
  filename you use is completely up to you. For example:</p>
<blockquote> 
  <pre>$ ./compile -nt /path/to/cgi-bin/directory</pre>
</blockquote>
<p> or</p>
<blockquote> 
  <pre>$ ./compile -nt /path/to/webpage/directory/index.cgi</pre>
</blockquote>
<p>tmda-cgi expects to find a variety of visual elements in a subdirectory called 
  &quot;display&quot;. This directory should be located directly below the CGI 
  itself. Sample files are provided in <tt>contrib/cgi/display</tt>. Feel free 
  to use these files as-is or modify/replace them to personalize the program.</p>
<p>The simplest way to provide this directory is with a symbolic link (assuming 
  you have you web server configured to follow symbolic links). For example:</p>
<blockquote> 
  <pre>$ ln -s display /path/to/webpage/directory</pre>
</blockquote>
<p>At this point you will have to change permissions on any existing pending mail 
  and change the value of <tt>PENDING_FILE_PERM</tt> to make sure any new mail 
  that is placed in the pending directory is given the correct permissions.</p>
<p>If you multiple users plan on using tmda-cgi in no-su mode, then you might 
  consider moving all of your TMDA files into one central location. This will 
  make it easier to keep group permissions on your directories and files. Here's 
  some sample directories and file contents I set up for my user <tt>cgitest</tt>:</p>
<blockquote> 
  <pre>/etc:
-rw-r--r--    1 root     root           22 Nov 24 23:54 tmda-cgi
-rw-r--r--    1 root     root          557 Nov 27 15:05 tmdarc
-rw-------    1 tofmipd  tofmipd        49 Nov 10 11:02 tofmipd

/var:
drwxr-s--x    3 root     nobody         72 Nov 27 11:24 tmda

/var/tmda:
drwx--s---    6 cgitest  nobody        200 Nov 27 11:39 cgitest

/var/tmda/cgitest:
-rw-r-----    1 cgitest  nobody          0 Nov 27 11:39 config
-rw-r-----    1 cgitest  nobody         41 Nov 27 11:39 crypt_key
drwx--s---    2 cgitest  nobody         96 Nov 27 12:55 filters
drwx--s---    2 cgitest  nobody        144 Nov 27 12:59 lists
drwx--s---    2 cgitest  nobody        120 Nov 27 12:57 logs
drwxrws---    2 cgitest  nobody         48 Nov 27 11:37 pending
drwx--s---    2 cgitest  nobody        768 Nov 29 09:54 responses

/var/tmda/cgitest/filters:
-rw-rw----    1 cgitest  nobody        153 Nov 27 12:54 incoming
-rw-rw----    1 cgitest  nobody        150 Nov 27 12:55 outgoing

/var/tmda/cgitest/lists:
-rw-rw----    1 cgitest  nobody          0 Nov 27 12:59 blacklist
-rw-rw----    1 cgitest  nobody          0 Nov 27 12:59 confirmed
-rw-rw----    1 cgitest  nobody          0 Nov 27 12:59 whitelist

/var/tmda/cgitest/logs:
-rw-r-----    1 cgitest  nobody          0 Nov 27 12:57 debug
-rw-r-----    1 cgitest  nobody          0 Nov 27 12:57 in
-rw-r-----    1 cgitest  nobody          0 Nov 27 12:57 out

/etc/tmda-cgi:
cgitest:XPkY0q/9Uge9I

/var/tmda/cgitest/filters/incoming:
from-file /var/tmda/cgitest/lists/blacklist reject
from-file /var/tmda/cgitest/lists/whitelist accept
from-file /var/tmda/cgitest/lists/confirmed accept

/var/tmda/cgitest/filters/outgoing:
to-file /var/tmda/cgitest/lists/whitelist tag envelope dated=10d from bare
to-file /var/tmda/cgitest/lists/confirmed tag envelope dated=10d from bare

/etc/tmdarc:
import Util

DATADIR = &quot;/var/tmda/%s/&quot; % Util.getusername()
CGI_ACTIVE = 1
FILTER_INCOMING          = DATADIR + &quot;filters/incoming&quot;
FILTER_OUTGOING          = DATADIR + &quot;filters/outgoing&quot;
LOGFILE_DEBUG            = DATADIR + &quot;logs/debug&quot;
LOGFILE_INCOMING         = DATADIR + &quot;logs/in&quot;
LOGFILE_OUTGOING         = DATADIR + &quot;logs/out&quot;
PENDING_BLACKLIST_APPEND = DATADIR + &quot;lists/blacklist&quot;
PENDING_WHITELIST_APPEND = DATADIR + &quot;lists/whitelist&quot;
PENDING_FILE_PERM = 0660
ADDED_HEADERS_CLIENT = { &quot;X-Primary-Address&quot;: &quot;%s@%s&quot; % \
  (Util.getusername(), Util.gethostname()) }

~cgitest/.qmail:
|preline /usr/src/tmda/bin/tmda-filter -c /var/tmda/cgitest/config
./Maildir/</pre>
</blockquote>
<p>tmda-cgi was compiled with the following:</p>
<blockquote>
  <pre>./compile -nc /var/tmda/~/config -t /www/tmda.cgi</pre>
</blockquote>
<p>Use the <tt>./compile -h</tt> for more details on how to use compile.</p>
<h3>Passwords</h3>
<p>tmda-cgi currently authenticate logins against user name &amp; password pairs 
  stored in a password file (or files). tmda-cgi will look in two different places 
  for password file(s), but it (they) must be readable by the CGI.</p>
<p>If you are running in system-wide mode, the password file can be owned by root. 
  If you are running in single-user mode, the password file can be owned by the 
  user who will be running the CGI. If you are running in no-su mode, the file 
  must either be owned by &quot;nobody&quot; (or whatever user your web server 
  is configured to run as) or made globally readable See the table below for a 
  better breakdown of your options.</p>
<p>tmda-cgi first checks for a readable file called <tt>tmda-cgi</tt> in the same 
  directory as the user's configuration file (if that location has been specified, 
  otherwise it will look in <tt>~user/.tmda/tmda-cgi</tt>). It then tries 
<tt>/etc/tmda-cgi</tt> 
  if it can't find a match or cannot read the file. This allows the system 
administrator 
  to keep a list of access passwords while allowing the user to override what 
  the sysadmin has set.</p>
<table border="0" cellpadding="0" cellspacing="0">
  <tr> 
    <td width="35">&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td>&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td colspan="2" align="center" nowrap 
bgcolor="#FFFFCC"><tt>~user/.tmda/tmda-cgi</tt></td>
    <td width="10" align="center" nowrap>&nbsp;</td>
    <td colspan="2" align="center" nowrap bgcolor="#FFFFCC"><tt>/etc/tmda-cgi</tt></td>
  </tr>
  <tr> 
    <td>&nbsp;</td>
    <td>&nbsp;</td>
    <td>&nbsp;</td>
    <td>&nbsp;</td>
    <td width="80" align="center" bgcolor="#FFFFCC">owner</td>
    <td width="90" align="center" bgcolor="#FFFFCC">permissions</td>
    <td align="center">&nbsp;</td>
    <td width="80" align="center" bgcolor="#FFFFCC">owner</td>
    <td width="90" align="center" bgcolor="#FFFFCC">permissions</td>
  </tr>
  <tr> 
    <td>&nbsp;</td>
    <td bgcolor="#CCFFFF">&nbsp;</td>
    <td bgcolor="#CCFFFF">system-wide</td>
    <td bgcolor="#CCFFFF">&nbsp;</td>
    <td align="center" bgcolor="#CCFFCC">user</td>
    <td align="center" bgcolor="#CCFFCC">600</td>
    <td align="center" bgcolor="#CCFFFF">&nbsp;</td>
    <td align="center" bgcolor="#CCFFCC">root</td>
    <td align="center" bgcolor="#CCFFCC">600</td>
  </tr>
  <tr> 
    <td>&nbsp;</td>
    <td>&nbsp;</td>
    <td>single-user</td>
    <td>&nbsp;</td>
    <td align="center" bgcolor="#FFFFCC">user</td>
    <td align="center" bgcolor="#FFFFCC">600</td>
    <td align="center">&nbsp;</td>
    <td colspan="2" align="center" bgcolor="#FFFFCC">n/a</td>
  </tr>
  <tr> 
    <td>&nbsp;</td>
    <td bgcolor="#CCFFFF">&nbsp;</td>
    <td bgcolor="#CCFFFF">no-su</td>
    <td bgcolor="#CCFFFF">&nbsp;</td>
    <td align="center" bgcolor="#CCFFCC">user</td>
    <td align="center" bgcolor="#CCFFCC">644</td>
    <td align="center" bgcolor="#CCFFFF">&nbsp;</td>
    <td align="center" bgcolor="#CCFFCC">root<br>
      nobody </td>
    <td align="center" bgcolor="#CCFFCC">644<br>
      600 </td>
  </tr>
  <tr> 
    <td>&nbsp;</td>
    <td colspan="8" align="center">File owner &amp; permission options</td>
  </tr>
</table>
<p>The password file for tmda-cgi is formatted in much the same way as the password 
  file for tofmipd. In fact, if you are using a password file with tofmipd and 
  you wish to run tmda-cgi in system-wide mode, feel free to make a symbolic link 
  between the two:</p>
<blockquote> 
  <pre> # ln -s /etc/tofmipd /etc/tmda-cgi</pre>
</blockquote>
<p>Password files for tmda-cgi look like:</p>
<blockquote> 
  <pre>&lt;user1&gt;:&lt;password1&gt;
&lt;user2&gt;:&lt;password2&gt;</pre>
</blockquote>
<p>where each item in <tt>&lt;&gt;</tt> is replaced with text.</p>
<p>The difference between this password file and the one for tofmipd is that the 
  file does not need to have <br>
  permissions of 400 or 600. If you, for example, are running in no-su mode, you 
  will have to make your password file group or world readable.</p>
<p>To keep the passwords secure, tmda-cgi will assume all passwords are DES encrypted 
  if the file permissions are anything other than 400 or 600. Plaintext passwords 
  will <i><b>not</b></i> work in such cases.</p>
<p>Additionally, any entry with a blank password field, such as:</p>
<blockquote> 
  <pre>cantlogin:</pre>
</blockquote>
<p>will be prohibited from login, regardless of the file permissions.</p>
<p><tt>contrib/cgi/genpass.py</tt> is provided for encrypted password generation. 
  Output from <tt>genpass.py</tt> can be safely piped with <tt>&gt;</tt> or 
<tt>&gt;&gt;</tt> 
  into a password file. For example:</p>
<blockquote> 
  <pre># contrib/cgi/genpass.py joe &gt;&gt; /etc/tmda-cgi</pre>
</blockquote>
<p> or</p>
<blockquote> 
  <pre>$ contrib/cgi/genpass.py joe &gt; /home/joe/.tmda/tmda-cgi</pre>
</blockquote>
<p>If you encounter difficulties logging in, the problem may be a result of incorrect 
  permissions on your password file(s). To debug this, append a <tt>?debug=1</tt> 
  onto the end of your CGI URL. This will display some diagnostic information 
  if the login fails instead of simply saying &quot;Wrong password. Try 
again.&quot;</p>
<hr>
<h2>Configuration</h2>
<p>tmda-cgi is configured by a set of parameters in your <tt>/etc/tmdarc</tt>, 
  <tt>~user/.tmdarc</tt>, or <tt>~user/.tmda/config</tt> files. More details on 
  these variables can be found in your <tt>Defaults.py</tt>, but <b><i>do not 
  edit <tt>Defaults.py</tt></i></b>. Place your variables in your configuration 
  file(s) and they will override the defaults in <tt>Defaults.py</tt>.</p>
<dl>
  <dt><tt>CGI_ACTIVE</tt></dt>
  <br>
  &nbsp; 
  <dd>Must be set to 1 to use the tmda-cgi. Set this in <tt>/etc/tmdarc</tt> if 
    you set up tmda-cgi in system-wide mode.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_CLEANUP_ODDS</tt></dt>
  <br>
  &nbsp; 
  <dd>Chance of cleaning up temporary session files. You probably won't need to 
    adjust this parameter.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_DATE_FORMAT</tt></dt>
  <br>
  &nbsp; 
  <dd>Configuration string which sets the date format you see when viewing a list 
    of pending e-mails. It defaults to &quot;<tt>%a %1m/%d</tt>&quot; which generates 
    American-style dates like &quot;Mon 12/31&quot;.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_PAGER_SIZE</tt><br>
    &nbsp; </dt>
  <dd>Maximum number of e-mails shown on a listing page.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_SESSION_EXP</tt><br>
    &nbsp; </dt>
  <dd>The number of seconds a session may sit idle before it can expire. Set this 
    to a larger number if you surf pages so slowly that the program makes you 
    log in again.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_USE_JS_CONFIRM</tt><br>
    &nbsp; </dt>
  <dd>Set this to 0 if your browser cannot use Javascript or you don't like having 
    to confirm when you delete or blacklist an item.</dd>
  <br>
  &nbsp; 
  <dt><tt>CGI_USER</tt><br>
    &nbsp; </dt>
  <dd>Set this to the user name used by your web server. The default is 
&quot;nobody&quot;, 
    but some systems are configured to run as &quot;apache&quot; or other 
low-privilege 
    user.</dd>
  <br>
  &nbsp; 
</dl>

</TD><!-- end of body cell -->
</TR><!-- end of sidebar/body row -->
</TABLE><!-- end of page table -->
</BODY></HTML>

Index: bugs.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/bugs.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- bugs.html   25 Nov 2002 18:13:25 -0000      1.22
+++ bugs.html   1 Dec 2002 05:21:47 -0000       1.23
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: config-client.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-client.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- config-client.html  25 Nov 2002 18:13:25 -0000      1.43
+++ config-client.html  1 Dec 2002 05:21:47 -0000       1.44
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: config-filter.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-filter.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- config-filter.html  25 Nov 2002 18:13:25 -0000      1.35
+++ config-filter.html  1 Dec 2002 05:21:47 -0000       1.36
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: config-pre.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-pre.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- config-pre.html     25 Nov 2002 18:13:26 -0000      1.29
+++ config-pre.html     1 Dec 2002 05:21:47 -0000       1.30
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: config-server.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-server.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- config-server.html  25 Nov 2002 18:13:26 -0000      1.40
+++ config-server.html  1 Dec 2002 05:21:47 -0000       1.41
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: config-vars.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-vars.ht,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- config-vars.ht      25 Nov 2002 20:50:39 -0000      1.12
+++ config-vars.ht      1 Dec 2002 05:21:47 -0000       1.13
@@ -70,83 +70,83 @@
 <td><a href="#CGI_PAGER_SIZE">CGI_PAGER_SIZE</a></td>
 </tr>
 <tr>
-<td><a href="#CGI_PATH_TO_PENDING">CGI_PATH_TO_PENDING</a></td>
 <td><a href="#CGI_SESSION_EXP">CGI_SESSION_EXP</a></td>
+<td><a href="#CGI_USER">CGI_USER</a></td>
 </tr>
 <tr>
-<td><a href="#CGI_USER">CGI_USER</a></td>
 <td><a href="#CGI_USE_JS_CONFIRM">CGI_USE_JS_CONFIRM</a></td>
+<td><a href="#CONFIG_EXEC">CONFIG_EXEC</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIG_EXEC">CONFIG_EXEC</a></td>
 <td><a href="#CONFIRM_ACCEPT_CC">CONFIRM_ACCEPT_CC</a></td>
+<td><a href="#CONFIRM_ACCEPT_NOTIFY">CONFIRM_ACCEPT_NOTIFY</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_ACCEPT_NOTIFY">CONFIRM_ACCEPT_NOTIFY</a></td>
 <td><a 
href="#CONFIRM_ACCEPT_TEXT_ALREADY_CONFIRMED">CONFIRM_ACCEPT_TEXT_ALREADY_CONFIRMED</a></td>
+<td><a 
+href="#CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED">CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED</a></td>
 </tr>
 <tr>
-<td><a 
href="#CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED">CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED</a></td>
 <td><a href="#CONFIRM_ACCEPT_TEXT_INITIAL">CONFIRM_ACCEPT_TEXT_INITIAL</a></td>
+<td><a href="#CONFIRM_ADDRESS">CONFIRM_ADDRESS</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_ADDRESS">CONFIRM_ADDRESS</a></td>
 <td><a href="#CONFIRM_APPEND">CONFIRM_APPEND</a></td>
+<td><a href="#CONFIRM_CC">CONFIRM_CC</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_CC">CONFIRM_CC</a></td>
 <td><a href="#CONFIRM_MAX_MESSAGE_SIZE">CONFIRM_MAX_MESSAGE_SIZE</a></td>
+<td><a href="#CRYPT_KEY_FILE">CRYPT_KEY_FILE</a></td>
 </tr>
 <tr>
-<td><a href="#CRYPT_KEY_FILE">CRYPT_KEY_FILE</a></td>
 <td><a href="#DATADIR">DATADIR</a></td>
+<td><a href="#DATED_TEMPLATE_VARS">DATED_TEMPLATE_VARS</a></td>
 </tr>
 <tr>
-<td><a href="#DATED_TEMPLATE_VARS">DATED_TEMPLATE_VARS</a></td>
 <td><a href="#DELIVERY">DELIVERY</a></td>
+<td><a href="#FILTER_BOUNCE_CC">FILTER_BOUNCE_CC</a></td>
 </tr>
 <tr>
-<td><a href="#FILTER_BOUNCE_CC">FILTER_BOUNCE_CC</a></td>
 <td><a href="#FILTER_DROP_CC">FILTER_DROP_CC</a></td>
+<td><a href="#FILTER_INCOMING">FILTER_INCOMING</a></td>
 </tr>
 <tr>
-<td><a href="#FILTER_INCOMING">FILTER_INCOMING</a></td>
 <td><a href="#FILTER_OUTGOING">FILTER_OUTGOING</a></td>
+<td><a href="#FINGERPRINT">FINGERPRINT</a></td>
 </tr>
 <tr>
-<td><a href="#FINGERPRINT">FINGERPRINT</a></td>
 <td><a href="#FULLNAME">FULLNAME</a></td>
+<td><a href="#HMAC_BYTES">HMAC_BYTES</a></td>
 </tr>
 <tr>
-<td><a href="#HMAC_BYTES">HMAC_BYTES</a></td>
 <td><a href="#HOSTNAME">HOSTNAME</a></td>
+<td><a href="#LOCALDATE">LOCALDATE</a></td>
 </tr>
 <tr>
-<td><a href="#LOCALDATE">LOCALDATE</a></td>
 <td><a href="#LOGFILE_DEBUG">LOGFILE_DEBUG</a></td>
+<td><a href="#LOGFILE_INCOMING">LOGFILE_INCOMING</a></td>
 </tr>
 <tr>
-<td><a href="#LOGFILE_INCOMING">LOGFILE_INCOMING</a></td>
 <td><a href="#LOGFILE_OUTGOING">LOGFILE_OUTGOING</a></td>
+<td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 </tr>
 <tr>
-<td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 <td><a href="#MAX_AUTORESPONSES_PER_DAY">MAX_AUTORESPONSES_PER_DAY</a></td>
+<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 </tr>
 <tr>
-<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 <td><a href="#MESSAGE_TAG_HEADER_STYLE">MESSAGE_TAG_HEADER_STYLE</a></td>
+<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 </tr>
 <tr>
-<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 <td><a href="#PENDING_BLACKLIST_APPEND">PENDING_BLACKLIST_APPEND</a></td>
+<td><a href="#PENDING_CACHE">PENDING_CACHE</a></td>
 </tr>
 <tr>
-<td><a href="#PENDING_CACHE">PENDING_CACHE</a></td>
 <td><a href="#PENDING_CACHE_LEN">PENDING_CACHE_LEN</a></td>
+<td><a href="#PENDING_DELETE_APPEND">PENDING_DELETE_APPEND</a></td>
 </tr>
 <tr>
-<td><a href="#PENDING_DELETE_APPEND">PENDING_DELETE_APPEND</a></td>
+<td><a href="#PENDING_FILE_PERM">PENDING_FILE_PERM</a></td>
 <td><a href="#PENDING_RELEASE_APPEND">PENDING_RELEASE_APPEND</a></td>
 </tr>
 <tr>
@@ -599,18 +599,6 @@
 <br><br>
 Default is 25.
 <dt><hr>
-<a name="CGI_PATH_TO_PENDING"><h4>CGI_PATH_TO_PENDING</h4></a>
-<dd>
-*REQUIRED* path to tmda-pending.  tmda-cgi will not function if this
-variable is set wrong.
-<br><br>
-Example:
-<br><br>
-<code>CGI_PATH_TO_PENDING = "/usr/bin/tmda-pending"</code>
-<br><br>
-Default is "../../bin/tmda-pending" (which assumes you are running
-directly out of the source tree).
-<dt><hr>
 <a name="CGI_SESSION_EXP"><h4>CGI_SESSION_EXP</h4></a>
 <dd>
 Number of seconds a session is guaranteed to remain on the system
@@ -1066,6 +1054,18 @@
 <code>PENDING_DELETE_APPEND = "/full/path/to/blacklist"</code>
 <br><br>
 No default
+<dt><hr>
+<a name="PENDING_FILE_PERM"><h4>PENDING_FILE_PERM</h4></a>
+<dd>
+Numeric file permissions on e-mail in the pending directory.  The default
+is typically correct, but there are times when you might want group read
+permissions on your pending mail.
+<br><br>
+Example:
+<br><br>
+<code>PENDING_FILE_PERM = 0660</code>
+<br><br>
+Default is 0600
 <dt><hr>
 <a name="PENDING_RELEASE_APPEND"><h4>PENDING_RELEASE_APPEND</h4></a>
 <dd>

Index: config-vars.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-vars.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- config-vars.html    25 Nov 2002 20:50:39 -0000      1.16
+++ config-vars.html    1 Dec 2002 05:21:47 -0000       1.17
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 13:49:00 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:
@@ -233,83 +233,83 @@
 <td><a href="#CGI_PAGER_SIZE">CGI_PAGER_SIZE</a></td>
 </tr>
 <tr>
-<td><a href="#CGI_PATH_TO_PENDING">CGI_PATH_TO_PENDING</a></td>
 <td><a href="#CGI_SESSION_EXP">CGI_SESSION_EXP</a></td>
+<td><a href="#CGI_USER">CGI_USER</a></td>
 </tr>
 <tr>
-<td><a href="#CGI_USER">CGI_USER</a></td>
 <td><a href="#CGI_USE_JS_CONFIRM">CGI_USE_JS_CONFIRM</a></td>
+<td><a href="#CONFIG_EXEC">CONFIG_EXEC</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIG_EXEC">CONFIG_EXEC</a></td>
 <td><a href="#CONFIRM_ACCEPT_CC">CONFIRM_ACCEPT_CC</a></td>
+<td><a href="#CONFIRM_ACCEPT_NOTIFY">CONFIRM_ACCEPT_NOTIFY</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_ACCEPT_NOTIFY">CONFIRM_ACCEPT_NOTIFY</a></td>
 <td><a 
href="#CONFIRM_ACCEPT_TEXT_ALREADY_CONFIRMED">CONFIRM_ACCEPT_TEXT_ALREADY_CONFIRMED</a></td>
+<td><a 
+href="#CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED">CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED</a></td>
 </tr>
 <tr>
-<td><a 
href="#CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED">CONFIRM_ACCEPT_TEXT_ALREADY_RELEASED</a></td>
 <td><a href="#CONFIRM_ACCEPT_TEXT_INITIAL">CONFIRM_ACCEPT_TEXT_INITIAL</a></td>
+<td><a href="#CONFIRM_ADDRESS">CONFIRM_ADDRESS</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_ADDRESS">CONFIRM_ADDRESS</a></td>
 <td><a href="#CONFIRM_APPEND">CONFIRM_APPEND</a></td>
+<td><a href="#CONFIRM_CC">CONFIRM_CC</a></td>
 </tr>
 <tr>
-<td><a href="#CONFIRM_CC">CONFIRM_CC</a></td>
 <td><a href="#CONFIRM_MAX_MESSAGE_SIZE">CONFIRM_MAX_MESSAGE_SIZE</a></td>
+<td><a href="#CRYPT_KEY_FILE">CRYPT_KEY_FILE</a></td>
 </tr>
 <tr>
-<td><a href="#CRYPT_KEY_FILE">CRYPT_KEY_FILE</a></td>
 <td><a href="#DATADIR">DATADIR</a></td>
+<td><a href="#DATED_TEMPLATE_VARS">DATED_TEMPLATE_VARS</a></td>
 </tr>
 <tr>
-<td><a href="#DATED_TEMPLATE_VARS">DATED_TEMPLATE_VARS</a></td>
 <td><a href="#DELIVERY">DELIVERY</a></td>
+<td><a href="#FILTER_BOUNCE_CC">FILTER_BOUNCE_CC</a></td>
 </tr>
 <tr>
-<td><a href="#FILTER_BOUNCE_CC">FILTER_BOUNCE_CC</a></td>
 <td><a href="#FILTER_DROP_CC">FILTER_DROP_CC</a></td>
+<td><a href="#FILTER_INCOMING">FILTER_INCOMING</a></td>
 </tr>
 <tr>
-<td><a href="#FILTER_INCOMING">FILTER_INCOMING</a></td>
 <td><a href="#FILTER_OUTGOING">FILTER_OUTGOING</a></td>
+<td><a href="#FINGERPRINT">FINGERPRINT</a></td>
 </tr>
 <tr>
-<td><a href="#FINGERPRINT">FINGERPRINT</a></td>
 <td><a href="#FULLNAME">FULLNAME</a></td>
+<td><a href="#HMAC_BYTES">HMAC_BYTES</a></td>
 </tr>
 <tr>
-<td><a href="#HMAC_BYTES">HMAC_BYTES</a></td>
 <td><a href="#HOSTNAME">HOSTNAME</a></td>
+<td><a href="#LOCALDATE">LOCALDATE</a></td>
 </tr>
 <tr>
-<td><a href="#LOCALDATE">LOCALDATE</a></td>
 <td><a href="#LOGFILE_DEBUG">LOGFILE_DEBUG</a></td>
+<td><a href="#LOGFILE_INCOMING">LOGFILE_INCOMING</a></td>
 </tr>
 <tr>
-<td><a href="#LOGFILE_INCOMING">LOGFILE_INCOMING</a></td>
 <td><a href="#LOGFILE_OUTGOING">LOGFILE_OUTGOING</a></td>
+<td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 </tr>
 <tr>
-<td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 <td><a href="#MAX_AUTORESPONSES_PER_DAY">MAX_AUTORESPONSES_PER_DAY</a></td>
+<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 </tr>
 <tr>
-<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 <td><a href="#MESSAGE_TAG_HEADER_STYLE">MESSAGE_TAG_HEADER_STYLE</a></td>
+<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 </tr>
 <tr>
-<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 <td><a href="#PENDING_BLACKLIST_APPEND">PENDING_BLACKLIST_APPEND</a></td>
+<td><a href="#PENDING_CACHE">PENDING_CACHE</a></td>
 </tr>
 <tr>
-<td><a href="#PENDING_CACHE">PENDING_CACHE</a></td>
 <td><a href="#PENDING_CACHE_LEN">PENDING_CACHE_LEN</a></td>
+<td><a href="#PENDING_DELETE_APPEND">PENDING_DELETE_APPEND</a></td>
 </tr>
 <tr>
-<td><a href="#PENDING_DELETE_APPEND">PENDING_DELETE_APPEND</a></td>
+<td><a href="#PENDING_FILE_PERM">PENDING_FILE_PERM</a></td>
 <td><a href="#PENDING_RELEASE_APPEND">PENDING_RELEASE_APPEND</a></td>
 </tr>
 <tr>
@@ -762,18 +762,6 @@
 <br><br>
 Default is 25.
 <dt><hr>
-<a name="CGI_PATH_TO_PENDING"><h4>CGI_PATH_TO_PENDING</h4></a>
-<dd>
-*REQUIRED* path to tmda-pending.  tmda-cgi will not function if this
-variable is set wrong.
-<br><br>
-Example:
-<br><br>
-<code>CGI_PATH_TO_PENDING = "/usr/bin/tmda-pending"</code>
-<br><br>
-Default is "../../bin/tmda-pending" (which assumes you are running
-directly out of the source tree).
-<dt><hr>
 <a name="CGI_SESSION_EXP"><h4>CGI_SESSION_EXP</h4></a>
 <dd>
 Number of seconds a session is guaranteed to remain on the system
@@ -1229,6 +1217,18 @@
 <code>PENDING_DELETE_APPEND = "/full/path/to/blacklist"</code>
 <br><br>
 No default
+<dt><hr>
+<a name="PENDING_FILE_PERM"><h4>PENDING_FILE_PERM</h4></a>
+<dd>
+Numeric file permissions on e-mail in the pending directory.  The default
+is typically correct, but there are times when you might want group read
+permissions on your pending mail.
+<br><br>
+Example:
+<br><br>
+<code>PENDING_FILE_PERM = 0660</code>
+<br><br>
+Default is 0600
 <dt><hr>
 <a name="PENDING_RELEASE_APPEND"><h4>PENDING_RELEASE_APPEND</h4></a>
 <dd>

Index: config.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- config.html 25 Nov 2002 18:13:27 -0000      1.26
+++ config.html 1 Dec 2002 05:21:47 -0000       1.27
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: download.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/download.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- download.html       25 Nov 2002 18:13:28 -0000      1.35
+++ download.html       1 Dec 2002 05:21:47 -0000       1.36
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: features.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/features.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- features.html       25 Nov 2002 18:13:28 -0000      1.34
+++ features.html       1 Dec 2002 05:21:47 -0000       1.35
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: filter-sources.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/filter-sources.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- filter-sources.html 25 Nov 2002 18:13:28 -0000      1.7
+++ filter-sources.html 1 Dec 2002 05:21:47 -0000       1.8
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:41 2002 -->
+<!-- Sat Nov 30 22:15:46 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: history.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/history.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- history.html        25 Nov 2002 18:13:28 -0000      1.17
+++ history.html        1 Dec 2002 05:21:47 -0000       1.18
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: howto-links.h
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/howto-links.h,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- howto-links.h       25 Oct 2002 02:01:46 -0000      1.2
+++ howto-links.h       1 Dec 2002 05:21:47 -0000       1.3
@@ -3,3 +3,4 @@
 <li><a href="howtos.html">Overview</a>
 <li><a href="howto-template.html">Templates</a>
 <li><a href="tmda-ofmipd.html">tmda-ofmipd</a>
+<li><a href="tmda-cgi.html">tmda-cgi</a>
\ No newline at end of file

Index: howto-template.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/howto-template.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- howto-template.html 25 Nov 2002 18:13:28 -0000      1.7
+++ howto-template.html 1 Dec 2002 05:21:47 -0000       1.8
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:
@@ -106,6 +106,9 @@
 </TD></TR>
 <TR><TD BGCOLOR="#cccccc">
 <A HREF="tmda-ofmipd.html">tmda-ofmipd</A>
+</TD></TR>
+<TR><TD BGCOLOR="#cccccc">
+<A HREF="tmda-cgi.html">tmda-cgi</A>
 </TD></TR>
 <TR><TD BGCOLOR="#cccccc">&nbsp;
 <TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">

Index: howtos.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/howtos.ht,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- howtos.ht   13 Jul 2002 23:03:26 -0000      1.1
+++ howtos.ht   1 Dec 2002 05:21:47 -0000       1.2
@@ -3,5 +3,20 @@
 
 <h3>TMDA HOWTOs</h3>
 
-Special topics requiring more in-depth coverage.  See the HOWTOs sidebar 
-for a list of available documents.
+Special topics requiring more in-depth coverage.
+
+<ul>
+
+<li><a href="howto-template.html">Templates</a>: 
+how to customize your TMDA auto responses.
+<br><br>
+
+<li><a href="tmda-ofmipd.html">tmda-ofmipd</a>: 
+how to tag your outgoing mail through SMTP.
+<br><br>
+
+<li><a href="tmda-cgi.html">tmda-cgi</a>: 
+how to access your pending queue over the web.
+<br><br>
+
+</ul>
\ No newline at end of file

Index: howtos.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/howtos.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- howtos.html 25 Nov 2002 18:13:28 -0000      1.9
+++ howtos.html 1 Dec 2002 05:21:47 -0000       1.10
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:
@@ -107,6 +107,9 @@
 <TR><TD BGCOLOR="#cccccc">
 <A HREF="tmda-ofmipd.html">tmda-ofmipd</A>
 </TD></TR>
+<TR><TD BGCOLOR="#cccccc">
+<A HREF="tmda-cgi.html">tmda-cgi</A>
+</TD></TR>
 <TR><TD BGCOLOR="#cccccc">&nbsp;
 <TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">
 Support
@@ -154,9 +157,23 @@
 <TD VALIGN=TOP WIDTH="90%"><BR>
 <h3>TMDA HOWTOs</h3>
 
-Special topics requiring more in-depth coverage.  See the HOWTOs sidebar 
-for a list of available documents.
+Special topics requiring more in-depth coverage.
+
+<ul>
+
+<li><a href="howto-template.html">Templates</a>: 
+how to customize your TMDA auto responses.
+<br><br>
+
+<li><a href="tmda-ofmipd.html">tmda-ofmipd</a>: 
+how to tag your outgoing mail through SMTP.
+<br><br>
+
+<li><a href="tmda-cgi.html">tmda-cgi</a>: 
+how to access your pending queue over the web.
+<br><br>
 
+</ul>
 </TD><!-- end of body cell -->
 </TR><!-- end of sidebar/body row -->
 </TABLE><!-- end of page table -->

Index: index.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/index.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- index.html  25 Nov 2002 18:13:28 -0000      1.28
+++ index.html  1 Dec 2002 05:21:47 -0000       1.29
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: install.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/install.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- install.html        25 Nov 2002 18:13:29 -0000      1.30
+++ install.html        1 Dec 2002 05:21:47 -0000       1.31
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: inuse.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/inuse.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- inuse.html  25 Nov 2002 18:13:29 -0000      1.34
+++ inuse.html  1 Dec 2002 05:21:47 -0000       1.35
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: press.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/press.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- press.html  25 Nov 2002 18:13:29 -0000      1.9
+++ press.html  1 Dec 2002 05:21:47 -0000       1.10
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: requirements.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/requirements.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- requirements.html   25 Nov 2002 18:13:29 -0000      1.33
+++ requirements.html   1 Dec 2002 05:21:47 -0000       1.34
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: resources.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/resources.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- resources.html      25 Nov 2002 18:13:29 -0000      1.33
+++ resources.html      1 Dec 2002 05:21:47 -0000       1.34
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: results.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/results.html,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- results.html        25 Nov 2002 18:13:30 -0000      1.32
+++ results.html        1 Dec 2002 05:21:47 -0000       1.33
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: support-commercial.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/support-commercial.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- support-commercial.html     25 Nov 2002 18:13:31 -0000      1.7
+++ support-commercial.html     1 Dec 2002 05:21:47 -0000       1.8
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

Index: tmda-cgi.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/tmda-cgi.ht,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- tmda-cgi.ht 30 Nov 2002 18:24:43 -0000      1.4
+++ tmda-cgi.ht 1 Dec 2002 05:21:47 -0000       1.5
@@ -2,7 +2,7 @@
 Links: overview-links.h usage-links.h howto-links.h support-links.h
 
 <h1>tmda-cgi</h1>
-<hr width="90%">
+<hr>
 <h2>What is it?</h2>
 <p>tmda-cgi is an alpha-release program for managing your TMDA account over the 
   web. At the time of this writing, tmda-cgi can:</p>
@@ -60,11 +60,11 @@
     <p> &quot;Wow, I would have gotten 100 e-mails about Viagara, cheap cigarettes, 
       weight loss drugs, penis enlargement, and Nigerian swindles today! Now I 
       remember why the rest of my family thinks that e-mail is a pain.&quot;</ul>
-<hr width="90%">
+<hr>
 <h2>Requirements</h2>
 <p>TBD. Until we do more testing it isn't clear what systems have problems with 
   tmda-cgi.</p>
-<hr width="90%">
+<hr>
 <h2>Installation</h2>
 <p>tmda-cgi is provided in your distribution's <tt>contrib/cgi</tt> directory, 
   however with this being alpha-revision software, revisions come out quite 
frequently. 
@@ -372,7 +372,7 @@
   permissions on your password file(s). To debug this, append a <tt>?debug=1</tt> 
   onto the end of your CGI URL. This will display some diagnostic information 
   if the login fails instead of simply saying &quot;Wrong password. Try 
again.&quot;</p>
-<hr width="90%">
+<hr>
 <h2>Configuration</h2>
 <p>tmda-cgi is configured by a set of parameters in your <tt>/etc/tmdarc</tt>, 
   <tt>~user/.tmdarc</tt>, or <tt>~user/.tmda/config</tt> files. More details on 

Index: tmda-ofmipd.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/tmda-ofmipd.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- tmda-ofmipd.html    25 Nov 2002 18:13:31 -0000      1.12
+++ tmda-ofmipd.html    1 Dec 2002 05:21:47 -0000       1.13
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:
@@ -106,6 +106,9 @@
 </TD></TR>
 <TR><TD BGCOLOR="#cccccc">
 <b>tmda-ofmipd</b>
+</TD></TR>
+<TR><TD BGCOLOR="#cccccc">
+<A HREF="tmda-cgi.html">tmda-cgi</A>
 </TD></TR>
 <TR><TD BGCOLOR="#cccccc">&nbsp;
 <TR><TD BGCOLOR="#191970"><B><FONT COLOR="#ffffff">

Index: trouble.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/trouble.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- trouble.html        25 Nov 2002 18:13:31 -0000      1.18
+++ trouble.html        1 Dec 2002 05:21:47 -0000       1.19
@@ -1,6 +1,6 @@
 <HTML>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Mon Nov 25 11:10:42 2002 -->
+<!-- Sat Nov 30 22:15:47 2002 -->
 <!-- USING HT2HTML 1.2 -->
 <!-- SEE http://barry.wooz.org/software/ht2html -->
 <!-- User-specified headers:

_______________________________________
tmda-cvs mailing list
http://tmda.net/lists/listinfo/tmda-cvs

Reply via email to