IF Commons GitHub

roster add

verbmutate

Add the public keys of files (rosters, entries, signing keys) to a roster file.

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
idempotenttrue
audienceboth
tierwriter
dryRuntrue
checkfalse
reachChannelslocal
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
ROSTERThe roster file; made where it is not there.
SOURCEFiles whose public keys to add: a roster, an entry or a signing key (its private part is not read out).

Options

OptionMeaningProperties
--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 add roster.json a.entry.json b.key  # Add the keys of the two files to the roster.

Physical: what it is drawn as

Not drawn by any surface for this tier.

Not drawn

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

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