From 83299343cf510c6e2fdda33f1b55ab826b0b54af Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 19 Nov 2004 00:53:16 +0000 Subject: [PATCH] update manpage and homepage --- _smtpd | 4 ++- _smtpd.html | 113 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 116 insertions(+), 1 deletion(-) create mode 100644 _smtpd.html diff --git a/_smtpd b/_smtpd index 78550c4..4c9b36d 100644 --- a/_smtpd +++ b/_smtpd @@ -74,7 +74,7 @@ _smtpd - UnderSMTPD, the underscore SMTP daemon =head1 SYNOPSIS #make some aliases - echo 'username: "|someprogram and args" > /etc/aliases + echo 'username: "|someprogram and args"' > /etc/aliases #inetd setup echo "smtp stream tcp nowait mail /usr/local/bin/_smtpd" >>/etc/inetd.conf @@ -117,6 +117,8 @@ UnderSMTP uses Net::SMTP::Mail to do all the hard work. =item -a filename: Alternate aliases file +=back + =head1 ALIASES FORMAT username: |program and args diff --git a/_smtpd.html b/_smtpd.html new file mode 100644 index 0000000..858dee8 --- /dev/null +++ b/_smtpd.html @@ -0,0 +1,113 @@ + + + +_smtpd - UnderSMTPD, the underscore SMTP daemon + + + + + +

+ + +

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ALIASES FORMAT
RT ALIASES EXAMPLE
BUGS
AUTHOR
SEE ALSO

+ + +

NAME

_smtpd - UnderSMTPD, the underscore SMTP daemon

SYNOPSIS

+  #make some aliases
+  echo 'username: "|someprogram and args" > /etc/aliases

+  #inetd setup
+  echo "smtp stream tcp nowait mail /usr/local/bin/_smtpd" >>/etc/inetd.conf
+  echo "_smtpd: my.mail.server.ip"                         >>/etc/hosts.allow
+  echo "_smtpd: ALL"                                       >>/etc/hosts.deny

+  #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
+  }

DESCRIPTION

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.

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.

Other kinds of aliases are not recognized and cause a perminant SMTP error +to be returned to the connecting client, as do usernames not found in +/etc/aliases

UnderSMTP was originally written to be used with the Request Tracker ticketing +system.

UnderSMTP uses Net::SMTP::Mail to do all the hard work.

OPTIONS

-a filename: Alternate aliases file
+

ALIASES FORMAT

+  username: |program and args
+  username: "|program and args"

Quotes are not necessary around the pipe symbol, program and arguments but are +stripped if present. Line continuations are not supported.

RT ALIASES EXAMPLE

+  support: |/opt/rt3/bin/rt-mailgate --queue support --action correspond --url http://rt.example.com/
+  billing: |/opt/rt3/bin/rt-mailgate --queue billing --action correspond --url http://rt.example.com/

BUGS

Yes.

AUTHOR

Ivan Kohler <ivan-undersmtpd@420.am>