1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
4 <title>_smtpd - UnderSMTPD, the underscore SMTP daemon</title>
5 <link rev="made" href="mailto:root@localhost" />
8 <body style="background-color: white">
10 <p><a name="__index__"></a></p>
15 <li><a href="#name">NAME</a></li>
16 <li><a href="#synopsis">SYNOPSIS</a></li>
17 <li><a href="#description">DESCRIPTION</a></li>
18 <li><a href="#options">OPTIONS</a></li>
19 <li><a href="#aliases_format">ALIASES FORMAT</a></li>
20 <li><a href="#rt_aliases_example">RT ALIASES EXAMPLE</a></li>
21 <li><a href="#bugs">BUGS</a></li>
22 <li><a href="#author">AUTHOR</a></li>
23 <li><a href="#see_also">SEE ALSO</a></li>
30 <h1><a name="name">NAME</a></h1>
31 <p>_smtpd - UnderSMTPD, the underscore SMTP daemon</p>
35 <h1><a name="synopsis">SYNOPSIS</a></h1>
38 echo 'username: "|someprogram and args"' > /etc/aliases</pre>
41 echo "smtp stream tcp nowait mail /usr/local/bin/_smtpd" >>/etc/inetd.conf
42 echo "_smtpd: my.mail.server.ip" >>/etc/hosts.allow
43 echo "_smtpd: ALL" >>/etc/hosts.deny</pre>
45 #or add an smtp file to /etc/xinetd.d/
52 server = /usr/local/bin/_smtpd
57 <h1><a name="description">DESCRIPTION</a></h1>
58 <p>This is a minimal SMTP server which only forwards mail to pipe destinations
59 in /etc/aliases. It does nothing else. Its intended function is on an
60 internal mail server that forwards mail to other programs on a per address
62 <p>UnderSMTPD reads /etc/aliases for usernames; if a match is identified
63 the message is piped to the given program. Any problems executing the program
64 will cause a temporary SMTP error to be returned to the connecting client.</p>
65 <p>Other kinds of aliases are not recognized and cause a permanent SMTP error
66 to be returned to the connecting client, as do usernames not found in
68 <p>UnderSMTP was originally written to be used with the Request Tracker ticketing
70 <p>UnderSMTP uses Net::Server::Mail to do all the hard work.</p>
74 <h1><a name="options">OPTIONS</a></h1>
76 <dt><strong><a name="item__2da_filename_3a_alternate_aliases_file">-a filename: Alternate aliases file</a></strong><br />
82 <h1><a name="aliases_format">ALIASES FORMAT</a></h1>
84 username: |program and args
85 username: "|program and args"</pre>
86 <p>Quotes are not necessary around the pipe symbol, program and arguments but are
87 stripped if present. Line continuations are not supported.</p>
91 <h1><a name="rt_aliases_example">RT ALIASES EXAMPLE</a></h1>
93 support: |/opt/rt3/bin/rt-mailgate --queue support --action correspond --url <a href="http://rt.example.com/">http://rt.example.com/</a>
94 billing: |/opt/rt3/bin/rt-mailgate --queue billing --action correspond --url <a href="http://rt.example.com/">http://rt.example.com/</a></pre>
98 <h1><a name="bugs">BUGS</a></h1>
103 <h1><a name="author">AUTHOR</a></h1>
104 <p>Ivan Kohler <<a href="mailto:ivan-undersmtpd@420.am">ivan-undersmtpd@420.am</a>></p>
108 <h1><a name="see_also">SEE ALSO</a></h1>
109 <p><a href="/Net/Server/Mail.html">the Net::Server::Mail manpage</a></p>