From 5aaa3cec988329f11d27911aa3994f4776139c0b Mon Sep 17 00:00:00 2001 From: Matthias Andree Date: Wed, 27 Jul 2016 22:31:28 +0200 Subject: Document use of address literals for SMTP. --- fetchmail.man | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) (limited to 'fetchmail.man') diff --git a/fetchmail.man b/fetchmail.man index c74fb5e5..0f7fc944 100644 --- a/fetchmail.man +++ b/fetchmail.man @@ -650,6 +650,10 @@ Example: .sp This option can be used with ODMR, and will make fetchmail a relay between the ODMR server and SMTP or LMTP receiver. +.IP +WARNING: if you use address numeric IP addresses here, be sure to use +\-\-smtpaddress or \-\-smtpname (either of which see) with a valid SMTP +address literal! .TP .B \-\-fetchdomains (Keyword: fetchdomains) @@ -661,16 +665,22 @@ default is the FQDN of the machine running \fBfetchmail\fP. .B \-D | \-\-smtpaddress (Keyword: smtpaddress) .br -Specify the domain to be appended to addresses -in RCPT TO lines shipped to SMTP. When this is not specified, the name -of the SMTP server (as specified by \-\-smtphost) is used for SMTP/LMTP -and 'localhost' is used for UNIX socket/BSMTP. +Specify the domain to be appended to addresses in RCPT TO lines shipped +to SMTP. When this is not specified, the name of the SMTP server (as +specified by \-\-smtphost) is used for SMTP/LMTP and 'localhost' is used +for UNIX socket/BSMTP. +.IP +NOTE: if you intend to use numeric addresses, or so-called address +literals per the SMTP standard, write them in proper SMTP syntax, for +instance \-\-smtpaddress "[192.0.2.6]" or \-\-smtpaddress +"[IPv6:2001:DB8::6]". .TP .B \-\-smtpname (Keyword: smtpname) .br Specify the domain and user to be put in RCPT TO lines shipped to SMTP. -The default user is the current local user. +The default user is the current local user. Please also see the NOTE +about \-\-smtpaddress and address literals above. .TP .B \-Z | \-\-antispam (Keyword: antispam) -- cgit v1.2.3