.TH FIND 1 \" -*- nroff -*-
.SH NAME
find \- 遞歸地在層次目錄中處理文件
.SH 總覽 SYNOPSIS
.B find
[path...] [expression]
.SH 描述 DESCRIPTION
這個文檔是GNU版本
.BR find
命令的使用手冊。
.B find
搜索目錄樹上的每一個文件名，它從左至右運算給定的表達式，按照優先規則(見運
算符OPERATORS一節)進行匹配，直到得出結果（左邊運算在 '與' 操作中得出假，
在'或' 操作中得出真），然後
.B find
移向下一個文件名。
.PP 
第一個以 '\-' , '(' , ')' , ',' 或 '!' 這些字符起始的參數是表達式的開始;
在它之前的任何參數是要搜索的路徑，在它之後的任何參數都是表達式的餘下部分。
如果沒有路徑參數，缺省用當前目錄。如果沒有表達式，缺省表達式
用 '\-print'.
.PP
當所有文件都成功處理時
.B find
退出並返回狀態值0。如果發生錯誤則返回一個大於0的值。
.SH 表達式 EXPRESSIONS
.P
表達式是由\fB選項\fR(選項總是影響所有的操作, 而不僅僅是一個指定的文件的處
理, 而且總是返回真值)，\fB測試\fR(測試返回一個真值或一個假值)，還有\fB動
作\fR(動作有side effects, 返回一個真值或假值) 組成。它們都以運算符分開.忽
略運算符的時候，默認使用 \-and 連接. 如果表達式沒有包含 \-prune 以外的動
作，當表達式爲真時會執行 \-print 動作。
.SS 選項 OPTIONS
.P
所有的選項都總是返回真值，它們總會被執行，除非放在表達式中執行不到的地方。
因此，清楚起見，最好把它們放在表達式的開頭部分。
.IP \-daystart
從當日起始時開始而不是從24小時之前，計算時間(for \-amin, \-atime,
\-cmin, \-ctime, \-mmin, and \-mtime)。
.IP \-depth
先處理目錄的內容再處理目錄本身。
.IP \-follow
不檢索符號鏈接。隱含了 \-noleaf。
.IP "\-help, \-\-help"
列出
.B find
的命令行用法的概要，然後退出。
.IP "\-maxdepth \fIlevels\fR"
進入命令行參數指定的目錄下層目錄時，最深不超過\fIlevels\fR(一個非負整數)
層。`\-maxdepth 0' 意味着只在命令行參數指定的目錄中執行測試和動作。
.IP "\-mindepth \fIlevels\fR"
不在\fIlevels\fR(一個非負整數)層之內執行任何測試和動作。`\-mindepth 1'意
味着處理所有的文件，除了命令行參數指定的目錄中的文件。
.IP \-mount
不進入處於其它文件系統之上的目錄。可以用\-xdev代替，從而和一些其他版本的
.BR find
兼容。
.IP "\-noleaf"
不爲\(lq目錄中子目錄數量比硬連接數少2\(rq這種假設做優化。這個選項在搜索那些不遵
循UNIX文件系統鏈接約定的文件系統時用，比如CD-ROM,MS-DOS文件系統或AFS卷的
加載點。在普通的UNIX文件系統中,每個目錄至少有兩個硬連接,它的名字和它
的 '.' 條目。另外，它的子目錄(假如有)還會各有一個 '..' 鏈接到它。在
.B find
檢索一個目錄時，發現子目錄數比它的連接數少二時，它就知道目錄中的其他條目
並非目錄(而是目錄樹中的葉(`leaf')節點)。除非需要檢索的是這個葉節點，否則
沒必要去處理它。這樣可以帶來很大的搜索速度提升。
.IP "\-version, \-\-version"
打印\fBfind\fR的版本號然後退出。
.IP \-xdev
不進入處於其他文件系統之上的目錄。
.SS 測試 TESTS
.P
數字參數可以這樣給出：
.IP \fI+n\fP
是比
.IR n
大，
.IP \fI\-n\fP
是比
.IR n
小，
.IP \fIn\fP
正好是
.IR n
。
.IP "\-amin \fIn\fR"
對文件的最近一次訪問是在 \fIn\fR 分鐘之前。
.IP "\-anewer \fIfile\fR"
對文件的最近一次訪問比 \fIfile\fR 修改時間要晚。如果命令行中 \-follow 在 \-anewer 之前，(也只有在這種情況下) \-anewer 會受 \-follow 的影響。
.IP "\-atime \fIn\fR"
對文件的最近一次訪問是在 \fIn\fR*24 小時之前。
.IP "\-cmin \fIn\fR"
對文件狀態的最近一次修改是在 \fIn\fR 分鐘之前。
.IP "\-cnewer \fIfile\fR"
對文件狀態的最近一次修改比 \fIfile\fR 修改時間要晚。如果命令行中 \-follow 在 \-cnewer 之前，(也只有在這種情況下) \-cnewer 會受 \-follow 的影響。
.IP "\-ctime \fIn\fR"
對文件狀態的最近一次修改是在 \fIn\fR*24 小時之前。
.IP \-empty
文件是空的普通文件或者空目錄。
.IP \-false
總是false。
.IP "\-fstype \fItype\fR"
文件處於 \fItype\fR 類型的文件系統之上。有效的文件系統類型在不同版本的Unix中是不同的；一些Unix中的不完全的文件系統類型列表是這樣：ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. 你可以用 \-printf 加上 %F 指令來查看你的文件系統的類型。
.IP "\-gid \fIn\fR"
文件的數字形式的組ID是 \fIn\fR。
.IP "\-group \fIgname\fR"
文件屬於 \fIgname\fR (也允許使用數字形式的組ID).
.IP "\-ilname \fIpattern\fR"
和 \-lname 類似，但是匹配時是不區分大小寫的。
.IP "\-iname \fIpattern\fR"
和 \-name 類似，但是匹配時是不區分大小寫的。例如，`fo*' and `F??' 模式與文件名 `Foo', `FOO', `foo', `fOo' 等等相匹配。
.IP "\-inum \fIn\fR"
文件的 i 結點數是 \fIn\fR。
.IP "\-ipath \fIpattern\fR"
和 \-path 類似，但是匹配時是不區分大小寫的。
.IP "\-iregex \fIpattern\fR"
和 \-regex 類似, 但是匹配時是不區分大小寫的。
.IP "\-links \fIn\fR"
文件有 \fIn\fR 個鏈接。
.IP "\-lname \fIpattern\fR"
文件是一個與\fIpattern\fR 匹配的符號鏈接。元字符不會對`/' 或 `.' 做特殊處理。
.IP "\-mmin \fIn\fR"
對文件數據的最近一次修改是在 \fIn\fR 分鐘之前。
.IP "\-mtime \fIn\fR"
對文件數據的最近一次修改是在 \fIn\fR*24 小時之前。
.IP "\-name \fIpattern\fR"
基本的文件名(將路徑去掉了前面的目錄)與shell模式\fIpattern\fR相匹配。元字符(`*', `?', 還有`[]' ) 不會匹配文件名開頭的`.' 。使用 \-prune 來略過一個目錄及其中的文件。查看 \-path 的描述中的範例。
.IP "\-newer \fIfile\fR"
對文件的最近一次修改比 \fIfile\fR 修改時間要晚。如果命令行中 \-follow 在 \-newer 之前，(也只有在這種情況下) \-newer 會受 \-follow 的影響。
.IP \-nouser
沒有符合文件的數字形式的用戶ID的用戶。
.IP \-nogroup
沒有符合文件的數字形式的組ID的組。
.IP "\-path \fIpattern\fR"
文件名與shell模式\fIpattern\fR相匹配。元字符不會對`/' 或 `.' 做特殊處理。因此，例如：
.br
.in +1i
find . \-path './sr*sc'
.br
.in -1i
如果存在 './src/misc' 的話，會將它打印出來。想要忽略一個完整的目錄樹，應當使用\-prune 而不是檢查目錄樹中所有的文件。例如：要跳過 'src/emacs' 目錄和其中所有的文件和子目錄，把其他找到的文件打印出來，應當這樣：
.br
.in +1i
find . \-path './src/emacs' -prune -o -print
.br
.in -1i
.IP "\-perm \fImode\fR"
文件的權限位恰好是 \fImode\fR (八進制或符號)。
Symbolic modes use mode 0 as a point of departure.
.IP "\-perm \-\fImode\fR"
所有的權限位 \fImode\fR 都被設置了的文件。
.IP "\-perm +\fImode\fR"
任何權限位 \fImode\fR 被設置了的文件。
.IP "\-regex \fIpattern\fR"
文件名與正則表達式 \fIpattern\fR 匹配。這是對整個路徑的匹配，不是搜索文件。例如，要匹配名爲`./fubar3' 的文件，可以使用正則表達式 `.*bar.' 或者 `.*b.*3'，但是不能用`b.*r3'。
.IP "\-size \fIn\fR[bckw]"
文件使用了 \fIn\fP 單位個存儲單元。默認的單位是512字節的塊，也可以用\fIn\fP後面加上 `b' 來指定這個值。其他的單位是字節，如果在 \fIn\fP 後面加上 `c' ；千字節(kB)，如果在 \fIn\fP 後面加上`k' ；兩字節的字，如果在 \fIn\fP 後面加上 `w' 。大小不會計入 indirect blocks，但是會計入沒有真正分配空間的疏鬆文件中的塊。
.IP \-true
總是true。
.IP "\-type \fIc\fR"
文件是 \fIc\fR 類型的。類型可取值如下：
.RS
.IP b
特殊塊文件(緩衝的)
.IP c
特殊字符文件(不緩衝)
.IP d
目錄
.IP p
命名管道 (FIFO)
.IP f
普通文件
.IP l
符號鏈接
.IP s
套接字
.IP D
門 (Solaris 特有)
.RE
.IP "\-uid \fIn\fR"
文件的數字形式的用戶ID是 \fIn\fR 。
.IP "\-used \fIn\fR"
文件最後一次存取是在最後一次修改它的狀態的 \fIn\fR 天之後。
.IP "\-user \fIuname\fR"
文件的所有者是 \fIuname\fR (也可以使用數字形式的用戶ID).
.IP "\-xtype \fIc\fR"
和 \-type 相同，除非文件是一個符號鏈接。對於符號鏈接：如果沒有給出 \-follow ，如果文件是一個指向 \fIc\fR 類型文件的鏈接，那麼返回true；如果給出了 \-follow ，如果 \fIc\fR 是 `l' 那麼返回true。換句話說，對於符號鏈接，\-xtype 檢查那些 \-type 不檢查的文件。
.SS 動作 ACTIONS
.IP "\-exec \fIcommand\fR ;"
執行 \fIcommand\fR；如果命令返回狀態值0，那麼 exec 返回true。所有
.B find
其餘的命令行參數將作爲提供給命令的參數，直到遇到一個由 `;' 組成的參數爲止。命令的參數中，字符串 `{}' 將以正在處理的文件名替換。所有的 `{}' 都會被替換，不僅是在單獨的一個參數中。有些版本的
.BR find 
不是這樣做的。
這些參數可能需要用 `\e' 來escape 或者用括號括住，防止它們被shell展開。命令是從起始目錄執行的。
.IP "\-fls \fIfile\fR"
返回true；類似 \-ls 但是像 \-fprint 那樣寫入 \fIfile\fR。
.IP "\-fprint \fIfile\fR"
返回true；將文件全名打印到文件 \fIfile\fR 中。如果運行 \fBfind\fR 時 \fIfile\fR 不存在，那麼它將被創建。如果它存在，它將被覆蓋。文件名``/dev/stdout'' 和``/dev/stderr'' 會作特殊處理；它們分別指的是標準輸出和標準錯誤輸出。
.IP "\-fprint0 \fIfile\fR"
返回true；類似 \-print0 但是像 \-fprint 那樣寫入 \fIfile\fR。
.IP "\-fprintf \fIfile\fR \fIformat\fR"
返回true；類似 \-printf 但是像 \-fprint 那樣寫入 \fIfile\fR。
.IP "\-ok \fIcommand\fR ;"
類似 \-exec 但是會先向用戶詢問 (在標準輸入); 如果迴應不是以 `y' 或 `Y' 起始則不會運行 \fIcommand\fR 而是返回false。
.IP \-print
返回true；在標準輸出打印文件全名，然後是一個換行符。
.IP \-print0
返回true；在標準輸出打印文件全名，然後是一個null字符。這樣可以使得處理 \fBfind\fR 的輸出的程序可以正確地理解帶有換行符的文件名。
.IP "\-printf \fIformat\fR"
返回true；在標準輸出打印 \fIformat\fR , 解釋 `\e' escape 還有 `%' 指令。字段寬度和精度可以像C函數 `printf' 那樣來指定。與 \-print 不同的是, \-printf 在字符串末端不會添加一個新行。可用的escape 和指令如下：
.RS
.IP \ea
警告鈴聲
.IP \eb
回退
.IP \ec
立即停止以當前格式輸出，刷新輸出設備。
.IP \ef
表格結束
.IP \en
新行
.IP \er
回車
.IP \et
水平tab
.IP \ev
豎直tab
.IP \e\e
輸出自身`\e'
.IP \eNNN
ASCII編碼是NNN(八進制)的字符
.PP
在一個 `\e' 字符後面使用任何其他字符會被作爲普通的字符，因此它們都會被打印出來。
.IP %%
輸出自身`%'
.IP %a
文件最後一次存取的時間。格式是C函數 `ctime' 返回值的格式。
.IP %A\fIk\fP
文件最後一次存取的時間。格式以 \fIk\fR 指定，可以是 `@' 或者是C函數 `strftime' 的指令格式。下面列出了 \fIk\fR 可用的值；有一些並不是在所有系統上都可用，因爲不同系統中 `strftime' 也不同。
.RS
.IP @
從 Jan. 1, 1970, 00:00 GMT 起的秒數
.PP
時間字段：
.IP H
小時 (00..23)
.IP I
小時 (01..12)
.IP k
小時 ( 0..23)
.IP l
小時 ( 1..12)
.IP M
分鐘 (00..59)
.IP p
本地的 AM 或者 PM
.IP r
12小時格式的時間 (hh:mm:ss [AP]M)
.IP S
秒 (00..61)
.IP T
24小時格式的時間 (hh:mm:ss)
.IP X
本地的時間表示方法 (H:M:S)
.IP Z
時區(例如，EDT)，如果不能決定時區就是空
.PP
日期字段：
.IP a
本地一星期中每天的名稱的縮寫(Sun..Sat)
.IP A
本地一星期中每天的全名，可變長度 (Sunday..Saturday)
.IP b
本地每月的名稱的縮寫 (Jan..Dec)
.IP B
本地每月的全名，可變長度 (January..December)
.IP c
本地的日期和時間表示 (Sat Nov 04 12:02:33 EST 1989)
.IP d
一個月當中的日子 (01..31)
.IP D
日期 (mm/dd/yy)
.IP h
與 b 相同
.IP j
一年當中的日子 (001..366)
.IP m
月份 (01..12)
.IP U
以星期日作爲每週起始，一年當中的星期 (00..53)
.IP w
一星期當中的日子 (0..6)
.IP W
以星期一當作每週起始，一年當中的星期 (00..53)
.IP x
本地的日期表示 (mm/dd/yy)
.IP y
年份的最後兩位 (00..99)
.IP Y
年份 (1970...)
.RE
.IP %b
文件大小，以512字節的塊爲單位 (四捨五入)。
.IP %c
文件狀態最後一次修改的時間。格式是C函數 `ctime' 返回值的格式。
.IP %C\fIk\fP
文件狀態最後一次修改的時間。格式以 \fIk\fR 指定，類似於%A。
.IP %d
文件在目錄樹中的深度；0 意味着文件是一個命令行參數。
.IP %f
去掉了前面的目錄的文件名 (只剩下最後的成分)。
.IP %F
文件所在文件系統的類型；這個值可以爲 \-fstype 所用。
.IP %g
文件的組名，如果組沒有名稱就是數字形式的組ID。
.IP %G
文件的數字形式的組ID。
.IP %h
文件名的前面的目錄部分 (僅除去最後的成分)。
.IP %H
據以找到了文件的命令行參數。
.IP %i
文件的 i 結點號(16進制)。
.IP %k
文件大小，以1kB 的塊爲單位 (四捨五入)。
.IP %l
符號鏈接的目標 (如果文件不是一個符號鏈接，那麼結果是空字符串)。
.IP %m
文件的權限位 (8進制)。
.IP %n
文件的硬連接數。
.IP %p
文件名。
.IP %P
文件名，去掉了據以找到了文件的命令行參數的名稱部分。
.IP %s
文件大小，以字節爲單位。
.IP %t
文件最後一次修改的時間。格式是C函數 `ctime' 返回值的格式。
.IP %T\fIk\fP
文件最後一次修改的時間。格式以 \fIk\fR 指定，類似於%A。
.IP %u
文件的用戶名，如果用戶沒有名稱就是數字形式的用戶ID。
.IP %U
文件的數字形式的用戶ID。
.PP
在一個 `%' 字符後面使用任何其他字符，`%' 將被忽略 (但是其他字符會被打印出來)。
.RE
.IP \-prune
如果沒有給出 \-depth 則返回 true; 不進入當前目錄。
.br
如果給出了 \-depth 則返回false; 沒有效果。
.IP \-ls
返回true；以 `ls \-dils' 格式在標準輸出列出文件。塊以1kB 字節爲單位計數，除非設置了環境變量POSIXLY_CORRECT，那樣的話會使用 512字節的塊。
.SS 運算符 OPERATORS
.P
以優先級高低順序排列：
.IP "( \fIexpr\fR )"
強制爲優先
.IP "! \fIexpr\fR"
如果 \fIexpr\fR 是false則返回true
.IP "\-not \fIexpr\fR"
與 ! \fIexpr\fR 相同
.IP "\fIexpr1 expr2\fR"
與 (隱含的默認運算符)；如果 \fIexpr1\fR 爲false則不會執行 \fIexpr2\fR
.IP "\fIexpr1\fR \-a \fIexpr2\fR"
與 \fIexpr1 expr2\fR 相同
.IP "\fIexpr1\fR \-and \fIexpr2\fR"
與 \fIexpr1 expr2\fR 相同
.IP "\fIexpr1\fR \-o \fIexpr2\fR"
或；如果 \fIexpr1\fR 爲true 則不會執行 \fIexpr2\fR
.IP "\fIexpr1\fR \-or \fIexpr2\fR"
與 \fIexpr1\fR \-o \fIexpr2\fR 相同
.IP "\fIexpr1\fR , \fIexpr2\fR"
列表；\fIexpr1\fR 和 \fIexpr2\fR 都會被執行。\fIexpr1\fR 的值被忽略，列表的值是 \fIexpr2\fR的值
.SH "參見 SEE ALSO"
\fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBupdatedb\fP(1L), \fBxargs\fP(1L)
\fBFinding Files\fP (Info 在線幫助, 或者是打印的版本)

.SH "[中文版維護人]"
.B 袁乙鈞 <bbbush@163.com>
.SH "[中文版最新更新]"
.B 11/01/2003
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net 
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR