CLI command
skarbiec request withdraw
Take back a pending request: the agent that filed it, or a decider, closes it and nothing is issued.
Invocation#
skarbiec request withdraw <request-id> --by <agent-or-uid>Purpose#
Take back a pending request: the agent that filed it, or a decider, closes it and nothing is issued.
Required inputs and options#
- The request id and --by: the requesting agent's name, or a deciding recipient's uid.
Output and state effects#
- Records the withdrawal, sets the state withdrawn, journals access-withdrawn and prints ok, request_id and state.
Refusals#
- A flag other than --by exits 2 (arguments-flag-unknown); no --by exits 2. A request no longer pending is request-not-pending; anyone but the requesting agent is held to the decider rules.
- skarbiec.request.register request-register-not-json — exit 1: reading the access request register {path}; fix: restore {path} from a backup taken before the damage, or move it aside and file the open requests again; it is a JSON object holding a requests list
- skarbiec.request.register request-register-damaged — exit 1: reading the access request register {path}; fix: restore {path} from a backup taken before the damage, or move it aside and file the open requests again; it is a JSON object holding a requests list
- skarbiec.request.register request-record-damaged — exit 1: reading access request {id} from the register {path}; fix: remove the record {id} from {path} and file the request again; skarbiec request list shows the others
- skarbiec.request.register request-record-field-unreadable — exit 1: reading access request {id} from the register {path}; fix: remove the record {id} from {path} and file the request again; skarbiec request list shows the others
- skarbiec.request.register request-recipient-damaged — exit 1: reading {by}'s recipient record to decide access request {id}; fix: restore {by}'s recipient record from a backup taken before the damage; skarbiec recipient list shows the record and skarbiec doctor names what else is wrong
- skarbiec.request.register request-id-unavailable — exit 69: drawing a request id from /dev/urandom; fix: file the request again; if it fails again, the operating system's random source is broken and skarbiec doctor on this host says what else is
- skarbiec.request.register request-grant-unanswered — exit 1: issuing the {form} grant access request {id} names; fix: deny the request with skarbiec request deny {id} --by <uid> and issue the grant with skarbiec grant {leaf}