HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

smﬁ_quarantine(3N) smﬁ_quarantine(3N)

NAME

smﬁ_quarantine() - quarantines the sendmail message using the given reason

SYNOPSIS

#include <libmilter/mfapi.h>

int smfi_quarantine(

SMFICTX *

ctx;

char * reason ;

);

PARAMETERS

smfi_quarantine()

contains the following parameters:

ctx Speciﬁes the opaque context structure.

reason Speciﬁes the quarantine reason, which is a non-NULL and non-empty null-terminated string.

DESCRIPTION

smfi_quarantine()

quarantines the message using a speciﬁc reason. smfi_quarantine() can

be called only from the

xxfi_eom() routine.

RETURN VALUE

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.

AUTHOR

smfi_quarantine()

was developed by Sendmail Inc.