Manpages

NAME

ls, dir, vdir - 列 目 录 内 容

提 要

ls [选 项 ] [文 件 名 ...]

POSIX 标 准 选 项 : [-CFRacdilqrtu1]

GNU 选 项 (短 格 式 ):

[-1abcdfgiklmnopqrstuxABCDFGLNQRSUX] [-w cols] [-T cols] [-I pattern] [--full-time] [--format={long,verbose,commas,across,vertical,single-column}] [--sort={none,time,size,extension}] [--time={atime,access,use,ctime,status}] [--color[={none,auto,always}]] [--help] [--version] [--]

描 述 （ DESCRIPTION ）

程 序 ls先 列 出 非 目 录 的 文 件 项 ， 然 后 是 每 一 个 目 录 中 的 “可 显 示 ”文 件 。 如 果 没 有 选 项 之 外 的 参 数 【 译 注 ： 即 文 件 名 部 分 为 空 】 出 现 ， 缺 省 为 "." （ 当 前 目 录 ） 。 选 项 “ -d ”使 得 目 录 与 非 目 录 项 同 样 对 待 。 除 非 “ -a ” 选 项 出 现 ， 文 件 名 以 “.”开 始 的 文 件 不 属 “可 显 示 ”文 件 。 以 当 前 目 录 为 准 ， 每 一 组 文 件 （ 包 括 非 目 录 文 件 项 ， 以 及 每 一 内 含 文 件 的 目 录 ） 分 别 按 文 件 名 比 较 顺 序 排 序 。 如 果 “ -l ”选 项 存 在 ， 每 组 文 件 前 显 示 一 摘 要 行 : 给 出 该 组 文 件 长 度 之 和 （ 以 512 字 节 为 单 位 ） 。 输 出 是 到 标 准 输 出 （ stdout ） 。 除 非 以 “ -C ”选 项 要 求 按 多 列 输 出 ， 输 出 将 是 一 行 一 个 。 然 而 ， 输 出 到 终 端 时 ， 单 列 输 出 或 多 列 输 出 是 不 确 定 的 。 可 以 分 别 用 选 项 “ -1 ” 或 “ -C ”来 强 制 按 单 列 或 多 列 输 出 。

-C 多 列 输 出 ， 纵 向 排 序 。

-F 每 个 目 录 名 加 “

/ ”后 缀 ， 每 个 FIFO 名 加 “ | ”后 缀 ， 每 个 可 运 行 名 加 “ * ”后 缀 。

-R 递 归 列 出 遇 到 的 子 目 录 。

-a 列 出 所 有 文 件 ， 包 括 以

"." 开 头 的 隐 含 文 件 。

-c 使 用 “状 态 改 变 时 间 ”代 替

“文 件 修 改 时 间 ”为 依 据 来 排 序 （ 使 用 “ -t ”选 项 时 ） 或 列 出 （ 使 用 “ -l ”选 项 时 ） 。
-d

将 目 录 名 象 其 它 文 件 一 样 列 出 ， 而 不 是 列 出 它 们 的 内 容 。

-i 输 出 文 件 前 先 输 出 文 件 系 列 号 （ 即

i 节 点 号 : i-node number） 。 -l 列

出 （ 以 单 列 格 式 ） 文 件 模 式 （ file mode ） ， 文 件 的 链 接 数 ， 所 有 者 名 ， 组 名 ， 文 件 大 小 （ 以 字 节 为 单 位 ） ， 时 间 信 息 ， 及 文 件 名 。 缺 省 时 ， 时 间 信 息 显 示 最 近 修 改 时 间 ； 可 以 以 选 项 “ -c ”和 “ -u ”选 择 显 示 其 它 两 种 时 间 信 息 。 对 于 设 备 文 件 ， 原 先 显 示 文 件 大 小 的 区 域 通 常 显 示 的 是 主 要 和 次 要 的 号 （ majorand minor device numbers） 。

-q 将 文 件 名 中 的 非 打 印 字 符 输 出 为 问 号 。 （ 对 于 到 终 端 的 输 出 这 是 缺 省 的 。 ）

