xxfi_abort callback Function
Purpose
The xxfi_abort callback function handles the current messages that are being aborted.
Syntax
#include <libmilter/mfapi.h>
sfsistat (*xxfi_abort)(
SMFICTX *ctx
);Description
The xxfi_abort callback
function is called at any time during message processing (that is
between some message-oriented routine and the xxfi_eom callback
function) and returns the SMFIS_CONTINUE flag.
Note:
- The xxfi_abort callback function must reclaim any resources allocated on a per-message basis, and must be tolerant of being called between any two message-oriented callbacks.
- Calls to the xxfi_abort and xxfi_eom callback function are mutually exclusive.
- The xxfi_abort callback function is not responsible for reclaiming connection-specific data, because the xxfi_close callback function is always called when a connection is closed.
- Because the current message is already being aborted, the return value is currently ignored.
- The xxfi_abort callback function is only called if the message is aborted outside the filter's control and the filter has not completed the message-oriented processing. For example, if a filter has already returned the SMFIS_ACCEPT, SMFIS_REJECT, or SMFIS_DISCARD flag from a message-oriented routine. The xxfi_abort callback function will not be called even if the message is later aborted outside the control.
Arguments
| Item | Description |
|---|---|
| ctx | The opaque context structure is maintained in the libmilter. |