ManPage for Linux
Tabs
tab-1
2 hours ago
ManPage Type:
ManPage Search:

General commands(Man1)

FIND


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

不为“目录中子目录数量比硬连接数少2”这种假设做优化。 这个选项在搜索那些不遵循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 类型的。 类型可取值如下：

b

特殊块文件(缓冲的)

c

特殊字符文件(不缓冲)

d

目录

p

命名管道(FIFO)

f

普通文件

l

符号链接

s

套接字

D

门(Solaris 特有)

−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。

−print

返回true； 在标准输出打印文件全名， 然后是一个换行符。

−print0

返回true； 在标准输出打印文件全名， 然后是一个null字符。 这样可以使得处理find 的输出的程序可以正确地理解带有换行符的文件名。

−printf format

返回true； 在标准输出打印format , 解释’\’ escape 还有’%’ 指令。 字段宽度和精度可以像C函数’printf’ 那样来指定。 与−print 不同的是, −printf 在字符串末端不会添加一个新行。 可用的escape 和指令如下：

\a

警告铃声

\b

回退

\c

立即停止以当前格式输出， 刷新输出设备。

\f

表格结束

\n

新行

\r

回车

\t

水平tab

\v

竖直tab

\\

输出自身’\’

\NNN

ASCII编码是NNN(八进制)的字符

在一个’\’ 字符后面使用任何其他字符会被作为普通的字符， 因此它们都会被打印出来。

%%

输出自身’%’

%a

文件最后一次存取的时间。 格式是C函数’ctime’ 返回值的格式。

%Ak

文件最后一次存取的时间。 格式以k 指定， 可以是’@’ 或者是C函数’strftime’ 的指令格式。 下面列出了k 可用的值； 有一些并不是在所有系统上都可用， 因为不同系统中’strftime’ 也不同。

@

从Jan. 1, 1970, 00:00 GMT 起的秒数

时间字段：

H

小时(00..23)

I

小时(01..12)

k

小时( 0..23)

l

小时( 1..12)

M

分钟(00..59)

p

本地的AM 或者PM

r

12小时格式的时间(hh:mm:ss [AP]M)

S

秒(00..61)

T

24小时格式的时间(hh:mm:ss)

X

本地的时间表示方法(H:M:S)

Z

时区(例如， EDT)， 如果不能决定时区就是空

日期字段：

a

本地一星期中每天的名称的缩写(Sun..Sat)

A

本地一星期中每天的全名， 可变长度(Sunday..Saturday)

b

本地每月的名称的缩写(Jan..Dec)

B

本地每月的全名， 可变长度(January..December)

c

本地的日期和时间表示(Sat Nov 04 12:02:33 EST 1989)

d

一个月当中的日子(01..31)

D

日期(mm/dd/yy)

h

与b 相同

j

一年当中的日子(001..366)

m

月份(01..12)

U

以星期日作为每周起始， 一年当中的星期(00..53)

w

一星期当中的日子(0..6)

W

以星期一当作每周起始， 一年当中的星期(00..53)

x

本地的日期表示(mm/dd/yy)

y

年份的最后两位(00..99)

Y

年份(1970...)

%b

文件大小， 以512字节的块为单位(四舍五入)。

%c

文件状态最后一次修改的时间。 格式是C函数’ctime’ 返回值的格式。

%Ck

文件状态最后一次修改的时间。 格式以k 指定， 类似于%A。

%d

文件在目录树中的深度； 0 意味着文件是一个命令行参数。

%f

去掉了前面的目录的文件名(只剩下最后的成分)。

%F

文件所在文件系统的类型； 这个值可以为−fstype 所用。

%g

文件的组名， 如果组没有名称就是数字形式的组ID。

%G

文件的数字形式的组ID。

%h

文件名的前面的目录部分(仅除去最后的成分)。

%H

据以找到了文件的命令行参数。

%i

文件的i 结点号(16进制)。

%k

文件大小， 以1kB 的块为单位(四舍五入)。

%l

符号链接的目标(如果文件不是一个符号链接， 那么结果是空字符串)。

%m

文件的权限位(8进制)。

%n

文件的硬连接数。

%p

文件名。

%P

文件名， 去掉了据以找到了文件的命令行参数的名称部分。

%s

文件大小， 以字节为单位。

%t

文件最后一次修改的时间。 格式是C函数’ctime’ 返回值的格式。

%Tk

文件最后一次修改的时间。 格式以k 指定， 类似于%A。

%u

文件的用户名， 如果用户没有名称就是数字形式的用户ID。

%U

文件的数字形式的用户ID。

在一个’%’ 字符后面使用任何其他字符， ’%’ 将被忽略(但是其他字符会被打印出来)。

−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

locate(1L), locatedb(5L), updatedb(1L), xargs(1L) Finding Files (Info 在线帮助, 或者是打印的版本)

[中文版维护人]

袁乙钧<bbbush@163.com>

[中文版最新更新]

11/01/2003

《 中国linux论坛man手册页翻译计划》 :

http://cmpp.linuxforum.net

THE END

You have recently used these: ManPage for LinuxClipboardHexBinDecOctBinary-Coded DecimalBasic CalculatorDNS LookupIPv4 <-> Long

We're looking forward to your any suggestion.

Since v1.6.0, we have adjusted the main layout as the browser page mode based, which means you can easily switch one of these tabs. Please click the mountain button on the top nav bar if you like the previous layout style.

If you have any suggestion, please feel free to send an E-Mail to us or create an issue on Github, the developer contact information as below:

The Intelligent, Secure, and AD-Free ToolBox is Powered by CodeGen Official Team.
"t’s not a bug - it’s a feature"
Copyright © 2016-2022 All rights reserved.
Saved
Handling /exts/LinuxManPage