smfi_quarantine(3N)

NAME

smfi_quarantine() — quarantines the sendmail message using the given reason

#include <libmilter/mfapi.h>  

int smfi_quarantine(  
    SMFICTX *ctx;
    char * reason ; 
 ); 

smfi_quarantine() contains the following parameters:

ctx: Specifies the opaque context structure.
reason: Specifies the quarantine reason, which is a non-NULL and non-empty null-terminated string.

smfi_quarantine() quarantines the message using a specific reason. smfi_quarantine() can be called only from the xxfi_eom() routine.

smfi_quarantine() fails and returns MI_FAILURE due to the following reasons:

The reason argument is NULL or empty.
Network error occurs.
The SMFIF_QUARANTINE value is not set when the smfi_register() routine is called.

smfi_quarantine() returns MI_SUCCESS on success.

smfi_quarantine() was developed by Sendmail Inc.