選項 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 型別的。型別可取值如下：

-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 和指令如下：

-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的值