xref: /freebsd/contrib/sendmail/libmilter/docs/smfi_main.html (revision e92d3f3ffe83a6ed7eaafac70da9cf4fafe13243)
140266059SGregory Neil Shapiro<html>
240266059SGregory Neil Shapiro<head><title>smfi_main</title></head>
340266059SGregory Neil Shapiro<body>
4e92d3f3fSGregory Neil Shapiro<!--
5e92d3f3fSGregory Neil Shapiro$Id: smfi_main.html,v 1.7 2003/03/05 19:57:54 ca Exp $
6e92d3f3fSGregory Neil Shapiro-->
740266059SGregory Neil Shapiro<h1>smfi_main</h1>
840266059SGregory Neil Shapiro
940266059SGregory Neil Shapiro<table border="0" cellspacing=4 cellpadding=4>
1040266059SGregory Neil Shapiro<!---------- Synopsis ----------->
1140266059SGregory Neil Shapiro<tr><th valign="top" align=left width=150>SYNOPSIS</th><td>
1240266059SGregory Neil Shapiro<pre>
1340266059SGregory Neil Shapiro#include &lt;libmilter/mfapi.h&gt;
1440266059SGregory Neil Shapiroint smfi_main(
1540266059SGregory Neil Shapiro);
1640266059SGregory Neil Shapiro</pre>
1740266059SGregory Neil ShapiroHand control to libmilter event loop.
1840266059SGregory Neil Shapiro</td></tr>
1940266059SGregory Neil Shapiro
2040266059SGregory Neil Shapiro<!----------- Description ---------->
2140266059SGregory Neil Shapiro<tr><th valign="top" align=left>DESCRIPTION</th><td>
2240266059SGregory Neil Shapiro<table border="1" cellspacing=1 cellpadding=4>
2340266059SGregory Neil Shapiro<tr align="left" valign=top>
2440266059SGregory Neil Shapiro<th width="80">Called When</th>
2540266059SGregory Neil Shapiro<td>smfi_main is called after a filter's initialization is complete.</td>
2640266059SGregory Neil Shapiro</tr>
2740266059SGregory Neil Shapiro<tr align="left" valign=top>
2840266059SGregory Neil Shapiro<th width="80">Effects</th>
2940266059SGregory Neil Shapiro<td>smfi_main hands control to the Milter event loop.</td>
3040266059SGregory Neil Shapiro</tr>
3140266059SGregory Neil Shapiro</table>
3240266059SGregory Neil Shapiro
3340266059SGregory Neil Shapiro<!----------- Return values ---------->
3440266059SGregory Neil Shapiro<tr>
3540266059SGregory Neil Shapiro<th valign="top" align=left>RETURN VALUES</th>
3640266059SGregory Neil Shapiro
3740266059SGregory Neil Shapiro<td>smfi_main will return MI_FAILURE if it fails to establish a connection.  This may occur for any of a variety of reasons (e.g. invalid address passed to <a href="smfi_setconn.html">smfi_setconn</a>).  The reason for the failure will be logged.  Otherwise, smfi_main will return MI_SUCCESS.</td>
3840266059SGregory Neil Shapiro</tr>
3940266059SGregory Neil Shapiro
4040266059SGregory Neil Shapiro</table>
4140266059SGregory Neil Shapiro
4240266059SGregory Neil Shapiro<hr size="1">
4340266059SGregory Neil Shapiro<font size="-1">
445ef517c0SGregory Neil ShapiroCopyright (c) 2000, 2003 Sendmail, Inc. and its suppliers.
4540266059SGregory Neil ShapiroAll rights reserved.
4640266059SGregory Neil Shapiro<br>
4740266059SGregory Neil ShapiroBy using this file, you agree to the terms and conditions set
485ef517c0SGregory Neil Shapiroforth in the LICENSE.
4940266059SGregory Neil Shapiro</font>
5040266059SGregory Neil Shapiro</body>
5140266059SGregory Neil Shapiro</html>
52