Fossil SCM

Usage hints on email-send-relayhost to suggest using an IP address to avoid name lookup problems from within chroot jails.

drh 2025-04-07 16:57 trunk
Commit 8266b5b3cf8b25db19ae01ef4130f142d5e19f0526f3af31b221cbae8153520e
1 file changed +5 -1
+5 -1
--- src/alerts.c
+++ src/alerts.c
@@ -404,11 +404,15 @@
404404
@ <p>When the send method is "SMTP relay", each email message is
405405
@ transmitted via the SMTP protocol (rfc5321) to a "Mail Submission
406406
@ Agent" or "MSA" (rfc4409) at the hostname shown here. Optionally
407407
@ append a colon and TCP port number (ex: smtp.example.com:587).
408408
@ The default TCP port number is 25.
409
+ @ Usage Hint: If Fossil is running inside of a chroot jail, then it might
410
+ @ not be able to resolve hostnames. Work around this by using a raw IP
411
+ @ address or create a "/etc/hosts" file inside the chroot jail.
409412
@ (Property: "email-send-relayhost")</p>
413
+ @
410414
entry_attribute("Store Emails In This Database", 60, "email-send-db",
411415
"esdb", "", 0);
412416
@ <p>When the send method is "store in a database", each email message is
413417
@ stored in an SQLite database file with the name given here.
414418
@ (Property: "email-send-db")</p>
@@ -1138,11 +1142,11 @@
11381142
** SETTING: email-listid width=40
11391143
** If this setting is not an empty string, then it becomes the argument to
11401144
** a "List-ID:" header that is added to all out-bound notification emails.
11411145
*/
11421146
/*
1143
-** SETTING: email-send-relayhost width=40 sensitive default=localhost
1147
+** SETTING: email-send-relayhost width=40 sensitive default=127.0.0.1
11441148
** This is the hostname and TCP port to which output email messages
11451149
** are sent when email-send-method is "relay". There should be an
11461150
** SMTP server configured as a Mail Submission Agent listening on the
11471151
** designated host and port and all times.
11481152
*/
11491153
--- src/alerts.c
+++ src/alerts.c
@@ -404,11 +404,15 @@
404 @ <p>When the send method is "SMTP relay", each email message is
405 @ transmitted via the SMTP protocol (rfc5321) to a "Mail Submission
406 @ Agent" or "MSA" (rfc4409) at the hostname shown here. Optionally
407 @ append a colon and TCP port number (ex: smtp.example.com:587).
408 @ The default TCP port number is 25.
 
 
 
409 @ (Property: "email-send-relayhost")</p>
 
410 entry_attribute("Store Emails In This Database", 60, "email-send-db",
411 "esdb", "", 0);
412 @ <p>When the send method is "store in a database", each email message is
413 @ stored in an SQLite database file with the name given here.
414 @ (Property: "email-send-db")</p>
@@ -1138,11 +1142,11 @@
1138 ** SETTING: email-listid width=40
1139 ** If this setting is not an empty string, then it becomes the argument to
1140 ** a "List-ID:" header that is added to all out-bound notification emails.
1141 */
1142 /*
1143 ** SETTING: email-send-relayhost width=40 sensitive default=localhost
1144 ** This is the hostname and TCP port to which output email messages
1145 ** are sent when email-send-method is "relay". There should be an
1146 ** SMTP server configured as a Mail Submission Agent listening on the
1147 ** designated host and port and all times.
1148 */
1149
--- src/alerts.c
+++ src/alerts.c
@@ -404,11 +404,15 @@
404 @ <p>When the send method is "SMTP relay", each email message is
405 @ transmitted via the SMTP protocol (rfc5321) to a "Mail Submission
406 @ Agent" or "MSA" (rfc4409) at the hostname shown here. Optionally
407 @ append a colon and TCP port number (ex: smtp.example.com:587).
408 @ The default TCP port number is 25.
409 @ Usage Hint: If Fossil is running inside of a chroot jail, then it might
410 @ not be able to resolve hostnames. Work around this by using a raw IP
411 @ address or create a "/etc/hosts" file inside the chroot jail.
412 @ (Property: "email-send-relayhost")</p>
413 @
414 entry_attribute("Store Emails In This Database", 60, "email-send-db",
415 "esdb", "", 0);
416 @ <p>When the send method is "store in a database", each email message is
417 @ stored in an SQLite database file with the name given here.
418 @ (Property: "email-send-db")</p>
@@ -1138,11 +1142,11 @@
1142 ** SETTING: email-listid width=40
1143 ** If this setting is not an empty string, then it becomes the argument to
1144 ** a "List-ID:" header that is added to all out-bound notification emails.
1145 */
1146 /*
1147 ** SETTING: email-send-relayhost width=40 sensitive default=127.0.0.1
1148 ** This is the hostname and TCP port to which output email messages
1149 ** are sent when email-send-method is "relay". There should be an
1150 ** SMTP server configured as a Mail Submission Agent listening on the
1151 ** designated host and port and all times.
1152 */
1153

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button