-r 逆 序 排 列 。

-t 按 时 间 信 息 排 序 。

-u 使 用 最 近 访 问 时 间 代 替 最 近 修 改 时 间 为 依 据 来 排 序 （ 使 用 “

-t ”选 项 时 ） 或 列 出 （ 使 用 “ -l ”选 项 时 ） 。
-1 单 列 输 出 。

GNU 细 节

如 果 标 准 输 出 是 终 端 ， 将 多 列 输 出 （ 纵 向 排 序 ） 。

dir ( 也 被 安 装 为 命 令 d ) 等 同 于 “ ls -C ”； 即 ， 文 件 缺 省 是 多 列 输 出 ， 纵 向 排 序 。 vdir ( 也 被 安 装 为 命 令 v ) 等 同 于 “ ls -l ”； 即 ， 文 件 缺 省 是 按 长 格 式 输 出 。

GNU 选 项

-1, --format=single-column 一 行 输 出 一 个 文 件 （ 单 列 输 出 ） 。 如 标 准 输 出 不 是 到 终 端 ， 此 选 项 就 是 缺 省 选 项 。
-a, --all 列 出 目 录 中 所 有 文 件 ， 包 括 以 “.”开 头 的 文 件 。
-b, --escape 把 文 件 名 中 不 可 输 出 的 字 符 用 反 斜 杠 加 字 符 编 号 (就 象 在 C 语 言 里 一 样 )的 形 式 列 出 。
-c, --time=ctime, --time=status 按 文 件 状 态 改 变 时 间 （ i节 点 中 的 ctime） 排 序 并 输 出 目 录 内 容 。 如 采 用 长 格 式 输 出 （ 选 项 “-l”） ， 使 用 文 件 的 状 态 改 变 时 间 取 代 文 件 修 改 时 间 。 【 译 注 ： 所 谓 文 件 状 态 改 变 （ i节 点 中 以 ctime标 志 ） ， 既 包 括 文 件 被 修 改 ， 又 包 括 文 件 属 性 （ 如 所 有 者 、 组 、 链 接 数 等 等 ） 的 变 化 】
-d, --directory 将 目 录 名 象 其 它 文 件 一 样 列 出 ， 而 不 是 列 出 它 们 的 内 容 。

-f 不 排 序 目 录 内 容 ； 按 它 们 在 磁 盘 上 存 储 的 顺 序 列 出 。 同 时 启 动 “

-a ”选

项 ， 如 果 在 “ -f ”之 前 存 在 “ -l ”、 “ - -color ”或 “ -s ”， 则 禁 止 它 们 。

