From 40479c8c4719bc2adef331aa9ef578ca55713e3b Mon Sep 17 00:00:00 2001
From: Nick Anderson <nick@cmdln.org>
Date: Mon, 20 Apr 2026 13:42:04 -0500
Subject: [PATCH] Added smtpport

Ticket: CFE-4648
Changelog: None
---
 .../reference/components/cf-execd.markdown    | 21 +++++++++++++++++++
 .../control_executor.markdown                 |  6 ++++++
 2 files changed, 27 insertions(+)

diff --git a/content/reference/components/cf-execd.markdown b/content/reference/components/cf-execd.markdown
index 1c05f6746..779d5d6d7 100644
--- a/content/reference/components/cf-execd.markdown
+++ b/content/reference/components/cf-execd.markdown
@@ -340,6 +340,27 @@ schedule => { "Min00", "(Evening|Night).Min15", "Min30", "(Evening|Night).Min45"
 
 **History:** Added in CFEngine 3.0.0
 
+### smtpport
+
+**Description:** Port that `cf-execd` should try to connect to when sending email.
+
+**Type:** `int`
+
+**Allowed input range:** `0,10080`
+
+**Example:**
+
+```cf3
+body executor control
+{
+    smtpport => "26";
+}
+```
+
+**See also:** [`default:control_executor.smtpport`](/reference/special-variables/control_executor/#defaultcontrol_executorsmtpport)
+
+**History:** Added in CFEngine 3.28.0
+
 ### smtpserver
 
 **Description:** Name or IP of a willing smtp server for sending
diff --git a/content/reference/special-variables/control_executor.markdown b/content/reference/special-variables/control_executor.markdown
index 9d1f4c56f..b03550967 100644
--- a/content/reference/special-variables/control_executor.markdown
+++ b/content/reference/special-variables/control_executor.markdown
@@ -79,6 +79,12 @@ The class schedule used by cf-execd for activating cf-agent. The list should con
 
 **See also:** [`schedule` in `body executor control`][cf-execd#schedule]
 
+### default:control_executor.smtpport
+
+Port that `cf-execd` should use when sending email.
+
+**See also:** [`smtpport` in `body executor control`][cf-execd#smtpport]
+
 ### default:control_executor.smtpserver
 
 Name or IP of a willing smtp server for sending email. This should point to a standard port 25 server without encryption. If you are running secured or encrypted email then you should run a mail relay on localhost and point this to localhost.