diff options
Diffstat (limited to 'calico.1')
-rw-r--r-- | calico.1 | 97 |
1 files changed, 40 insertions, 57 deletions
diff --git a/calico.1 b/calico.1 index 4d52a10..37e61a9 100644 --- a/calico.1 +++ b/calico.1 @@ -1,4 +1,4 @@ -.Dd November 6, 2019 +.Dd August 27, 2020 .Dt CALICO 1 .Os . @@ -16,7 +16,7 @@ .Sh DESCRIPTION The .Nm -daemon +program dispatches incoming TLS connections to instances of .Xr pounce 1 @@ -26,11 +26,25 @@ Instances of should be configured with .Fl U to bind to UNIX-domain sockets -named by the host they wish to accept connections for in the directory passed to .Nm . . .Pp +Note that +.Nm +is not a proxy. +Incoming connections are passed directly +to instances of +.Xr pounce 1 , +which handle TLS negotiation. +Instances of +.Xr pounce 1 +and +.Nm +can be restarted +independently of each other. +. +.Pp The arguments are as follows: .Bl -tag -width Ds .It Fl H Ar host @@ -52,84 +66,53 @@ The path to the directory containing UNIX-domain sockets. .El . -.Ss Service Configuration -Add the following to -.Pa /etc/rc.conf -to enable the -.Nm -daemon: -.Bd -literal -offset indent -calico_enable="YES" -.Ed -. -.Pp -The default socket directory is -.Pa /var/run/calico . -It can be changed by setting -.Va calico_path . -The -.Xr pounce 1 -service can be configured -to listen in this directory -with the following: +.Sh EXAMPLES +Start and dispatch to two instances of +.Xr pounce 1 : .Bd -literal -offset indent -pounce_flags="-U /var/run/calico" +$ pounce -U /var/run/calico -H oftc.example.org oftc.conf +$ pounce -U /var/run/calico -H libera.example.org libera.conf +$ calico -H example.org /var/run/calico .Ed -. .Pp -The -.Nm +The two instances can be connected to via +.Li oftc.example.org:6697 and -.Xr pounce 1 -services can be started and stopped -completely independently of each other. -. -.Sh EXAMPLES -.Bd -literal -offset indent -pounce -U sockets/foo.example.org foo.conf -pounce -U sockets/bar.example.org bar.conf -calico -H example.org sockets/ -.Ed +.Li libera.example.org:6697 , +respectively. . .Sh SEE ALSO .Xr pounce 1 . .Sh STANDARDS -The -.Nm -daemon implements the following: -. .Bl -item .It .Rs -.%A E. Rescorla -.%Q Mozilla -.%T The Transport Layer Security (TLS) Protocol Version 1.3 +.%A D. Eastlake 3rd +.%T Transport Layer Security (TLS) Extensions: Extension Definitions .%I IETF -.%N RFC 8446 -.%D August 2018 -.%U https://tools.ietf.org/html/rfc8446 +.%R RFC 6066 +.%U https://tools.ietf.org/html/rfc6066 +.%D January 2011 .Re -. .It .Rs -.%A D. Eastlake 3rd -.%Q Huawei -.%T Transport Layer Security (TLS) Extensions: Extension Definitions +.%A E. Rescorla +.%T The Transport Layer Security (TLS) Protocol Version 1.3 .%I IETF -.%N RFC 6066 -.%D January 2011 -.%U https://tools.ietf.org/html/rfc6066 +.%R RFC 8446 +.%U https://tools.ietf.org/html/rfc8446 +.%D August 2018 .Re .El . .Sh AUTHORS -.An June Bug Aq Mt june@causal.agency +.An June McEnroe Aq Mt june@causal.agency . .Sh BUGS Send mail to -.Aq Mt june@causal.agency +.Aq Mt list+pounce@causal.agency or join .Li #ascii.town on -.Li chat.freenode.net . +.Li irc.tilde.chat . |