xref: /freebsd/contrib/sendmail/libmilter/docs/smfi_setbacklog.html (revision c6ec7d31830ab1c80edae95ad5e4b9dba10c47ac)
1<HTML>
2<HEAD><TITLE>smfi_setbacklog</TITLE></HEAD>
3<BODY>
4<!--
5$Id: smfi_setbacklog.html,v 1.6 2006/12/21 18:30:35 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
35<!----------- Arguments ---------->
36<TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
37    <TABLE border="1" cellspacing=0>
38    <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
39    <TR valign="top"><TD>obacklog</TD>
40	<TD>The number of incoming connections to allow in the listen queue.
41	</TD></TR>
42    </TABLE>
43</TD></TR>
44
45<!----------- Return values ---------->
46<TR>
47<TH valign="top" align=left>RETURN VALUES</TH>
48
49<TD>smfi_setbacklog returns MI_FAILURE if obacklog is less than or equal
50to zero.</TD>
51</TR>
52
53</TABLE>
54
55<HR size="1">
56<FONT size="-1">
57Copyright (c) 2002-2003 Sendmail, Inc. and its suppliers.
58All rights reserved.
59<BR>
60By using this file, you agree to the terms and conditions set
61forth in the LICENSE.
62</FONT>
63</BODY>
64</HTML>
65