2 <HEAD><TITLE>xxfi_close</TITLE></HEAD>
5 $Id: xxfi_close.html,v 1.13 2006/12/21 18:30:35 ca Exp $
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>
14 sfsistat (*xxfi_close)(
18 The current connection is being closed.
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>xxfi_close is always called once at the end of each connection.</TD>
28 <TR align="left" valign=top>
29 <TH>Default Behavior</TH>
30 <TD>Do nothing; return SMFIS_CONTINUE.</TD>
34 <!----------- Arguments ---------->
35 <TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
36 <TABLE border="1" cellspacing=0>
37 <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
38 <TR valign="top"><TD>ctx</TD>
39 <TD>Opaque context structure.
44 <!----------- Notes ---------->
46 <TH valign="top" align=left>NOTES</TH>
49 <LI>xxfi_close may be called "out-of-order", i.e. before even the
50 xxfi_connect is called.
51 After a connection is established by the MTA to the filter,
52 if the MTA decides this connection's traffic will be discarded
53 (e.g. via an access_db result), no data will be passed to the
54 filter from the MTA until the client closes down.
55 At that time, xxfi_close is called.
56 It can therefore be the only callback ever used for a given connection,
57 and developers should anticipate this possibility when crafting their
59 In particular, it is incorrect to assume the private context pointer
60 will be something other than NULL in this callback.
61 <LI>xxfi_close is called on close even if the previous mail
62 transaction was aborted.
63 <LI>xxfi_close is responsible for freeing any resources allocated on a
65 <LI>Since the connection is already closing, the return value is
74 Copyright (c) 2000, 2003, 2004 Sendmail, Inc. and its suppliers.
77 By using this file, you agree to the terms and conditions set