capcom lock acquire

capcom lock acquire

Acquire this worktree’s lock, or resume it with your own token

Synopsis

Claim this worktree’s Tree lock for –purpose, which is required. A free lock gets a new Lock token, printed on a token line: keep it, since touch and release need it. Your –token from an earlier acquire resumes your lock, even a stale one, and refreshes its heartbeat. A lock another session holds fails locked, exit code 3, unless it is stale and –take-stale is given, which takes it over with a new token. –holder names the holder, user@host by default.

capcom lock acquire [flags]

Examples

  capcom lock acquire --purpose "implementing the release plan"   # prints the token to keep
  capcom lock acquire --purpose "implementing the release plan" --token <token>   # resume after a restart
  capcom lock acquire --purpose "finishing the release" --take-stale   # take over a stale lock

Options

  -h, --help             help for acquire
      --holder string    who holds the lock (default user@host)
      --kv               print KEY=VALUE lines ending in STATUS=
      --purpose string   what the lock is held for
      --take-stale       take the lock over when it is stale
      --token string     your token from an earlier acquire, to resume the lock

Options inherited from parent commands

      --json   print a versioned JSON envelope

SEE ALSO

• capcom lock - Acquire, refresh, release and inspect this worktree’s Tree lock