log_permanent_failure_v1

March 26, 2020

Name

log_permanent_failure_v1 — Register a function with this hook whenever a permanent failure event should be logged.

Synopsis

#include "hooks/core/log_permanent_failure_v1.h"

| void **core_log_permanent_failure_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>;

Description

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

Parameters

closure

A pointer to the closure function.

msg

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 timeval struct.

note

Contains the Delivery Status Notification (DSN) from the remote server.

note_len

The length of the note string, in bytes.

Return Values

This hook returns void.

Threading

This hook will be called in any thread.

See Also

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