listenport.html #1

  • //
  • guest/
  • bryan_costales/
  • docs/
  • conf/
  • listenport.html
  • View
  • Commits
  • Open Download .zip Download (3 KB)
<html>
<b>NAME</b><br>
ListenPort - slow.conf configuration item
<p>
<b>SYNOPSIS</b><br>
<code><ul>
ListenPort = unix|local:/path/file<br>
ListenPort = inet:port@{hostname|ip-address}<br>
</ul></code>
<p>
<b>DESCRIPTION</b><br>
The ListenPort slow.conf configuration item determines
where and how the milter will listen for inbound connections
from sendmail.
<p>
<font color="red">
Note: You must 
<a href="listenport.html#sendmail">configure sendmail</a>
to match this item.
</font>
<p>
If this ListenPort item must be declared (the default is
<code>inet:99@localhost</code> which is likely not
suitable for any host).
<p>
There are two ways to declare ListenPort: as a Unix-domain
socket; or as a TCP/IP socket. The first is more suitable
if you expect only the local host to contact the milter.
The second is more suitable if you expect outside hosts
(other hosts on your network) to contact the milter.
<h3>Unix-Domain Sockets</h3>
A Unix-domain socket is specified in the form:
<code><ul>
ListenPort = unix|local:/path/file<br>
</ul></code>
The prefix is one or the other of the <code>unix</code> or
<code>local</code> keywords. That keyword is immediately
followed by a colon, and then by the full pathname of
the Unix-doman socket. Because the milter must not
run as <i>root</i>, you need to locate that socket
in a directory where the milter has write permission.
The milter creates the socket file when it starts to run,
and removes the socket file when it is done.
<h3>TCP/IP Sockets</h3>
A TCP/IP socket is specified in the form:
<code><ul>
ListenPort = inet:port@{hostname|ip-address}<br>
</ul></code>
The keyword <code>inet</code> is first, immediately followed
fy a colon. Next is a port number to listen on, an '@' symbol,
and finally either the name of a host or its IP number.
The <code>port</code> should be above 1024 (because lower
numbers can only be opened by <i>root</i>, and the milter
never runs as <i>root</i>). The <code>hostname</code>
is the host name associated with the interface upon which
you intend the milter to listen. If you have multiple
interfaces, this will select only one unless they all
share a single name. In place of a host name, you may
alternatively specify an IP number.
<a name="sendmail"><h3>Sendmail Configuration</h3></a>
Whichever way you declare ListenPort, you will need to
use the same declaration in your sendmail mc configuration
file:
<code><ul>
INPUT_MAIL_FILTER(`slowmilt', ``S=inet:8765@host.domain,T=R:40s'')
</ul></code>
Here (this single line may have wrapped to fit the window), we specify
port 8765, which is otherwise unused on our system. The host.domain
are those of our internal network interface. Your interface
may differ, depending you your particular setup.
<p>
See the sendmail documentation for the meaning of the <code>T=</code>
and other available milter flags.
<p>
Don't forget that if you are running more than one milter,
you will need to list the order that they are called by listing them
something like this:
<code><ul>
define(`confINPUT_MAIL_FILTERS', ``othermilter, slowmilt'')
</ul></code>
The <code>othermilter</code> should be first, because it will detect
spam that the <b>slowmilt</b> milter may miss, and thus will
allow the <b>slowmilt</b> milter to record that fact if the
<a href="milterabort.html">MilterAbort</a> configuration item
is defined as true.
<p>
</body>
</html>	
# Change User Description Committed
#1 3998 bryan_costales Brought the whole distribution up to V0.9
Added a huge abount of documentation.
Added slowedit find
Created startup scripts to launch for testing
Fixed numerous bugs.
Fixed a few portablity issues.
Installed hooks for whitelisting and IP aliases.