cp
verbmutateCopy files, and directories with -r, within a store or from one store to another.
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 |
|---|---|
SOURCE | Files to copy, then the destination as the last word. |
Options
| Option | Meaning | Properties |
|---|---|---|
--recursive | Copy directories, and what is in them, by a plan of the bridge. | type=flag, short=r, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--include | Only paths that match a glob (a * is within one name, ** crosses directories); give it again for more. | type=many, required=false, standard=false, humanOnly=false, valueName=GLOB |
--exclude | Leave out paths that match a glob; give it again for more. | type=many, required=false, standard=false, humanOnly=false, valueName=GLOB |
--max-files | Refuse a plan that writes more than N files. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--max-bytes | Refuse a plan that writes more than N bytes. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--lossless | Refuse a plan that would lose anything at the destination (a name it cannot keep, a case that folds). | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--concurrency | At most N actions at once (the configuration's by default). | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--plan-hash | Apply only the plan with this hash, which a --dry-run printed: if the stores changed since, nothing is applied. | type=value, required=false, standard=false, humanOnly=false, valueName=HASH |
--explain | Say how the store would carry the operation out (native, emulated or refused), and do nothing else. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--strict | Stop where the store carries an operation out by a means that can lose or change what you meant. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--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 cp ./alpha.json fleet:/machines/ # Copy a local file into the directory machines of the mount fleet.
anyfs cp -r fleet:/machines s3backup:/machines # Copy a directory from one store to another by a plan: --dry-run shows it.Physical: what it is drawn as
anyfs cp
cli-command. Copy files, and directories with -r, within a store or from one store to another.
| Property | Value |
|---|---|
usage | anyfs cp |
words | cp |
tier | writer |
anyfs_cp
mcp-tool. Copy files, and directories with -r, within a store or from one store to another. (action, effect mutate, safe to repeat.)
| Property | Value |
|---|---|
title | anyfs cp |
toolName | anyfs_cp |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | true |
inputs | recursive, include, exclude, maxFiles, maxBytes, lossless, concurrency, planHash, explain, strict, dryRun, SOURCE |
required | SOURCE |
tier | writer |
Not drawn
- rest: its reach policy does not name the rest channel