Skip to content
dk docs

Determinism

dk1 is deterministic with respect to the job count: for the same inputs,

  • dk1 -j N produces byte-identical output to dk0, and
  • dk1 -j 1 produces byte-identical output to dk1 -j N for any N.

The engine confines every ordering-sensitive decision to the engine thread; workers only perform independent leaf work whose results are applied back on the engine thread in a deterministic order. Changing -j therefore changes only wall-clock time, never the produced values or the trace store. The one visible effect of higher -j is that interleaved progress output and captured stdout/stderr from concurrent steps may arrive in a different real-time order; the build outputs themselves do not change.