sync-medium
verbmutateExchange a store that merges with a shared place: publish its new rows as delta files and take the files of the others.
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 | true |
audience | both |
tier | writer |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Operands
| Operand | Meaning |
|---|---|
STORE | The store that merges. |
MEDIUM | The shared place: any store that reads, writes and lists. |
Options
| Option | Meaning | Properties |
|---|---|---|
--replica | The identity of the store as a replica (32 hexadecimal digits), which the store does not say of itself. | type=value, required=false, standard=false, humanOnly=false, valueName=ID |
--max-rows | Put at most N rows in one delta file. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--trust | Whom to take changes from: open (anyone), allowlist (the replicas of --replicas) or signed (the keys of --roster). Where it is left out the mount says, and where the mount says nothing the store keeps the trust it has. | type=value, required=false, standard=false, humanOnly=false, valueName=MODE |
--roster | The keys that are known, as a file of a JSON list (or env:NAME, a variable that holds the text): for --trust signed. | type=value, required=false, standard=false, humanOnly=false, valueName=FILE |
--sign-key | The keys that sign what is published, each a file (or env:NAME, a variable that holds the key): a delta is signed with the key of the replica that made it. The key is never given on the command line. | type=value, required=false, standard=false, humanOnly=false, valueName=FILE[,FILE] |
--replicas | The replicas that are taken changes from, by identity (32 hexadecimal digits); with --trust signed it narrows the roster. | type=value, required=false, standard=false, humanOnly=false, valueName=ID[,ID] |
--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 sync-medium --dry-run --replica 0123456789abcdef0123456789abcdef fleet-a:/ shared:/ # How many rows are not published yet and which delta files of the others are not taken.
anyfs sync-medium --replica 0123456789abcdef0123456789abcdef fleet-a:/ shared:/ # Publish the new rows as delta files and take the others'.Physical: what it is drawn as
anyfs sync-medium
cli-command. Exchange a store that merges with a shared place: publish its new rows as delta files and take the files of the others.
| Property | Value |
|---|---|
usage | anyfs sync-medium |
words | sync-medium |
tier | writer |
anyfs_sync_medium
mcp-tool. Exchange a store that merges with a shared place: publish its new rows as delta files and take the files of the others. (action, effect mutate, safe to repeat.)
| Property | Value |
|---|---|
title | anyfs sync-medium |
toolName | anyfs_sync_medium |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | true |
inputs | replica, maxRows, trust, roster, signKey, replicas, dryRun, STORE, MEDIUM |
required | STORE, MEDIUM |
tier | writer |
Not drawn
- rest: its reach policy does not name the rest channel