tldr/pages/common/find.md

# find

> Find files or directories under a directory tree, recursively.
> More information: <https://manned.org/find>.

- Find files by extension:

`find {{root_path}} -name '{{*.ext}}'`

- Find files matching multiple path/name patterns:

`find {{root_path}} -path '{{**/path/**/*.ext}}' -or -name '{{*pattern*}}'`

- Find directories matching a given name, in case-insensitive mode:

`find {{root_path}} -type d -iname '{{*lib*}}'`

- Find files matching a given pattern, excluding specific paths:

`find {{root_path}} -name '{{*.py}}' -not -path '{{*/site-packages/*}}'`

- Find files matching a given size range, limiting the recursive depth to "1":

`find {{root_path}} -maxdepth 1 -size {{+500k}} -size {{-10M}}`

- Run a command for each file (use `{}` within the command to access the filename):

`find {{root_path}} -name '{{*.ext}}' -exec {{wc -l}} {} \;`

- Find all files modified today and pass the results to a single command as arguments:

`find {{root_path}} -daystart -mtime {{-1}} -exec {{tar -cvf archive.tar}} {} \+`

- Find empty (0 byte) files and delete them:

`find {{root_path}} -type {{f}} -empty -delete`
Add doc for find(1) 2013-12-11 10:23:59 +00:00			`# find`

