Manpages

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 中 。 如 果 运 行 findfile 不 存 在 , 那 么 它 将 被 创 建 。 如 果 它 存 在 , 它 将 被 覆 盖 。 文 件 名 ’’/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 expr2expr1 expr2 相 同
expr1
-and expr2expr1 expr2 相 同
expr1
-o expr2 或 ; 如 果 expr1 为 true 则 不 会 执 行 expr2
expr1
-or expr2expr1 -o expr2 相 同
expr1
, expr2 列 表 ; expr1expr2 都 会 被 执 行 。 expr1 的 值 被 忽 略 , 列 表 的 值 是 expr2的 值

参 见 SEE ALSO

locate(1L), locatedb(5L), updatedb(1L), xargs(1L) Finding Files (Info 在 线 帮 助 , 或 者 是 打 印 的 版 本 )

[中 文 版 维 护 人 ]

袁 乙 钧 <bbbush [AT] 163.com>

[中 文 版 最 新 更 新 ]

11/01/2003

《 中 国 linux论 坛 man手 册 页 翻 译 计 划 》 :

http://cmpp.linuxforum.net

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh