# xxfi_close

SYNOPSIS |
    #include <libmilter/mfapi.h>
    sfsistat (*xxfi_close)(
    	SMFICTX *ctx
    );
The current connection is being closed.
DESCRIPTION |
Called When | xxfi_close is always called once at the end of each connection.
Default Behavior | Do nothing; return SMFIS_CONTINUE.
ARGUMENTS |
Argument | Description
--- | ---
ctx | Opaque context structure.
NOTES | xxfi_close may be called "out-of-order", i.e. before even the xxfi_connect is called. After a connection is established by the MTA to the filter, if the MTA decides this connection's traffic will be discarded (e.g. via an access_db result), no data will be passed to the filter from the MTA until the client closes down. At that time, xxfi_close is called. It can therefore be the only callback ever used for a given connection, and developers should anticipate this possibility when crafting their xxfi_close code. In particular, it is incorrect to assume the private context pointer will be something other than NULL in this callback. xxfi_close is called on close even if the previous mail transaction was aborted. xxfi_close is responsible for freeing any resources allocated on a per-connection basis. Since the connection is already closing, the return value is currently ignored.

Copyright (c) 2000, 2003, 2004 Proofpoint, Inc. and its suppliers. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the LICENSE.