Linux Manpages Online - man.cx manual pages

提要

ls [選項 ] [文件名 ...]

POSIX 標準選項 : [-CFRacdilqrtu1]

[-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 打印版本信息到標準輸出並順利退出。

-- 結束選項表。

Manpages

NAME

提要

GNU 選項 (短格式 ):

描述（ DESCRIPTION ）

GNU 細節

GNU 選項

GNU 標準選項

環境

已知錯誤

適合到

參見

注意

[中文版維護人 ]

[中文版最新更新 ]

《中國 linux論壇 man手冊翻譯計劃》 :

跋