log_attempt_v1

log_attempt_v1 — Register a function with this hook whenever a message attempt event should be logged

#include "hooks/core/log_attempt_v1.h"

| void **core_log_attempt_v1** ( | closure, |   | |   | msg, |   | |   | dr, |   | |   | now, |   | |   | note, |   | |   | note_len); |   |

void * <var class="pdparam">closure</var>; ec_message * <var class="pdparam">msg</var>; domain_record * <var class="pdparam">dr</var>; struct timeval * <var class="pdparam">now</var>; const char * <var class="pdparam">note</var>; int <var class="pdparam">note_len</var>;

Register a function with this hook whenever a message attempt event should be logged. This hook has a signature that closely mirrors the signature defined for the log_attempt callback in a logging_infrastructure_1 struct. For documentation of this data structure see “logging_infrastructure_1”.

Due to the vast number of attempts to deliver mail this hook should only be implemented for debugging purposes. All messages that are attempted will result in a transient failure, permanent failure or successful delivery - there is no need to log an attempt in a production system.

Parameters

Return Values

This hook returns void.

Threading

This hook will be called in any thread.

log_delivery_v1, log_permanent_failure_v1, log_reception_v1, log_rejection, log_reopen, and log_transient_failure_v1.