Aliases: oldfind(1), oldfind(1)
manpages-zh
Chinese manual pages
man-pages-zh-CN
Chinese Man Pages from Chinese Man Pages Project
man-pages-zh_cn
Simplified Chinese Linux man pages
findutils
The GNU versions of find utilities (find and xargs)
NAME
find - 递归地在层次目录中处理文件
总览 SYNOPSIS
find [path...] [expression]
描述 DESCRIPTION
这个文档是GNU版本 find 命令的使用手册。 find 搜索目录树上的每一个文件名，它从左至右运算给定的表达式，按照优先规则(见运 算符OPERATORS一节)进行匹配，直到得出结果（左边运算在 ’与’ 操作中得出假， 在’或’ 操作中得出真），然后 find 移向下一个文件名。
第一个以 ’-’ , ’(’ , ’)’ , ’,’ 或 ’!’ 这些字符起始的参数是表达式的开始; 在它之前的任何参数是要搜索的路径，在它之后的任何参数都是表达式的余下部分。 如果没有路径参数，缺省用当前目录。如果没有表达式，缺省表达式 用 ’-print’.
当所有文件都成功处理时 find 退出并返回状态值0。如果发生错误则返回一个大于0的值。
表达式 EXPRESSIONS
表达式是由选项(选项总是影响所有的操作, 而不仅仅是一个指定的文件的处 理, 而且总是返回真值)，测试(测试返回一个真值或一个假值)，还有动 作(动作有side effects, 返回一个真值或假值) 组成。它们都以运算符分开.忽 略运算符的时候，默认使用 -and 连接. 如果表达式没有包含 -prune 以外的动 作，当表达式为真时会执行 -print 动作。
选项 OPTIONS
所有的选项都总是返回真值，它们总会被执行，除非放在表达式中执行不到的地方。 因此，清楚起见，最好把它们放在表达式的开头部分。
| -daystart | 从当日起始时开始而不是从24小时之前，计算时间(for -amin, -atime, -cmin, -ctime, -mmin, and -mtime)。 |
| -depth | 先处理目录的内容再处理目录本身。 |
| -follow | 不检索符号链接。隐含了 -noleaf。 |
| -help, --help | 列出 find 的命令行用法的概要，然后退出。 |
| -maxdepth levels | 进入命令行参数指定的目录下层目录时，最深不超过levels(一个非负整数) 层。‘-maxdepth 0’ 意味着只在命令行参数指定的目录中执行测试和动作。 |
| -mindepth levels | 不在levels(一个非负整数)层之内执行任何测试和动作。‘-mindepth 1’意 味着处理所有的文件，除了命令行参数指定的目录中的文件。 |
| -mount | 不进入处于其它文件系统之上的目录。可以用-xdev代替，从而和一些其他版本的 find 兼容。 |
| -noleaf | 不为\(lq目录中子目录数量比硬连接数少2\(rq这种假设做优化。这个选项在搜索那些不遵 循UNIX文件系统链接约定的文件系统时用，比如CD-ROM,MS-DOS文件系统或AFS卷的 加载点。在普通的UNIX文件系统中,每个目录至少有两个硬连接,它的名字和它 的 ’.’ 条目。另外，它的子目录(假如有)还会各有一个 ’..’ 链接到它。在 find 检索一个目录时，发现子目录数比它的连接数少二时，它就知道目录中的其他条目 并非目录(而是目录树中的叶(‘leaf’)节点)。除非需要检索的是这个叶节点，否则 没必要去处理它。这样可以带来很大的搜索速度提升。 |
| -version, --version | 打印find的版本号然后退出。 |
| -xdev | 不进入处于其他文件系统之上的目录。 |
测试 TESTS
数字参数可以这样给出：
| +n | 是比 n 大， | ||||||||||||||||
| -n | 是比 n 小， | ||||||||||||||||
| n | 正好是 n 。 | ||||||||||||||||
| -amin n | 对文件的最近一次访问是在 n 分钟之前。 | ||||||||||||||||
| -anewer file | 对文件的最近一次访问比 file 修改时间要晚。如果命令行中 -follow 在 -anewer 之前，(也只有在这种情况下) -anewer 会受 -follow 的影响。 | ||||||||||||||||
| -atime n | 对文件的最近一次访问是在 n*24 小时之前。 | ||||||||||||||||
| -cmin n | 对文件状态的最近一次修改是在 n 分钟之前。 | ||||||||||||||||
| -cnewer file | 对文件状态的最近一次修改比 file 修改时间要晚。如果命令行中 -follow 在 -cnewer 之前，(也只有在这种情况下) -cnewer 会受 -follow 的影响。 | ||||||||||||||||
| -ctime n | 对文件状态的最近一次修改是在 n*24 小时之前。 | ||||||||||||||||
| -empty | 文件是空的普通文件或者空目录。 | ||||||||||||||||
| -false | 总是false。 | ||||||||||||||||
| -fstype type | 文件处于 type 类型的文件系统之上。有效的文件系统类型在不同版本的Unix中是不同的；一些Unix中的不完全的文件系统类型列表是这样：ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. 你可以用 -printf 加上 %F 指令来查看你的文件系统的类型。 | ||||||||||||||||
| -gid n | 文件的数字形式的组ID是 n。 | ||||||||||||||||
| -group gname | 文件属于 gname (也允许使用数字形式的组ID). | ||||||||||||||||
| -ilname pattern | 和 -lname 类似，但是匹配时是不区分大小写的。 | ||||||||||||||||
| -iname pattern | 和 -name 类似，但是匹配时是不区分大小写的。例如，‘fo*’ and ‘F??’ 模式与文件名 ‘Foo’, ‘FOO’, ‘foo’, ‘fOo’ 等等相匹配。 | ||||||||||||||||
| -inum n | 文件的 i 结点数是 n。 | ||||||||||||||||
| -ipath pattern | 和 -path 类似，但是匹配时是不区分大小写的。 | ||||||||||||||||
| -iregex pattern | 和 -regex 类似, 但是匹配时是不区分大小写的。 | ||||||||||||||||
| -links n | 文件有 n 个链接。 | ||||||||||||||||
| -lname pattern | 文件是一个与pattern 匹配的符号链接。元字符不会对‘/’ 或 ‘.’ 做特殊处理。 | ||||||||||||||||
| -mmin n | 对文件数据的最近一次修改是在 n 分钟之前。 | ||||||||||||||||
| -mtime n | 对文件数据的最近一次修改是在 n*24 小时之前。 | ||||||||||||||||
| -name pattern | 基本的文件名(将路径去掉了前面的目录)与shell模式pattern相匹配。元字符(‘*’, ‘?’, 还有‘[]’ ) 不会匹配文件名开头的‘.’ 。使用 -prune 来略过一个目录及其中的文件。查看 -path 的描述中的范例。 | ||||||||||||||||
| -newer file | 对文件的最近一次修改比 file 修改时间要晚。如果命令行中 -follow 在 -newer 之前，(也只有在这种情况下) -newer 会受 -follow 的影响。 | ||||||||||||||||
| -nouser | 没有符合文件的数字形式的用户ID的用户。 | ||||||||||||||||
| -nogroup | 没有符合文件的数字形式的组ID的组。 | ||||||||||||||||
| -path pattern | 文件名与shell模式pattern相匹配。元字符不会对‘/’ 或 ‘.’ 做特殊处理。因此，例如： find . -path ’./sr*sc’ 如果存在 ’./src/misc’ 的话，会将它打印出来。想要忽略一个完整的目录树，应当使用-prune 而不是检查目录树中所有的文件。例如：要跳过 ’src/emacs’ 目录和其中所有的文件和子目录，把其他找到的文件打印出来，应当这样： find . -path ’./src/emacs’ -prune -o -print |
||||||||||||||||
| -perm mode | 文件的权限位恰好是 mode (八进制或符号)。 Symbolic modes use mode 0 as a point of departure. | ||||||||||||||||
| -perm -mode | 所有的权限位 mode 都被设置了的文件。 | ||||||||||||||||
| -perm +mode | 任何权限位 mode 被设置了的文件。 | ||||||||||||||||
| -regex pattern | 文件名与正则表达式 pattern 匹配。这是对整个路径的匹配，不是搜索文件。例如，要匹配名为‘./fubar3’ 的文件，可以使用正则表达式 ‘.*bar.’ 或者 ‘.*b.*3’，但是不能用‘b.*r3’。 | ||||||||||||||||
| -size n[bckw] | 文件使用了 n 单位个存储单元。默认的单位是512字节的块，也可以用n后面加上 ‘b’ 来指定这个值。其他的单位是字节，如果在 n 后面加上 ‘c’ ；千字节(kB)，如果在 n 后面加上‘k’ ；两字节的字，如果在 n 后面加上 ‘w’ 。大小不会计入 indirect blocks，但是会计入没有真正分配空间的疏松文件中的块。 | ||||||||||||||||
| -true | 总是true。 | ||||||||||||||||
| -type c | 文件是 c 类型的。类型可取值如下：
|
||||||||||||||||
| -uid n | 文件的数字形式的用户ID是 n 。 | ||||||||||||||||
| -used n | 文件最后一次存取是在最后一次修改它的状态的 n 天之后。 | ||||||||||||||||
| -user uname | 文件的所有者是 uname (也可以使用数字形式的用户ID). | ||||||||||||||||
| -xtype c | 和 -type 相同，除非文件是一个符号链接。对于符号链接：如果没有给出 -follow ，如果文件是一个指向 c 类型文件的链接，那么返回true；如果给出了 -follow ，如果 c 是 ‘l’ 那么返回true。换句话说，对于符号链接，-xtype 检查那些 -type 不检查的文件。 |
动作 ACTIONS
| -exec command ; | 执行 command；如果命令返回状态值0，那么 exec 返回true。所有 find 其余的命令行参数将作为提供给命令的参数，直到遇到一个由 ‘;’ 组成的参数为止。命令的参数中，字符串 ‘{}’ 将以正在处理的文件名替换。所有的 ‘{}’ 都会被替换，不仅是在单独的一个参数中。有些版本的 find 不是这样做的。 这些参数可能需要用 ‘\’ 来escape 或者用括号括住，防止它们被shell展开。命令是从起始目录执行的。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -fls file | 返回true；类似 -ls 但是像 -fprint 那样写入 file。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -fprint file | 返回true；将文件全名打印到文件 file 中。如果运行 find 时 file 不存在，那么它将被创建。如果它存在，它将被覆盖。文件名‘‘/dev/stdout’’ 和‘‘/dev/stderr’’ 会作特殊处理；它们分别指的是标准输出和标准错误输出。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -fprint0 file | 返回true；类似 -print0 但是像 -fprint 那样写入 file。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -fprintf file format | 返回true；类似 -printf 但是像 -fprint 那样写入 file。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -ok command ; | 类似 -exec 但是会先向用户询问 (在标准输入); 如果回应不是以 ‘y’ 或 ‘Y’ 起始则不会运行 command 而是返回false。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 返回true；在标准输出打印文件全名，然后是一个换行符。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -print0 | 返回true；在标准输出打印文件全名，然后是一个null字符。这样可以使得处理 find 的输出的程序可以正确地理解带有换行符的文件名。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -printf format | 返回true；在标准输出打印 format , 解释 ‘\’ escape 还有 ‘%’ 指令。字段宽度和精度可以像C函数 ‘printf’ 那样来指定。与 -print 不同的是, -printf 在字符串末端不会添加一个新行。可用的escape 和指令如下：
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -prune | 如果没有给出 -depth 则返回 true; 不进入当前目录。 如果给出了 -depth 则返回false; 没有效果。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| -ls | 返回true；以 ‘ls -dils’ 格式在标准输出列出文件。块以1kB 字节为单位计数，除非设置了环境变量POSIXLY_CORRECT，那样的话会使用 512字节的块。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
运算符 OPERATORS
以优先级高低顺序排列：
| ( expr ) | 强制为优先 |
| ! expr | 如果 expr 是false则返回true |
| -not expr | 与 ! expr 相同 |
| expr1 expr2 | 与 (隐含的默认运算符)；如果 expr1 为false则不会执行 expr2 |
| expr1 -a expr2 | 与 expr1 expr2 相同 |
| expr1 -and expr2 | 与 expr1 expr2 相同 |
| expr1 -o expr2 | 或；如果 expr1 为true 则不会执行 expr2 |
| expr1 -or expr2 | 与 expr1 -o expr2 相同 |
| expr1 , expr2 | 列表；expr1 和 expr2 都会被执行。expr1 的值被忽略，列表的值是 expr2的值 |
参见 SEE ALSO
[中文版维护人]
袁乙钧 <bbbush>
[中文版最新更新]
11/01/2003
《中国linux论坛man手册页翻译计划》:
http://cmpp.linuxforum.net
跋
本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh
中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh
REFERENCED BY
dpkg-name(1), xargs(1), ippfind(1), fts(3), proc(5), hier(7), symlink(7), tar(1), xz(1), abicheck(1), aefind(1), cg(1), chase(1), gnome-search-tool(1), makeactive(8), jmtpfs(1), zip(1), , , , uudeview(1), locatedb(5), mate-search-tool(1), mkaf(1), pseudolog(1), rdfind(1), index++(1), tree(1), ftff(1), bfs(1), grep(1), scpio(1), STAR(1), mkhybrid(8), mkisofs(8), fd(1), samefile(1), fdfind(1), pycdlib-genisoimage(1), bosh(1), ustar(1)
