bldr ref
Manage named CID refs on the remote node
bldr ref
Manage named CID refs on the remote node
bldr [BLDR FLAGS] ref <COMMAND>bldr ref delete
Delete a named ref (atomic).
Without a condition flag the deletion is unconditional.
bldr [BLDR FLAGS] ref delete [DELETE FLAGS] <NAME><NAME>
Name of the ref to delete
Required.
--if-exists
Delete only if the ref currently exists
Defaults to false.
--if-equals <EXPECTED-CID>
Delete only if the ref's current value equals this CID
bldr ref get
Read a named ref
bldr [BLDR FLAGS] ref get <NAME><NAME>
Name of the ref
Required.
bldr ref list
List named refs, newest first
bldr [BLDR FLAGS] ref list [LIST FLAGS]--type <KIND>
Only refs holding this kind of block, by the label bldr inspect prints — deployment, runnable, fs-node, build-output. An unknown label is an error, not an empty list
--prefix <PREFIX>
Only refs whose name starts with this
bldr ref set
Create or update a named ref (atomic).
Without a condition flag the operation is unconditional. Use --if-not-exists for a guaranteed create, --if-exists for a guaranteed update, and --if-equals for a compare-and-swap.
bldr [BLDR FLAGS] ref set [SET FLAGS] <NAME> <CID><NAME>
Name of the ref to create or update
Required.
<CID>
CID to store in the ref
Required.
--if-not-exists
Apply only if the ref does not yet exist (create semantics)
Defaults to false.
--if-exists
Apply only if the ref already exists (update semantics)
Defaults to false.
--if-equals <EXPECTED-CID>
Apply only if the ref's current value equals this CID (CAS)