Changeset 317 in code for trunk/doc/soju.1.scd

Timestamp:

Jun 4, 2020, 6:16:23 PM (5 years ago)

Author:

contact

Message:

Allow multiple listeners, default to ircs

Users can now specify multiple "listen" directives in their
configuration file. If -listen is specified on the CLI, it's added to
the list of listeners.

Listeners are now parsed as URLs. If the scheme is missing "ircs" is
assumed. URLs allow to enable/disable TLS on a per-listener basis and
will be used for Unix sockets too.

The default listening address is changed from irc+insecure://:6667 to
ircs://:6697. This avoids setting up an insecure listener opened to
everybody.

File:

• trunk/doc/soju.1.scd (modified) (3 diffs)

trunk/doc/soju.1.scd

@@ -57 +57 @@
         passwords).
 
-*-listen* <address>
-        Listening address (default: ":6667").
+*-listen* <uri>
+        Listening URI (default: ":6697").
 
 # CONFIG FILE
@@ -64 +64 @@
 The config file has one directive per line.
 
-*listen* <address>
-        Listening address (default: ":6667").
+*listen* <uri>
+        Listening URI (default: ":6697").
+
+        The following URIs are supported:
+
+        - _[ircs://][host][:port]_ listens with TLS over TCP (default port if
+          omitted: 6697)
+        - _irc+insecure://[host][:port]_ listens with plain-text over TCP (default
+          port if omitted: 6667)
+
+        If the scheme is omitted, "ircs" is assumed. If multiple *listen*
+        directives are specified, soju will listen on each of them.
 
 *hostname* <name>
@@ -98 +108 @@
 
         _addr_ supports several connection types:
+
         - _[ircs://]host[:port]_ connects with TLS over TCP
         - _irc+insecure://host[:port]_ connects with plain-text TCP