IF Commons GitHub

roster rotate

verbmutate

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.

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.

PropertyValue
kindaction
effectmutate
idempotentfalse
audienceboth
tierwriter
dryRuntrue
checkfalse
reachChannelslocal
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
ROSTERThe roster file.
KEYIDThe id of the key to replace.

Options

OptionMeaningProperties
--keyThe 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
--atThe 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
--jsonWrite one JSON document and nothing else for a person.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--quietShow only how it ended.type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false
--verboseShow every step as it happens.type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false
--colorUse colour where the terminal shows it (--no-color turns it off).type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true
--non-interactiveNever ask a question: where one is needed, fail and say so.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--dry-runShow 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.

PropertyValue
usageanyfs roster rotate
wordsroster, rotate
tierwriter

Not drawn

  • mcp: its reach policy does not name the mcp channel
  • rest: its reach policy does not name the rest channel

Titles, headings, exports, tables, columns and requirements. Esc closes.