CLI command

skarbiec route withdraw

Withdraw one route route declare wrote, the inverse of a declaration.

Invocation#

Shell
skarbiec route withdraw --resource <resource> --reason <text>

Purpose#

Withdraw one route route declare wrote, the inverse of a declaration.

Required inputs and options#

  • Requires exact non-empty --resource and --reason values. The reason travels into both journals, because the table decides which credential a login form receives.

Output and state effects#

  • Under the shared table's file lock, removes the row, keeps a timestamped previous-table backup, publishes the table only after it parses back, appends the removed row and the reason to the adjacent and hash-chained journals (capability-route-withdrawn), and prints withdrawn, the removed row and backup. A resource with no hand-declared row prints withdrawn false and writes nothing.

Refusals#

  • Refuses a missing or malformed --resource or --reason and a backup without a timestamp. Resources a vault item declares for itself have no row and are withdrawn by changing the item's declaration.