calico.1 (2033B)
- .Dd August 27, 2020
- .Dt CALICO 1
- .Os
- .
- .Sh NAME
- .Nm calico
- .Nd dispatches cat
- .
- .Sh SYNOPSIS
- .Nm
- .Op Fl H Ar host
- .Op Fl P Ar port
- .Op Fl t Ar timeout
- .Ar directory
- .
- .Sh DESCRIPTION
- The
- .Nm
- program
- dispatches incoming TLS connections
- to instances of
- .Xr pounce 1
- by Server Name Indication (SNI).
- Instances of
- .Xr pounce 1
- should be configured with
- .Fl U
- to bind to UNIX-domain sockets
- 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
- Bind to
- .Ar host .
- The default host is localhost.
- .It Fl P Ar port
- Bind to
- .Ar port .
- The default port is 6697.
- .It Fl t Ar timeout
- Set the timeout in milliseconds
- after which a connection will be closed
- if it has not sent the ClientHello message.
- The default timeout is 1000 milliseconds.
- .It Ar directory
- The path to the directory containing
- .Xr pounce 1
- UNIX-domain sockets.
- .El
- .
- .Sh EXAMPLES
- Start and dispatch to two instances of
- .Xr pounce 1 :
- .Bd -literal -offset indent
- $ 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 two instances can be connected to via
- .Li oftc.example.org:6697
- and
- .Li libera.example.org:6697 ,
- respectively.
- .
- .Sh SEE ALSO
- .Xr pounce 1
- .
- .Sh STANDARDS
- .Bl -item
- .It
- .Rs
- .%A D. Eastlake 3rd
- .%T Transport Layer Security (TLS) Extensions: Extension Definitions
- .%I IETF
- .%R RFC 6066
- .%U https://tools.ietf.org/html/rfc6066
- .%D January 2011
- .Re
- .It
- .Rs
- .%A E. Rescorla
- .%T The Transport Layer Security (TLS) Protocol Version 1.3
- .%I IETF
- .%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
- .
- .Sh BUGS
- Send mail to
- .Aq Mt list+pounce@causal.agency
- or join
- .Li #ascii.town
- on
- .Li irc.tilde.chat .