roster rotate
verbmutateReplace a key: make a new key for the same replica, end the old one at an instant and start the new one after it.
Program anyfs-writer. Origin anyfs.
Governance: the action
What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.
| Property | Value |
|---|---|
kind | action |
effect | mutate |
idempotent | false |
audience | both |
tier | writer |
dryRun | true |
check | false |
reachChannels | local |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Operands
| Operand | Meaning |
|---|---|
ROSTER | The roster file. |
KEYID | The id of the key to replace. |
Options
| Option | Meaning | Properties |
|---|---|---|
--key | The file to write the new key to, readable by its owner only; never written over a file that is there. | type=value, required=false, standard=false, humanOnly=false, valueName=FILE |
--at | The instant the old key stops and the new one starts; now where it is left out. | type=value, required=false, standard=false, humanOnly=false, valueName=MS |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--dry-run | Show what would change and change nothing. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
anyfs roster rotate --key a2.key roster.json 0123456789abcdef # Make a new key for the same replica; the old one stops speaking now and the new one starts a millisecond after, so what the old one signed still holds.Physical: what it is drawn as
anyfs roster rotate
cli-command. Replace a key: make a new key for the same replica, end the old one at an instant and start the new one after it.
| Property | Value |
|---|---|
usage | anyfs roster rotate |
words | roster, rotate |
tier | writer |
Not drawn
- mcp: its reach policy does not name the mcp channel
- rest: its reach policy does not name the rest channel