ec_log_permanent_failure

March 26, 2020

Name

ec_log_permanent_failure — Records a permanent failure disposition of a message

Synopsis

#include "log.h"

| void **ec_log_permanent_failure** ( | mess, |   |
|   | dr, |   |
|   | now, |   |
|   | note); |   |

ec_message * <var class="pdparam">mess</var>;
domain_record * <var class="pdparam">dr</var>;
struct timeval * <var class="pdparam">now</var>;
const string * <var class="pdparam">note</var>;

Description

Records a permanent failure disposition of a message.

Parameters

mess

A pointer to an ec_message struct. For documentation of this data structure see “ec_message”.

dr

A pointer to a domain_record struct. For documentation of this data structure see “domain_record”.

now

A pointer to a timeval struct, which may be NULL.

**Configuration Change. ** Prior to version 3.0, NULL was not an allowed value.

note

Typical use is to pass NULL to this parameter, in which case the string is pulled from the message construct. You may override this by passing string a DSN to use for logging the permanent failure.

Return Values

This function returns void.

Threading

It is legal to call this function in any thread.

See Also

ec_log_attempt