IF Commons GitHub

cp

verbmutate

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

PropertyValue
kindaction
effectmutate
idempotenttrue
audienceboth
tierwriter
dryRuntrue
checkfalse
reachChannelslocal, mcp
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
SOURCEFiles to copy, then the destination as the last word.

Options

OptionMeaningProperties
--recursiveCopy 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
--includeOnly 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
--excludeLeave out paths that match a glob; give it again for more.type=many, required=false, standard=false, humanOnly=false, valueName=GLOB
--max-filesRefuse a plan that writes more than N files.type=value, required=false, standard=false, humanOnly=false, valueName=N
--max-bytesRefuse a plan that writes more than N bytes.type=value, required=false, standard=false, humanOnly=false, valueName=N
--losslessRefuse 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
--concurrencyAt most N actions at once (the configuration's by default).type=value, required=false, standard=false, humanOnly=false, valueName=N
--plan-hashApply 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
--explainSay 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
--strictStop 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
--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 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.

PropertyValue
usageanyfs cp
wordscp
tierwriter

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

PropertyValue
titleanyfs cp
toolNameanyfs_cp
readOnlyHintfalse
destructiveHintfalse
idempotentHinttrue
inputsrecursive, include, exclude, maxFiles, maxBytes, lossless, concurrency, planHash, explain, strict, dryRun, SOURCE
requiredSOURCE
tierwriter

Not drawn

  • rest: its reach policy does not name the rest channel

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