-g 忽 略 ， 为 兼 容 UNIX用 。
-i, --inode 在 每 个 文 件 左 边 打 印 i 节 点 号 （ 也 叫 文 件 序 列 号 和 索 引 号 : file serial number and index number） 。 i节 点 号 在 每 个 特 定 的 文 件 系 统 中 是 唯 一 的 。
-k, --kilobytes 如 列 出 文 件 大 小 ， 则 以 千 字 节 KB为 单 位 。
-l, --format=long, --format=verbose 除 每 个 文 件 名 外 ， 增 加 显 示 文 件 类 型 、 权 限 、 硬 链 接 数 、 所 有 者 名 、 组 名 、 大 小 （ byte ） 、 及 时 间 信 息 （ 如 未 指 明 是 其 它 时 间 即 指 修 改 时 间 ） 。 对 于 6个 月 以 上 的 文 件 或 超 出 未 来 1 小 时 的 文 件 ， 时 间 信 息 中 的 时 分 将 被 年 代 取 代 。 每 个 目 录 列 出 前 ， 有 一 行 “总 块 数 ”显 示 目 录 下 全 部 文 件 所 占 的 磁 盘 空 间 。 块 默 认 是 1024 字 节 ； 如 果 设 置 了 POSIXLY_CORRECT 的 环 境 变 量 ， 除 非 用 “ -k ”选 项 ， 则 默 认 块 大 小 是 512 字 节 。 每 一 个 硬 链 接 都 计 入 总 块 数 （ 因 此 可 能 重 复 计 数 ） ， 这 无 疑 是 个 缺 点 。 列 出 的 权 限 类 似 于 以 符 号 表 示 （ 文 件 ） 模 式 的 规 范 。 但 是
ls 在 每 套 权 限 的 第 三 个 字 符 中 结 合 了 多 位 （ multiple bits ） 的 信 息 ， 如 下 ： s 如 果 设 置 了 setuid 位 或 setgid 位 ， 而 且 也 设 置 了 相 应 的 可 执 行 位 。 S 如 果 设 置 了 setuid 位 或 setgid 位 ， 但 是 没 有 设 置 相 应 的 可 执 行 位 。 t 如 果 设 置 了 sticky 位 ， 而 且 也 设 置 了 相 应 的 可 执 行 位 。 T 如 果 设 置 了 sticky 位 ， 但 是 没 有 设 置 相 应 的 可 执 行 位 。 x 如 果 仅 仅 设 置 了 可 执 行 位 而 非 以 上 四 种 情 况 。 - 其 它 情 况 （ 即 可 执 行 位 未 设 置 ） 。
-m, --format=commas 水 平 列 出 文 件 ， 每 行 尽 可 能 多 ， 相 互 用 逗 号 和 一 个 空 格 分 隔 。
-n, --numeric-uid-gid 列 出 数 字 化 的 UID 和 GID 而 不 是 用 户 名 和 组 名 。

-o 以 长 格 式 列 出 目 录 内 容 ， 但 是 不 显 示 组 信 息 。 等 于 使 用 “

--format=long

--no-group ”选 项 。 提 供 此 选 项 是 为 了 与 其 它 版 本 的 ls 兼 容 。

-p 在 每 个 文 件 名 后 附 上 一 个 字 符 以 说 明 该 文 件 的 类 型 。 类 似 “

-F ”选 项 但 是

不 标 示 可 执 行 文 件 。

-q, --hide-control-chars 用 问 号 代 替 文 件 名 中 非 打 印 的 字 符 。 这 是 缺 省 选 项 。
-r, --reverse 逆 序 排 列 目 录 内 容 。
-s, --size 在 每 个 文 件 名 左 侧 输 出 该 文 件 的 大 小 ， 以 1024 字 节 的 块 为 单 位 。 如 果 设 置 了 POSIXLY_CORRECT 的 环 境 变 量 ， 除 非 用 “ -k ”选 项 ， 块 大 小 是 512 字 节 。
-t, --sort=time 按 文 件 最 近 修 改 时 间 （ i 节 点 中 的 mtime ） 而 不 是 按 文 件 名 字 典 序 排 序 ， 新 文 件 靠 前 。
-u, --time=atime, --time=access, --time=use 类 似 选 项 “ -t ”， 但 是 用 文 件 最 近 访 问 时 间 （ i 节 点 中 的 atime ） 取 代 文 件 修 改 时 间 。 如 果 使 用 长 格 式 列 出 ， 打 印 的 时 间 是 最 近 访 问 时 间 。
-w, --width cols 假 定 屏 幕 宽 度 是 cols （ cols 以 实 际 数 字 取 代 ） 列 。 如 未 用 此 选 项 ， 缺 省 值 是 这 样 获 得 的 ： 如 可 能 先 尝 试 取 自 终 端 驱 动 ， 否 则 尝 试 取 自 环 境 变 量 COLUMNS （ 如 果 设 置 了 的 话 ） ， 都 不 行 则 取 80 。
-x, --format=across, --format=horizontal 多 列 输 出 ， 横 向 排 序 。
-A, --almost-all 显 示 除 "." 和 ".." 外 的 所 有 文 件 。
-B, --ignore-backups 不 输 出 以 “ ~ ”结 尾 的 备 份 文 件 ， 除 非 已 经 在 命 令 行 中 给 出 。
-C, --format=vertical 多 列 输 出 ， 纵 向 排 序 。 当 标 准 输 出 是 终 端 时 这 是 缺 省 项 。 使 用 命 令 名 dir 和 d 时 ， 则 总 是 缺 省 的 。
-D, --dired 当 采 用 长 格 式 （ “ -l ”选 项 ） 输 出 时 ， 在 主 要 输 出 后 ， 额 外 打 印 一 行 ： //DIRED// BEG1 END1 BEG2 END2 ...
BEGn 和 ENDn 是 无 符 号 整 数 ， 记 录 每 个 文 件 名 的 起 始 、 结 束 位 置 在 输 出 中 的 位 置 （ 字 节 偏 移 量 ） 。 这 使 得 Emacs 易 于 找 到 文 件 名 ， 即 使 文 件 名 包 含 空 格 或 换 行 等 非 正 常 字 符 也 无 需 特 异 的 搜 索 。 如 果 目 录 是 递 归 列 出 的 （ “
-R ”选 项 ） ， 每 个 子 目 录 后 列 出 类 似 一 行 ：

