Provided by: manpages-zh_1.6.4.0-1_all 
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
跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh
FIND(1)