index.html revision 112810
190792Sgshapiro<html> 290792Sgshapiro<head> 390792Sgshapiro<title>Filtering Mail with Sendmail</title> 490792Sgshapiro</head> 590792Sgshapiro<body> 690792Sgshapiro<!-- 7112810Sgshapiro$Id: index.html,v 1.10.4.1 2003/03/05 19:54:19 ca Exp $ 890792Sgshapiro--> 990792Sgshapiro 1090792Sgshapiro<h1>Filtering Mail with Sendmail</h1> 1190792Sgshapiro 1290792Sgshapiro<!-- 1390792Sgshapiro<P><b>Disclaimer</b>: 1490792SgshapiroThis preliminary API description is provided for review only. This 1590792Sgshapirospecification may change based on feedback from reviewers, and does 1690792Sgshapironot bind Sendmail to offer this functionality in any release. 1790792Sgshapiro--> 1890792Sgshapiro 1990792Sgshapiro<h2>Introduction</h2> 2090792Sgshapiro 2190792Sgshapiro<P> 2290792SgshapiroSendmail's Content Management API (milter) provides third-party 2390792Sgshapiroprograms to access mail messages as they are being processed by the 2490792SgshapiroMail Transfer Agent (MTA), allowing them to examine and modify message 2590792Sgshapirocontent and meta-information. Filtering policies implemented by 2690792SgshapiroMilter-conformant filters may then be centrally configured and 2790792Sgshapirocomposed in an end-user's MTA configuration file. 2890792Sgshapiro 2990792Sgshapiro<p> 3090792SgshapiroPossible uses for filters include spam rejection, virus 3190792Sgshapirofiltering, and content control. In general, Milter seeks to address 3290792Sgshapirosite-wide filtering concerns in a scalable way. Individual users' mail 3390792Sgshapirofiltering needs (e.g. sorting messages by subject) are left to 3490792Sgshapiroclient-level programs such as <a href="http://www.procmail.org">Procmail</a>. 3590792Sgshapiro 3690792Sgshapiro<P> 3790792SgshapiroThis document is a technical introduction intended for those 3890792Sgshapirointerested in developing Milter filters. It includes: 3990792Sgshapiro<ul> 4090792Sgshapiro<li>A description of Milter's design goals. 4190792Sgshapiro 4290792Sgshapiro<li>An explanation of Milter application architecture, including 4390792Sgshapirointeractions between the support library and user code, and between 4490792Sgshapirofilters and the MTA. 4590792Sgshapiro 4690792Sgshapiro<li>A specification of the C application programming interface. 4790792Sgshapiro<li>An example of a simple Milter filter. 4890792Sgshapiro</ul> 4990792Sgshapiro 5090792Sgshapiro<h2>Contents</h2> 5190792Sgshapiro 5290792Sgshapiro<ul> 5390792Sgshapiro<li><a href="design.html">Architecture</a> 5490792Sgshapiro<ul> 5590792Sgshapiro <li>Design Goals 5690792Sgshapiro <li>Implementing Filtering Policies 5790792Sgshapiro <li>MTA - Filter communication 5890792Sgshapiro</ul> 5990792Sgshapiro<li><a href="overview.html">Technical Overview</a> 6090792Sgshapiro<ul> 6190792Sgshapiro <li>Initialization 6290792Sgshapiro <li>Control flow 6390792Sgshapiro <li>Multithreading 6490792Sgshapiro <li>Resource Management 6590792Sgshapiro <li>Signal Handling 6690792Sgshapiro</ul> 6790792Sgshapiro<li><a href="api.html">API Documentation</a> 6890792Sgshapiro<ul> 6990792Sgshapiro <li>Library Control Functions 7090792Sgshapiro <li>Data Access Functions 7190792Sgshapiro <li>Message Modification Functions 7290792Sgshapiro <li>Callbacks 7390792Sgshapiro</ul> 7490792Sgshapiro<li><a href="installation.html">Installation and Configuration</a> 7590792Sgshapiro<ul> 7690792Sgshapiro <li>Compiling and Installing Your Filter 7790792Sgshapiro <li>Configuring Sendmail 7890792Sgshapiro</ul> 7990792Sgshapiro<li><a href="sample.html">A Sample Filter</a> 8090792Sgshapiro<!-- <li><a href="other.html">Other Sources of Information</a> --> 8190792Sgshapiro</ul> 8290792Sgshapiro 8390792Sgshapiro<hr size="1"> 8490792Sgshapiro<font size="-1"> 85112810SgshapiroCopyright (c) 2000, 2001, 2003 Sendmail, Inc. and its suppliers. 8690792SgshapiroAll rights reserved. 8790792Sgshapiro<br> 8890792SgshapiroBy using this file, you agree to the terms and conditions set 89112810Sgshapiroforth in the LICENSE. 9090792Sgshapiro</font> 9190792Sgshapiro</body> 9290792Sgshapiro</html> 93