2 <HEAD><TITLE>smfi_setsymlist</TITLE></HEAD>
5 $Id: smfi_setsymlist.html,v 1.7 2013-11-22 20:51:39 ca Exp $
7 <H1>smfi_setsymlist</H1>
9 <TABLE border="0" cellspacing=4 cellpadding=4>
10 <!---------- Synopsis ----------->
11 <TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD>
13 #include <libmilter/mfapi.h>
20 Set the list of macros that the milter wants to receive from the MTA
24 <!----------- Description ---------->
25 <TR><TH valign="top" align=left>DESCRIPTION</TH><TD>
26 <TABLE border="1" cellspacing=1 cellpadding=4>
27 <TR align="left" valign=top>
28 <TH width="80">Called When</TH>
29 <TD>This function must only be called during
30 <A HREF="xxfi_negotiate.html">xxfi_negotiate()</A>.
33 <TR align="left" valign=top>
34 <TH width="80">Effects</TH>
35 <TD>This function can be used to override the list of macros that the
36 milter wants to receive from the MTA.
41 <!----------- Arguments ---------->
42 <TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
43 <TABLE border="1" cellspacing=0>
44 <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
47 <TD>the opaque context structure.
51 <TD>the protocol stage during which the macro list should be used.
53 <CODE>include/libmilter/mfapi.h</CODE> for legal values,
54 look for the C macros with the prefix
56 Available protocol stages are at least
57 the initial connection, HELO/EHLO, MAIL, RCPT, DATA,
63 <TD>list of macros (separated by space).
64 Example: "{rcpt_mailer} {rcpt_host}"
70 <!----------- Return values ---------->
72 <TH valign="top" align=left>RETURN VALUES</TH>
74 <TD>MI_FAILURE is returned if
76 <LI>there is not enough free memory to make a copy of the macro list,
77 <LI><CODE>macros</CODE> is <CODE>NULL</CODE> or empty,
78 <LI><CODE>stage</CODE> is not a valid protocol stage,
79 <LI>the macro list for
80 <CODE>stage</CODE> has been set before.
82 Otherwise MI_SUCCESS is returned.
86 <!----------- Notes ---------->
87 <TR align="left" valign=top>
89 <TD>There is an internal limit on the number of macros
91 <!-- XREF: MAXFILTERMACROS -->
93 however, this limit is not enforced by libmilter, only by the MTA,
94 but a possible violation of this restriction is not communicated back to
102 Copyright (c) 2006, 2012 Proofpoint, Inc. and its suppliers.
105 By using this file, you agree to the terms and conditions set
106 forth in the LICENSE.