NAME

pounce —

IRC pouncer :3

DESCRIPTION

pounce(1) is a multi-client, TLS-only IRC bouncer. It takes a simple approach, using a multiple-consumer ring buffer and the IRCv3.2 server-time extension to communicate with clients.

RATIONALE

As a former znc(1) user, I was dissatisfied with the multi-client experience it offered. I wanted to connect from both my laptop and my phone and have full chat history on both. With znc(1), my options were either having both clients spammed with redundant history every time they connect, or having one client consume the buffer and the other get no history at all.

With a multiple-consumer ring buffer, each client has its own place in the history and can be brought up to date independently. Additionally, by expecting clients to implement the server-time extension, all events can be accurately replayed, rather than being limited to messages.

INSTALLING

pounce requires LibreSSL (-ltls) and primarily targets FreeBSD, where it is sandboxed with capsicum(4).

make all
sudo make install PREFIX=/usr/local

On other systems, such as macOS and Linux, the build is configured using pkg-config(1). If LibreSSL is installed in a non-standard prefix, set PKG_CONFIG_PATH appropriately. For example:

PKG_CONFIG_PATH=/opt/libressl/lib/pkgconfig ./configure
make all
sudo make install PREFIX=/usr/local

FILES

bounce.h: declarations and common functions
bounce.c: configuration and event loop
local.c: local server binding
server.c: remote server connection
client.c: remote client connections
state.c: state shared between clients
ring.c: buffer between server and clients
config.c: getopt_long(3)-integrated configuration parsing
dispatch.c: SNI socket dispatch
compat.h: compatibility with other systems
rc.d/: FreeBSD rc(8) scripts

CONTRIBUTING

The upstream URL of this project is ⟨https://git.causal.agency/pounce⟩. Contributions in any form can be sent to <list+pounce@causal.agency>. For sending patches by email, see ⟨https://git-send-email.io⟩.