BootstrapStatus

Parsed BOOTSTRAP status line per control-spec.txt §4.1.11.

struct BootstrapStatus

Overview

Tor emits bootstrap progress both as responses to GETINFO status/bootstrap-phase and as async STATUS_CLIENT events carrying a BOOTSTRAP payload. Both shapes share the same attribute vocabulary: PROGRESS, TAG, SUMMARY, and optional WARNING / REASON fields for degraded progress. BootstrapStatus is the typed projection callers actually consume — see waitUntilBootstrapped(timeout:) and TorEvent.bootstrap(progress:tag:summary:).

Note

Conformance is Sendable + Equatable.

Important

progress is monotonic within a single session — Tor never retreats to a lower percentage. Subscribers may safely replace prior UI without reordering.

Topics

Progress

let progress: Int
Bootstrap percentage, 0–100 inclusive.
var isComplete: Bool
true if progress has reached 100%.

Classification

Degraded progress

Creating

init(progress: Int, tag: String, summary: String, warning: String?, reason: String?)
Memberwise initialiser — typically invoked by parseBootstrapStatus(_:).