diff --git a/content/momentum/3/3-api/structs-ec-message.md b/content/momentum/3/3-api/structs-ec-message.md index 67f1d8166..76891ba2e 100644 --- a/content/momentum/3/3-api/structs-ec-message.md +++ b/content/momentum/3/3-api/structs-ec-message.md @@ -124,10 +124,6 @@ struct _ec_message { used in ec_message_get_routing_domain. This field will not be written to spool */ string _routing_domain; - - /** @since 5.2 */ - /* Make sure an attempted IP can be logged in case of temp/perm failures */ - address attempted_ip; }; ``` diff --git a/content/momentum/4/4-lua-summary-table.md b/content/momentum/4/4-lua-summary-table.md index ff3fb1d70..366e07deb 100644 --- a/content/momentum/4/4-lua-summary-table.md +++ b/content/momentum/4/4-lua-summary-table.md @@ -28,7 +28,6 @@ This section contains tables of Lua functions. Click the function name for detai | [msg.batch_id](/momentum/4/lua/ref-msg-batch-id) – Returns the human-readable ec_message.batch_id |   | msys.extended.message | 4.0 | data, data_spool, data_spool_each_rcpt, set_binding | | [msg.conn_id](/momentum/4/lua/ref-msg-conn-id) – Returns the human-readable ec_message.conn_id |   | msys.extended.message | 4.0 | data, data_spool, data_spool_each_rcpt, set_binding | | [msg.id](/momentum/4/lua/ref-msg-id) – Returns the human-readable ec_message.id |   | msys.extended.message | 4.0 | data, data_spool, data_spool_each_rcpt, set_binding | -| [msg:attempted_ip](/momentum/4/lua/ref-attempted-ip) – Gets the IP address (if any) that was attempted for a failed outbound connection | | msys.extended.message | 5.2 | core_log_delivery_v1, core_log_transient_failure_v1, core_log_permanent_failure_v1 | | [msg:binding](/momentum/4/lua/ref-msg-binding) – Sets the binding to the named binding, if one is provided | [value] | msys.extended.message | 4.0 | set_binding | | [msg:binding_group](/momentum/4/lua/ref-msg-binding-group) – Sets the binding_group to the named binding, if one is provided | [value] | msys.extended.message | 4.0 | set_binding | | [msg:body](/momentum/4/lua/ref-msg-body) – Set or get the message body (minus headers) | [...] | msys.extended.message | 4.0 | data, data_spool, data_spool_each_rcpt, set_binding | diff --git a/content/momentum/4/lua/index.md b/content/momentum/4/lua/index.md index 5a6ea3ccc..342fd1a7f 100644 --- a/content/momentum/4/lua/index.md +++ b/content/momentum/4/lua/index.md @@ -87,7 +87,6 @@ description: "This section details all Lua functions Functions are ordered alpha | [msg.conn_id](/momentum/4/lua/ref-msg-conn-id) | Return the human-readable ec_message.conn_id | | [msg.id](/momentum/4/lua/ref-msg-id) | Return the human-readable ec_message.id | | [msg:address_header](/momentum/4/lua/ref-msg-address-header) | Returns address components as an array | -| [msg:attempted_ip](/momentum/4/lua/ref-msg-attempted-ip) | Gets the attempted IP address for a failed outbound connection | | [msg:binding](/momentum/4/lua/ref-msg-binding) | Set or get the message binding | | [msg:binding_group](/momentum/4/lua/ref-msg-binding-group) | Sets the binding_group to the named binding, if one is provided. | | [msg:body](/momentum/4/lua/ref-msg-body) | Set the message body (minus headers) if provided | diff --git a/content/momentum/4/lua/ref-msg-attempted-ip.md b/content/momentum/4/lua/ref-msg-attempted-ip.md deleted file mode 100644 index 0a932d0a7..000000000 --- a/content/momentum/4/lua/ref-msg-attempted-ip.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -lastUpdated: "01/31/2026" -title: "msg:attempted_ip" -description: "msg attempted_ip Gets the IP address (if any) that was attempted for a failed outbound connection" ---- - - -## Name - -msg:attempted_ip — Gets the IP address (if any) that was attempted for a failed outbound connection. - -> This function was introduced in Momentum 5.2. - - -## Synopsis - -`msg:attempted_ip()` - - -## Description - -For successful mail deliveries, connection details are available through the connection handle (`conn_handle`) in the message object (`ec_message`). However, when a connection fails, the handle is null. The `attempted_ip` field in the message object can be checked for the IP address that Momentum attempted to connect to. This is useful for logging connection attempts and troubleshooting delivery issues. The `attempted_ip()` function returns `nil` if the IP address is unknown. - - - -``` -require("msys.core") -require("msys.extended.message") - -local mod = {} - -function mod:core_log_transient_failure_v1(msg, dr, now, note, note_len) - print(tostring(msg.id) .. ": failed to connect to mail server using the IP address " .. tostring(msg:attempted_ip())) -end - -msys.registerModule("example", mod) -``` diff --git a/content/momentum/changelog/5/5-2-0.md b/content/momentum/changelog/5/5-2-0.md index a7878923a..c5d1c3f9d 100644 --- a/content/momentum/changelog/5/5-2-0.md +++ b/content/momentum/changelog/5/5-2-0.md @@ -16,7 +16,6 @@ This section will list all of the major changes that happened with the release o | Feature | | Allows global metrics (summary) reset using [HTTP API](/momentum/4/http-api-stats/summary) | | Feature | | New DNS configuration options to [set UDP buffer sizes](/momentum/4/config/ref-dns-udp-buffer-size) | | Feature | | New DNS configuration option to [limit reuse](/momentum/4/config/ref-dns-max-udp-queries-per-port) of dynamic source ports by queries | -| Feature | | New [attempted_ip](/momentum/4/lua/ref-msg-attempted-ip) field in the [ec_message](/momentum/3/3-api/structs-ec-message) object, for better visibility into IP addresses used in failed delivery attempts | | Feature | | New `injection_time_ms` field in the message events, for improved precision in diagnostics | | Feature | | Updated major version of NodeJS LTS (now 22.22.0) | | Feature | | Removed `msys-pg` (PostgreSQL server) and `msys-clamav` (ClamAV antivirus) RPMs from the Momentum bundle, to be replaced with their 3rd-party packages |