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-reader. 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

Not drawn by any surface for this tier.

Not drawn

  • cli: roster rotate is for the tier writer; this caller holds reader
  • mcp: roster rotate is for the tier writer; this caller holds reader
  • rest: roster rotate is for the tier writer; this caller holds reader

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