_smtpd.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>_smtpd - UnderSMTPD, the underscore SMTP daemon</title>
<link rev="made" href="mailto:root@localhost" />
</head>

<body style="background-color: white">

<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->

<ul>

	<li><a href="#name">NAME</a></li>
	<li><a href="#synopsis">SYNOPSIS</a></li>
	<li><a href="#description">DESCRIPTION</a></li>
	<li><a href="#options">OPTIONS</a></li>
	<li><a href="#aliases_format">ALIASES FORMAT</a></li>
	<li><a href="#rt_aliases_example">RT ALIASES EXAMPLE</a></li>
	<li><a href="#bugs">BUGS</a></li>
	<li><a href="#author">AUTHOR</a></li>
	<li><a href="#see_also">SEE ALSO</a></li>
</ul>
<!-- INDEX END -->

<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>_smtpd - UnderSMTPD, the underscore SMTP daemon</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
  #make some aliases
  echo 'username: &quot;|someprogram and args&quot;' &gt; /etc/aliases</pre>
<pre>
  #inetd setup
  echo &quot;smtp stream tcp nowait mail /usr/local/bin/_smtpd&quot; &gt;&gt;/etc/inetd.conf
  echo &quot;_smtpd: my.mail.server.ip&quot;                         &gt;&gt;/etc/hosts.allow
  echo &quot;_smtpd: ALL&quot;                                       &gt;&gt;/etc/hosts.deny</pre>
<pre>
  #or add an smtp file to /etc/xinetd.d/
  service smtp
  {
        socket_type = stream
        protocol    = tcp
        wait        = no
        user        = mail
        server      = /usr/local/bin/_smtpd
  }</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This is a minimal SMTP server which only forwards mail to pipe destinations
in /etc/aliases.  It does nothing else.  Its intended function is on an
internal mail server that forwards mail to other programs on a per address
basis.</p>
<p>UnderSMTPD reads /etc/aliases for usernames; if a match is identified
the message is piped to the given program.  Any problems executing the program
will cause a temporary SMTP error to be returned to the connecting client.</p>
<p>Other kinds of aliases are not recognized and cause a permanent SMTP error
to be returned to the connecting client, as do usernames not found in
/etc/aliases</p>
<p>UnderSMTPD was originally written to be used with the Request Tracker ticketing
system.</p>
<p>UnderSMTPD uses Net::Server::Mail to do all the hard work.</p>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
<dl>
<dt><strong><a name="item__2da_filename_3a_alternate_aliases_file">-a filename: Alternate aliases file</a></strong><br />
</dt>
</dl>
<p>
</p>
<hr />
<h1><a name="aliases_format">ALIASES FORMAT</a></h1>
<pre>
  username: |program and args
  username: &quot;|program and args&quot;</pre>
<p>Quotes are not necessary around the pipe symbol, program and arguments but are
stripped if present.  Line continuations are not supported.</p>
<p>
</p>
<hr />
<h1><a name="rt_aliases_example">RT ALIASES EXAMPLE</a></h1>
<pre>
  support: |/opt/rt3/bin/rt-mailgate --queue support --action correspond --url <a href="http://rt.example.com/">http://rt.example.com/</a>
  billing: |/opt/rt3/bin/rt-mailgate --queue billing --action correspond --url <a href="http://rt.example.com/">http://rt.example.com/</a></pre>
<p>
</p>
<hr />
<h1><a name="bugs">BUGS</a></h1>
<p>Yes.</p>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<p>Ivan Kohler &lt;<a href="mailto:ivan-undersmtpd@420.am">ivan-undersmtpd@420.am</a>&gt;</p>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><a href="/Net/Server/Mail.html">the Net::Server::Mail manpage</a></p>

</body>

</html>