Aliases: oldfind(1), oldfind(1)
manpages-zh
Chinese manual pages
man-pages-zh_tw
Traditional Chinese Linux man pages
findutils
The GNU versions of find utilities (find and xargs)
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 | 不爲\(lq目錄中子目錄數量比硬連接數少2\(rq這種假設做優化。這個選項在搜索那些不遵 循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。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 返回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的值 |
參見 SEE ALSO
[中文版維護人]
袁乙鈞 <bbbush>
[中文版最新更新]
11/01/2003
《中國linux論壇man手冊頁翻譯計劃》:
http://cmpp.linuxforum.net
跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh
REFERENCED BY
dpkg-name(1), xargs(1), ippfind(1), fts(3), proc(5), hier(7), symlink(7), tar(1), xz(1), abicheck(1), aefind(1), cg(1), chase(1), gnome-search-tool(1), makeactive(8), jmtpfs(1), zip(1), , , , uudeview(1), locatedb(5), mate-search-tool(1), mkaf(1), pseudolog(1), rdfind(1), index++(1), tree(1), ftff(1), bfs(1), grep(1), scpio(1), STAR(1), mkhybrid(8), mkisofs(8), fd(1), samefile(1), fdfind(1), pycdlib-genisoimage(1), bosh(1), ustar(1)
