Skip to content

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.

fm toolroom.lock [--upgrade] [--upgrade-tool=VALUE ...] [--check] [--relock=VALUE ...]
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

Example

$ fm toolroom.lock --upgrade