{"thread":{"id":"56283","subject":"[PATCH] send-email: Describe 'ssl' and 'tls' in --smtp-encryption","startedAt":"2021-08-14T09:21:20Z","lastAt":"2021-08-14T09:21:20Z","messageCount":1,"participants":["Bagas Sanjaya"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"432732","messageId":"20210814092035.42272-1-bagasdotme@gmail.com","threadId":"56283","inReplyTo":null,"subject":"[PATCH] send-email: Describe 'ssl' and 'tls' in --smtp-encryption","fromName":"Bagas Sanjaya","fromEmail":"bagasdotme@gmail.com","sentAt":"2021-08-14T09:20:36Z","receivedAt":"2021-08-14T09:21:20Z","isPatch":true,"sender":{"key":"bagasdotme@gmail.com","avatar":"https://avatars.githubusercontent.com/u/40219486?v=4"},"body":"The --smtp-encryption option accepts either 'ssl' or 'tls' value to\nenable TLS connection. The latter can cause confusion (for example [1]),\nbecause it means using STARTTLS, whereas users wanting SMTPS should set\nto the former instead.\n\nDescribe these values, together with difference between SMTPS and\nSTARTTLS.\n\n[1]:\nhttps://lore.kernel.org/git/f7ee6a03-74f2-152e-5158-4103c744595a@benaaron.dev/T/#t\n\nSigned-off-by: Bagas Sanjaya <bagasdotme@gmail.com>\n---\n Documentation/git-send-email.txt | 8 ++++++--\n 1 file changed, 6 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt\nindex 3db4eab4ba..1207a6a8eb 100644\n--- a/Documentation/git-send-email.txt\n+++ b/Documentation/git-send-email.txt\n@@ -176,8 +176,12 @@ Sending\n \tfor `sendmail` in `/usr/sbin`, `/usr/lib` and $PATH.\n \n --smtp-encryption=<encryption>::\n-\tSpecify the encryption to use, either 'ssl' or 'tls'.  Any other\n-\tvalue reverts to plain SMTP.  Default is the value of\n+\tSpecify the encryption to use, either 'ssl' (SMTPS or implicit\n+\tTLS) or 'tls' (STARTTLS or Opportunistic TLS). Any other value\n+\treverts to plain SMTP. The difference between SMTPS and STARTTLS\n+\tis SMTPS uses encrypted connection from beginning of connection,\n+\twhereas in STARTTLS the existing connection is upgraded to use TLS\n+\tif SMTP server supports it. Default is the value of\n \t`sendemail.smtpEncryption`.\n \n --smtp-domain=<FQDN>::\n\nbase-commit: 5d213e46bb7b880238ff5ea3914e940a50ae9369\n-- \n2.25.1\n\n"}]}