IF Commons GitHub

roster fetch

verbmutate

Read a roster from a store and take in only the new keys whose ids were accepted by name; show the others.

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.
LOCATIONThe file of a store that holds a roster.

Options

OptionMeaningProperties
--acceptThe ids of the new keys to take in, as you checked them with their owners by another way than the store. A new key not named here is only shown.type=value, required=false, standard=false, humanOnly=false, valueName=KEYID[,KEYID]
--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 fetch roster.json shared:/keys/roster.json  # Show the keys the shared roster has that yours has not; nothing is added.
anyfs roster fetch --accept 0123456789abcdef roster.json shared:/keys/roster.json  # Take in the one key you checked.

Physical: what it is drawn as

Not drawn by any surface for this tier.

Not drawn

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

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