//SUBDIRED// BEG1 END1 ... 【 译 注 ： 我 测 试 了 TurboLinux4.0 和 RedHat6.1 ， 发 现 它 们 都 是 在 “ //DIRED// BEG1... ”之 后 列 出 “ //SUBDIRED// BEG1 ... ”， 也 即 只 有 一 个 而 不 是 在 每 个 子 目 录 后 都 有 。 而 且 “ //SUBDIRED// BEG1 ... ”列 出 的 是 各 个 子 目 录 名 的 偏 移 。 】

-F, --classify, --file-type 在 每 个 文 件 名 后 附 上 一 个 字 符 以 说 明 该 文 件 的 类 型 。 “ * ”表 示 普 通 的 可 执 行 文 件 ； “ / ”表 示 目 录 ； “ @ ”表 示 符 号 链 接 ； “ | ”表 示 FIFOs； “ = ”表 示 套 接 字 (sockets) ； 什 么 也 没 有 则 表 示 普 通 文 件 。
-G, --no-group 以 长 格 式 列 目 录 时 不 显 示 组 信 息 。
-I, --ignorepattern 除 非 在 命 令 行 中 给 定 ， 不 要 列 出 匹 配 shell 文 件 名 匹 配 式 （ pattern ， 不 是 指 一 般 表 达 式 ） 的 文 件 。 在 shell 中 ， 文 件 名 以 "." 起 始 的 不 与 在 文 件 名 匹 配 式 (pattern) 开 头 的 通 配 符 匹 配 。
-L, --dereference 列 出 符 号 链 接 指 向 的 文 件 的 信 息 ， 而 不 是 符 号 链 接 本 身 。
-N, --literal 不 要 用 引 号 引 起 文 件 名 。
-Q, --quote-name 用 双 引 号 引 起 文 件 名 ， 非 打 印 字 符 以 C 语 言 的 方 法 表 示 。
-R, --recursive 递 归 列 出 全 部 目 录 的 内 容 。
-S, --sort=size 按 文 件 大 小 而 不 是 字 典 序 排 序 目 录 内 容 ， 大 文 件 靠 前 。
-T, --tabsize cols 假 定 每 个 制 表 符 宽 度 是 cols 。 缺 省 为 8。 为 求 效 率 ， ls 可 能 在 输 出 中 使 用 制 表 符 。 若 cols 为 0， 则 不 使 用 制 表 符 。
-U, --sort=none 不 排 序 目 录 内 容 ； 按 它 们 在 磁 盘 上 存 储 的 顺 序 列 出 。 （ 选 项 “ -U ”和 “ -f ”的 不 同 是 前 者 不 启 动 或 禁 止 相 关 的 选 项 。 ） 这 在 列 很 大 的 目 录 时 特 别 有 用 ， 因 为 不 加 排 序 能 显 著 的 加 快 速 度 。
-X, --sort=extension 按 文 件 扩 展 名 （ 由 最 后 的 "." 之 后 的 字 符 组 成 ） 的 字 典 序 排 序 。 没 有 扩 展 名 的 先 列 出 。
--color[=when] 指 定 是 否 使 用 颜 色 区 别 文 件 类 别 。 环 境 变 量 LS_COLORS 指 定 使 用 的 颜 色 。 如 何 设 置 这 个 变 量 见 dircolors(1) 。 when 可 以 被 省 略 ， 或 是 以 下 几 项 之 一 ：
none 不 使 用 颜 色 ， 这 是 缺 省 项 。

auto 仅 当 标 准 输 出 是 终 端 时 使 用 。 always 总 是 使 用 颜 色 。 指 定 --color 而 且 省 略 when 时 就 等 同 于 --color=always 。

--full-time 列 出 完 整 的 时 间 ， 而 不 是 使 用 标 准 的 缩 写 。 格 式 如 同 date(1) 的 缺 省 格 式 ； 此 格 式 是 不 能 改 变 的 ， 但 是 你 可 以 用 cut(1) 取 出 其 中 的 日 期 字 串 并 将 结 果 送 至 命 令 “ date -d ”。 输 出 的 时 间 包 括 秒 是 非 常 有 用 的 。 （
Unix 文 件 系 统 储 存 文 件 的 时 间 信 息 精 确 到 秒 ， 因 此 这 个 选 项 已 经 给 出 了 系 统 所 知 的 全 部 信 息 。 ） 例 如 ， 当 你 有 一 个 Makefile 文 件 不 能 恰 当 的 生 成 文 件 时 ， 这 个 选 项 会 提 供 帮 助 。

GNU 标 准 选 项

--help 打 印 用 法 信 息 到 标 准 输 出 并 顺 利 退 出 。

--version 打 印 版 本 信 息 到 标 准 输 出 并 顺 利 退 出 。

-- 结 束 选 项 表 。

环 境

变 量 POSIXLY_CORRECT 可 以 决 定 一 组 选 择 。 如 果 没 有 设 置 此 变 量 ， 每 个 制 表 符 的 字 符 数 由 变 量 TABSIZE 决 定 。 变 量 COLUMNS （ 当 它 由 一 个 十 进 制 整 数 表 示 时 ） 决 定 输 出 的 列 宽 度 （ 同 “ -C ”选 项 一 起 用 时 ） 。 文 件 名 不 得 为 适 应 多 列 输 出 而 被 截 断 。 变 量 LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES 及 LC_TIME 仍 保 持 原 义 。 变 量 TZ 给 出 时 区 供 ls 输 出 相 应 的 时 间 字 串 。 变 量 LS_COLORS 用 以 决 定 是 否 使 用 颜 色 。

已 知 错 误

在 BSD 系 统 上 ， 对 于 从 HP-UX 系 统 上 通 过 NFS mount 而 来 的 文 件 ， “ -s ”选 项 报 告 的 大 小 只 有 正 确 值 的 一 半 ； 在 HP-UX 系 统 上 ， 对 于 从 BSD 系 统 上 通 过 NFS mount 而 来 的 文 件 ， ls 报 告 的 大 小 则 有 正 确 值 的 两 倍 。 这 是 HP-UX 的 一 个 缺 陷 造 成 的 ， 它 也 影 响 HP-UX 上 的 ls 程 序 。

适 合 到

POSIX 1003.2

参 见

dircolors(1)

注 意

本 页 描 述 的 是 fileutils-3.16 文 件 包 中 的 ls ， 其 它 版 本 的 可 能 略 有 不 同 。 纠 错 或 添 加 （ 功 能 ） 请 mailto: aeb [AT] cwi.nl 和 aw [AT] mail1.fi 及 ragnar [AT] lightside.org 。 本 程 序 的 错 误 报 告 请 mailto: fileutils-bugs [AT] gnu.edu 。

[中 文 版 维 护 人 ]

wangdong <wangdong [AT] 163.net>

[中 文 版 最 新 更 新 ]

2003.11.22

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

http://cmpp.linuxforum.net

跋

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