toolroom.lock¶
Resolve every site's requirements and write toolroom.lock.
An entry the lock already holds stands while it still satisfies
every floor and resolves on every locked host; a tool no site
requires any more leaves the lock. Nothing on a machine changes:
the lock says what a checkout installs, and sync installs it.
--upgrade moves every entry to the newest version that
satisfies, and --upgrade-tool moves the ones it names. An
upgrade is an act on the repository: every package runs the version
the lock names, so one entry moving moves every package with it.
--check answers whether the lock is current and writes nothing,
exiting non-zero when it would move. A delegated tool's resolved
graph is written when its version enters the lock and kept after;
--relock writes one again though the version stands, which is
what an install asks for when it refuses because the runtime has no
build for what the graph pins.
| Parameter | Type | Default | Description |
|---|---|---|---|
--upgrade |
flag | false |
move every entry to the newest version that satisfies |
--upgrade-tool=VALUE |
repeatable | move just these entries to their newest | |
--check |
flag | false |
report whether the lock is current; write nothing |
--relock=VALUE |
repeatable | delegated tools whose graph is resolved again |