CALICO(1)

💅 CALICO(1): calico — dispatches cat 💅

(General Commands Manual, but make it group chat) 🫶

💖 NAME 💖

calico — dispatches cat. that's the whole name, bestie, and she said what she said 💅✨

✨ SYNOPSIS ✨

calico [-H host] [-P port] [-t timeout] directory

🌸 DESCRIPTION 🌸

okay so the calico program dispatches incoming TLS connections to instances of pounce(1) by Server Name Indication (SNI). bestie, that's the whole vibe: SNI in, right pounce(1) instance out 💖

Instances of pounce(1) should be configured with -U to bind to UNIX-domain sockets in the directory passed to calico. yes, -U, UNIX-domain sockets, the whole little socket situation 🫶

⚠️ note note note: calico is not a proxy. Incoming connections are passed directly to instances of pounce(1), which handle TLS negotiation. Instances of pounce(1) and calico can be restarted independently of each other. iconic separation, no cap 💅

okay bestie, the arguments are as follows:

• -H host — Bind to host. The default host is localhost. like, localhost is the main character unless u say otherwise 💖
• -P port — Bind to port. The default port is 6697. iconic port fr 🔥
• -t 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. no ClientHello? bye 👋
• directory — The path to the directory containing pounce(1) UNIX-domain sockets. yes bestie, directory is right there and it matters 🎀

🎀 EXAMPLES 🎀

okay so start and dispatch to two instances of pounce(1):

$ 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

The two instances can be connected to via oftc.example.org:6697 and libera.example.org:6697, respectively. literally two little hostname eras, slay 🌈

🦋 SEE ALSO 🦋

• pounce(1) — the whole reason we're here, go read it bestie 🫶

🌈 STANDARDS 🌈

• D. Eastlake 3rd, Transport Layer Security (TLS) Extensions: Extension Definitions, IETF, RFC 6066, https://tools.ietf.org/html/rfc6066, January 2011.
• E. Rescorla, The Transport Layer Security (TLS) Protocol Version 1.3, IETF, RFC 8446, https://tools.ietf.org/html/rfc8446, August 2018.

👑 AUTHORS 👑

June McEnroe <june@causal.agency> 💌

💀 BUGS 💀

Send mail to ⟨list+pounce@causal.agency⟩ or join #ascii.town on irc.tilde.chat. that's the whole bug situation, bestie 💀🫶

💖 Debian • August 27, 2020 • CALICO(1) • byeee bestie, mwah! 💖