TorControlEvent

Raw-protocol subscription keywords accepted by SETEVENTS.

enum TorControlEvent

Mentioned In

Using the Tor Control Protocol

Overview

Each case maps 1:1 to a Tor control-protocol async event keyword (control-spec.txt §4.1). Pass an array of these to subscribe(to:) to subscribe; Tor will then emit 650 async replies carrying event payloads, which swift-tor decodes into TorControlEventMessage values.

Unlike TorEvent — which is the curated, UI-friendly projection — TorControlEvent is the full, untyped subscription vocabulary. Use it when you need fine-grained or protocol-specific events that the high-level stream does not surface.

Note

Conformance is Sendable + Hashable + CaseIterable; the raw value is the exact protocol keyword, so round-tripping through the wire is lossless.

Important

Subscribing to high-volume events (DEBUG, INFO, BW) on a saturated link can back up Tor’s control socket. Prefer NOTICE+ and curate BW subscriptions to specific measurement windows.