Kqueue

Configuration

[runtime]
type = "kqueue"
max_events = 1024

max_events defaults to 1024 and must exceed zero. It determines the maximum event batch collected from kqueue.

How it differs

Kqueue and epoll share Thwip’s readiness-worker lifecycle, HTTP parsing, routing, buffering, and timeout logic. Their platform drivers differ in registration and event translation: kqueue uses filters and flags, while epoll uses Linux event masks. Both normalize those events before connection handling.

Use kqueue when

• running Thwip on macOS during local development;
• deploying to a supported BSD system;
• testing the readiness implementation without Linux.

CPU affinity is attempted where supported but is non-fatal on macOS/BSD, where unavailable affinity is logged instead of preventing the worker from starting.