.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