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.nlaw [AT] mail1.firagnar [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

COMMENTS