use_outbound_tls
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); | |
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.