IF Commons GitHub

find

verbread

Find names below a directory of a store by name, type and size.

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
kindreport
effectread
idempotenttrue
audienceboth
tierreader
dryRunfalse
checkfalse
reachChannelslocal, ssh, mcp, rest
reachReadOnlytrue
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
LOCATIONA directory to look below. Here by default.

Options

OptionMeaningProperties
--nameOnly names that match a wildcard (* and ?), by their last word.type=value, required=false, standard=false, humanOnly=false, valueName=WILDCARD
--typeOnly files (f) or directories (d).type=value, required=false, standard=false, humanOnly=false, valueName=f|d
--sizeOnly files by size: +N over, -N under, N exactly; K, M or G after the number.type=value, required=false, standard=false, humanOnly=false, valueName=TEST
--maxdepthGo down at most N directories.type=value, required=false, standard=false, humanOnly=false, valueName=N
--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
--sarifWrite the findings as SARIF 2.1.0 and nothing else.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
--onRun it on these targets instead of here: ids joined by commas, `class:<class>` or `all`.type=value, required=false, standard=true, humanOnly=false, valueName=VALUE

Examples

anyfs find fleet:/ --name *.json --type f  # Every JSON file below the root of the mount fleet.

Physical: what it is drawn as

anyfs find

cli-command. Find names below a directory of a store by name, type and size.

PropertyValue
usageanyfs find
wordsfind
tierreader

anyfs_find

mcp-tool. Find names below a directory of a store by name, type and size. (report, effect read, safe to repeat.)

PropertyValue
titleanyfs find
toolNameanyfs_find
readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
inputsname, type, size, maxdepth, explain, strict, LOCATION
requiredLOCATION
tierreader

GET /v1/find

rest-route. Find names below a directory of a store by name, type and size.

PropertyValue
methodGET
path/v1/find
operationIdanyfs_find
effectread
tierreader
idempotenttrue

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