ec_log_attempt

March 26, 2020

Name

ec_log_attempt — Records an attempt to deliver a message

Synopsis

#include "log.h"

| void **ec_log_attempt** ( | 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 an attempt to deliver 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 allowed.

note

Typical use is to pass NULL to this parameter, in which case the string to log is pulled from the message construct. You may override this by passing your own Delivery Status Notification (DSN) to use for logging the delivery attempt.

Return Values

This function returns void.

Threading

It is legal to call this function in any thread.

See Also

ec_log_permanent_failure