doc: describe what tls servername is for

Docs should describe the purpose of the option.

PR-URL: https://github.com/nodejs/node/pull/24236
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>

1 files changed, 4 insertions, 1 deletions

diff --git a/doc/api/tls.md b/doc/api/tls.md
index ec36b4e571..b562c11b36 100644
--- a/doc/api/tls.md
+++ b/doc/api/tls.md
@@ -906,7 +906,10 @@ changes:
     protocol name. Passing an array is usually much simpler, e.g.
     `['hello', 'world']`.
   * `servername`: {string} Server name for the SNI (Server Name Indication) TLS
-    extension. It must be a host name, and not an IP address.
+    extension. It is the name of the host being connected to, and must be a host
+    name, and not an IP address. It can be used by a multi-homed server to
+    choose the correct certificate to present to the client, see the
+    `SNICallback` option to [`tls.createServer()`][].
   * `checkServerIdentity(servername, cert)` {Function} A callback function
     to be used (instead of the builtin `tls.checkServerIdentity()` function)
     when checking the server's hostname (or the provided `servername` when