git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] docs: git-send-email: difference between ssl and tls smtp-encryption

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
Oct 10, 2022, 19:44 UTC
Message-ID
<Y0R2AwKuXAVMP5Ma@tapette.crustytoothpaste.net>
In-Reply-To
<20221010172859.13832-1-sndanailov@wired4ever.net>
On 2022-10-10 at 17:28:59, sndanailov@wired4ever.net wrote:
Show 26 quoted lines
> From: Sotir Danailov <sndanailov@wired4ever.net>
> 
> New explanation for the difference between these values.
> It's hard to understand what they do based only on the names.
> 
> Signed-off-by: Sotir Danailov <sndanailov@wired4ever.net>
> ---
>  Documentation/git-send-email.txt | 7 +++++--
>  1 file changed, 5 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
> index 3290043053..4db32f05f0 100644
> --- a/Documentation/git-send-email.txt
> +++ b/Documentation/git-send-email.txt
> @@ -178,8 +178,11 @@ Sending
>  	for `sendmail` in `/usr/sbin`, `/usr/lib` and $PATH.
>  
>  --smtp-encryption=<encryption>::
> -	Specify the encryption to use, either 'ssl' or 'tls'.  Any other
> -	value reverts to plain SMTP.  Default is the value of
> +	Specify the encryption to use, either 'ssl' or 'tls'. Any other
> +	value reverts to plain SMTP. The difference between the two for Git is
> +	that 'ssl' uses implicit encryption and defaults to port 465, 'tls'
> +	uses explicit encryption and defaults to port 25. Other ports might be
> +	used by the SMTP server. Default is the value of
>  	`sendemail.smtpEncryption`.

This is a definite improvement, but maybe we'd want to say that 'tls' is really STARTTLS, while 'ssl' is always-on encryption over a dedicated port. It might also be worth mentioning that the choice of name doesn't affect the actual protocol and version used and the user is almost certainly using TLS either way.

-- 
brian m. carlson (he/him or they/them)
Toronto, Ontario, CA
Previous: Junio C HamanoNext: Junio C Hamano
Message 3 of 7 in “docs: git-send-email: difference between ssl and tls smtp-encryption”
  1. docs: git-send-email: difference between ssl and tls smtp-encryptionsndanailov@wired4ever.net, Oct 10, 2022
  2. Junio C HamanoOct 10, 2022
  3. brian m. carlsonOct 10, 2022
  4. Junio C HamanoOct 10, 2022
  5. Aaron SchrabOct 11, 2022
  6. Philip OakleyOct 11, 2022
  7. Sotir DanailovOct 11, 2022

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.