.\" Man page for noattach
.\"
.\" $Id$
.\" Copyright (C) 2002 Olafur Osvaldsson
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
.\"
.\"
.Dd April 11, 2002
.Dt NOATTACH 8
.Os
.Sh NAME
.Nm noattach
.Nd scan email messages for bad attachments
.Sh SYNOPSIS
.Nm
.Op Fl hn
.Op Fl p Ar portinfo
.Sh DESCRIPTION
.Nm Noattach
is a milter that parses the body of email messages from
.Xr sendmail 8
and checks if the filename of attachments matches one of the regular
expressions in a given pattern file and rejects those emails that match.
.Pp
Filenames are rfc2047 or rfc2231 decoded if needed.
.Pp
The options are as follows:
.Bl -tag -width Fl
.It Fl h
Display a short help with commandline options.
.It Fl n
Makes the program stay in foreground, i.e. don't fork into the background
and don't update the pid file
.It Fl p Ar portinfo
The port to listen to
.El
.Sh EXAMPLES
.Pp
Listen to ipv4 port 26 on localhost:
.Pp
.Nm
-p inet:26@localhost
.Pp
Listen on a unix socket:
.Pp
.Nm
-p local:/var/run/f1.sock
.Pp
You also need to add INPUT_MAIL_FILTER to the .mc file you use to make the
sendmail.cf.
.Pp
Information about the parameters for INPUT_MAIL_FILTER is in the
README.libmilter file wich is in the source tree.
.Sh FILES
These pathnames are set at complie time.
.Pp
.Pa /usr/local/etc/noattach.patterns
.D1 Regular expressions used to find bad attachments.
.Sh SEE ALSO
.Xr sendmail 8
.Rs
http://www.sendmail.org/
.Re
.Rs
http://www.milter.org/
.Re
.Sh AUTHORS
.An "Olafur Osvaldsson" Aq oli@isnic.is
.Sh BUGS
IPv6 has not been tested at all.