pages*: simplify page description (#12149) Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com> 2024-02-14 20:25:13 +00:00			`> Find files or directories under a directory tree, recursively.`
add more information links 2021-04-17 16:15:37 +01:00			`> More information: <https://manned.org/find>.`
Add doc for find(1) 2013-12-11 10:23:59 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Find files by extension:`
Add doc for find(1) 2013-12-11 10:23:59 +00:00
find: quotes outside tokens; generic extension (#1160) The generic extension is to conform to our contribution guidelines: https://github.com/tldr-pages/tldr/blob/master/CONTRIBUTING.md#token-syntax 2016-11-26 15:51:12 +00:00			`find {{root_path}} -name '{{*.ext}}'`
Add doc for find(1) 2013-12-11 10:23:59 +00:00
find: add example to find and delete empty files (#5973) 2021-05-16 20:06:51 +01:00			`- Find files matching multiple path/name patterns:`
find: add searching multiple patterns simultaneously (#2589) 2018-11-15 21:33:41 +00:00
find: closing single quote missed in example (#6410) 2021-08-25 16:45:40 +01:00			`find {{root_path}} -path '{{/path//.ext}}' -or -name '{{pattern*}}'`
find: add searching multiple patterns simultaneously (#2589) 2018-11-15 21:33:41 +00:00
find: various improvements (#3124) * find: various improvements The information content of the page should be unchanged, but hopefully it's now easier to read (and respects our length recommendations of 8 maximum examples). The changes include: - Make the `-mtime` example more intuitive, so it only needs to be shown once, and combine the `-delete` option with the first (now only) `-mtime` example (thus reducing the page size back to 8 examples) - Fix a comma splice in the `-exec` example, and a missing "a" in the `-path` example - Reorder the examples to provide a more consistent and intuitive sequence (e.g. by introducing `-iname` in an earlier example, and moving the `-exec` command down) * clarify -size example description 2019-06-24 03:43:25 +01:00			`- Find directories matching a given name, in case-insensitive mode:`
find: reoder example 2018-08-26 05:49:15 +01:00
find: always enclose the pattern in quotes (#3983) As mentioned in man page, should always enclose the pattern in quotes in order to protect it from expansion by the shell. 2020-04-15 17:51:26 +01:00			`find {{root_path}} -type d -iname '{{lib}}'`
find: reoder example 2018-08-26 05:49:15 +01:00
find: various improvements (#3124) * find: various improvements The information content of the page should be unchanged, but hopefully it's now easier to read (and respects our length recommendations of 8 maximum examples). The changes include: - Make the `-mtime` example more intuitive, so it only needs to be shown once, and combine the `-delete` option with the first (now only) `-mtime` example (thus reducing the page size back to 8 examples) - Fix a comma splice in the `-exec` example, and a missing "a" in the `-path` example - Reorder the examples to provide a more consistent and intuitive sequence (e.g. by introducing `-iname` in an earlier example, and moving the `-exec` command down) * clarify -size example description 2019-06-24 03:43:25 +01:00			`- Find files matching a given pattern, excluding specific paths:`
Update find.md 2015-12-28 09:43:58 +00:00
find: various improvements (#3124) * find: various improvements The information content of the page should be unchanged, but hopefully it's now easier to read (and respects our length recommendations of 8 maximum examples). The changes include: - Make the `-mtime` example more intuitive, so it only needs to be shown once, and combine the `-delete` option with the first (now only) `-mtime` example (thus reducing the page size back to 8 examples) - Fix a comma splice in the `-exec` example, and a missing "a" in the `-path` example - Reorder the examples to provide a more consistent and intuitive sequence (e.g. by introducing `-iname` in an earlier example, and moving the `-exec` command down) * clarify -size example description 2019-06-24 03:43:25 +01:00			`find {{root_path}} -name '{{.py}}' -not -path '{{/site-packages/*}}'`
A bunch of new pages: common/: dig, gzip, rm, sort, zfs, zpool linux/: apt-get, shutdown osx/: airport, caffeinate, diskutil, networksetup open, pgrep, qlmanage, say, shutdown, sysctl, system_profiler Edits to existing pages: curl: Added simple download example find: Added iname and size exmaples grep: Edited -c description ps: Added wide lines example ssh: edited -D description, added simple port forwarding example unzip: added list option 2014-02-10 20:36:05 +00:00
pages*: remove double colons (`::`) (#10551) 2023-07-27 16:42:45 +01:00			`- Find files matching a given size range, limiting the recursive depth to "1":`
A bunch of new pages: common/: dig, gzip, rm, sort, zfs, zpool linux/: apt-get, shutdown osx/: airport, caffeinate, diskutil, networksetup open, pgrep, qlmanage, say, shutdown, sysctl, system_profiler Edits to existing pages: curl: Added simple download example find: Added iname and size exmaples grep: Edited -c description ps: Added wide lines example ssh: edited -D description, added simple port forwarding example unzip: added list option 2014-02-10 20:36:05 +00:00
find: add maxdepth in example (#8719) 2022-10-07 15:00:29 +01:00			`find {{root_path}} -maxdepth 1 -size {{+500k}} -size {{-10M}}`
Add find -delete 2015-12-27 05:52:17 +00:00
find: various improvements (#3124) * find: various improvements The information content of the page should be unchanged, but hopefully it's now easier to read (and respects our length recommendations of 8 maximum examples). The changes include: - Make the `-mtime` example more intuitive, so it only needs to be shown once, and combine the `-delete` option with the first (now only) `-mtime` example (thus reducing the page size back to 8 examples) - Fix a comma splice in the `-exec` example, and a missing "a" in the `-path` example - Reorder the examples to provide a more consistent and intuitive sequence (e.g. by introducing `-iname` in an earlier example, and moving the `-exec` command down) * clarify -size example description 2019-06-24 03:43:25 +01:00			- Run a command for each file (use `{}` within the command to access the filename):
Add find -delete 2015-12-27 05:52:17 +00:00
find: Markdown format tweaks, introduce the '+' operator for exec (#12126) 2024-01-25 02:00:15 +00:00			`find {{root_path}} -name '{{*.ext}}' -exec {{wc -l}} {} \;`
find: added options for multiple search criteria and empty files added path for -empty option 2015-12-30 18:43:58 +00:00
find: Markdown format tweaks, introduce the '+' operator for exec (#12126) 2024-01-25 02:00:15 +00:00			`- Find all files modified today and pass the results to a single command as arguments:`
find: add example to find and delete empty files (#5973) 2021-05-16 20:06:51 +01:00
find: Markdown format tweaks, introduce the '+' operator for exec (#12126) 2024-01-25 02:00:15 +00:00			`find {{root_path}} -daystart -mtime {{-1}} -exec {{tar -cvf archive.tar}} {} \+`
find: add example to find and delete empty files (#5973) 2021-05-16 20:06:51 +01:00
			`- Find empty (0 byte) files and delete them:`
find: ignore given directory (#1289) * find path while excluding certain directory * delete the `find {{root_path}} -empty` command to meet the demand of 8 commands at most * tokenize the demo parameter 2017-03-10 14:48:29 +00:00
find: add example to find and delete empty files (#5973) 2021-05-16 20:06:51 +01:00			`find {{root_path}} -type {{f}} -empty -delete`