xref: /freebsd/contrib/sendmail/libmilter/docs/smfi_setbacklog.html (revision 06c3fb2749bda94cb5201f81ffdb8fa6c3161b2e)
1<HTML>
2<HEAD><TITLE>smfi_setbacklog</TITLE></HEAD>
3<BODY>
4<!--
5$Id: smfi_setbacklog.html,v 1.7 2013-11-22 20:51:39 ca Exp $
6-->
7<H1>smfi_setbacklog</H1>
8
9<TABLE border="0" cellspacing=4 cellpadding=4>
10<!---------- Synopsis ----------->
11<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD>
12<PRE>
13#include &lt;libmilter/mfapi.h&gt;
14int smfi_setbacklog(
15	int obacklog
16);
17</PRE>
18Set the filter's <CODE>listen(2)</CODE> backlog value.
19</TD></TR>
20
21<!----------- Description ---------->
22<TR><TH valign="top" align=left>DESCRIPTION</TH><TD>
23<TABLE border="1" cellspacing=1 cellpadding=4>
24<TR align="left" valign=top>
25<TH width="80">Called When</TH>
26<TD>smfi_setbacklog should only be called before <A href="smfi_main.html">smfi_main</A>.</TD>
27</TR>
28<TR align="left" valign=top>
29<TH width="80">Effects</TH>
30<TD>Sets the incoming socket backlog used by <CODE>listen(2)</CODE>.
31If smfi_setbacklog is not called, the operating system default is used.</TD>
32</TR>
33</TABLE>
34</TD></TR>
35
36<!----------- Arguments ---------->
37<TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
38    <TABLE border="1" cellspacing=0>
39    <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
40    <TR valign="top"><TD>obacklog</TD>
41	<TD>The number of incoming connections to allow in the listen queue.
42	</TD></TR>
43    </TABLE>
44</TD></TR>
45
46<!----------- Return values ---------->
47<TR>
48<TH valign="top" align=left>RETURN VALUES</TH>
49
50<TD>smfi_setbacklog returns MI_FAILURE if obacklog is less than or equal
51to zero.</TD>
52</TR>
53
54</TABLE>
55
56<HR size="1">
57<FONT size="-1">
58Copyright (c) 2002-2003 Proofpoint, Inc. and its suppliers.
59All rights reserved.
60<BR>
61By using this file, you agree to the terms and conditions set
62forth in the LICENSE.
63</FONT>
64</BODY>
65</HTML>
66