use_outbound_tls

March 26, 2020

Name

use_outbound_tls

Synopsis

#include "hooks/core/use_outbound_tls.h"

| int **use_outbound_tls** ( | closure, |   |
|   | message); |   |

void * <var class="pdparam">closure</var>;
email_message * <var class="pdparam">message</var>;

| int **has_core_use_outbound_tls_hook** ( | ); |   |

| void **register_core_use_outbound_tls_hook_first** ( | hook, |   |
|   | closure); |   |

ec_hook_core_use_outbound_tls_func_t <var class="pdparam">hook</var>;
void *<var class="pdparam">closure</var>;

| void **register_core_use_outbound_tls_hook_last** ( | hook, |   |
|   | closure); |   |

ec_hook_core_use_outbound_tls_func_t <var class="pdparam">hook</var>;
void *<var class="pdparam">closure</var>;

| int **call_core_use_outbound_tls_hook** ( | message); |   |

email_message * <var class="pdparam">message</var>;

Description

use_outbound_tls is called from within the SMTP delivery state machine to ascertain if TLS should be used for this message:

EC_USE_TLS_NO

TLS must not be used for this message.

EC_USE_TLS_IFAVAILABLE

If TLS is available (offered by the remote server) then the state machine should upgrade the current SMTP session to use TLS.

EC_USE_TLS_REQUIRED

The message in question requires TLS to be used. If it is unavailable, the message should not be sent.