Scroll to navigation

LS(1) ユーザーコマンド LS(1)

名前

ls - ディレクトリの内容をリスト表示する

書式

ls [オプション]... [ファイル]...

説明

FILE (デフォルトは現在のディレクトリ) に関する情報を一覧表示します。 -cftuvSUX のいずれも指定されず、 --sort も指定されていない場合、 要素はアルファベット順でソートされます。

長いオプションで必須となっている引数は短いオプションでも必須です。

. で始まる要素を無視しない
. および .. を一覧表示しない

--author -l と合わせて使用した時、各ファイルの作成者を表示する

表示不可能な文字の場合に C 形式のエスケープ文字を表示する
例えば '--block-size=M'。SIZE の書式の説明を参照
~ で終了する要素を一覧に表示しない
でソートし、 ctime を表示する。 -l と組み合わせた場合、名前で並べ替えて ctime を表示する。 それ以外の場合は ctime で新しい順に並べ替える
多段組で一覧を表示する
カラー出力をする。 WHEN には 'always' (デフォルト値)、 'never'、 'auto' が指定できる。詳細は下記を参照
ディレクトリの内容ではなくディレクトリ自身を一覧表示する。 また、シンボリックリンクも辿らない
Emacs の dired モード用の出力を生成する
ソートしない。 -aU が有効になり、 -ls --color が無効になる
タイプ識別子 (*/=>@| のうちの一つ) を付けて出力する
上と同様だが '*' を付与しない
WORD が across は -x, commas は -m, horizontal は -x, long は -l, single-column は -1, verbose は -l, vertical は -C と同じ

--full-time -l --time-style=full-iso と同様

-g -l と同様だがファイル所有者を表示しない

ファイルの前にディレクトリをグループ化して表示する。
--sort=none (-U) と併せたときはグループ化を行わない
詳細リスト形式の時にグループ名を表示しない
のような形式で表示する。
上と同様だが乗数の単位に 1024 の代わりに 1000 を使用する
コマンド行でリストされたシンボリックリンクを辿る
コマンド行のシンボリックリンクがディレクトリを指している 時にはシンボリックリンクを辿る
シェル形式の PATTERN に一致する要素は表示しない (-a または -A で上書きされる)
ハイパーリンク形式のファイル名; WHEN は `always` (WHEN 省略時のデフォルト), `auto'. `never' のいずれか
要素の名前に WORD で指定した形式の識別子を加える: none (デフォルト)、 slash (-p)、 file-type (--file-type)、 classify (-F)
各ファイルの i ノード番号を表示する
シェル形式の PATTERN に一致する要素は表示しない
ディスク使用量のブロックサイズとして 1024 バイトを使う; -s の場合のみ有効で、ディレクトリの合計サイズで使用
詳細リスト形式を表示する
シンボリックリンクのファイル情報を表示するときは リンクそのものではなくリンク参照先のファイル 情報を表示する
要素のリストをコンマで区切り、一行に詰め込む

-n, --numeric-uid-gid -l と同様だが UID と GID を数値で表示する

項目名をクォートせずに表示する

-o -l と同様だがグループ情報を表示しない

ディレクトリに対して識別子 / を加えて表示する
表示不可能な文字を ? に置き換える
表示不可能な文字をそのまま表示 (プログラムが 'ls' で なかったり、出力が端末以外の場合は、これがデフォルト動作になる)
ファイル名をダブルクォート (") で囲む
項目名のクォートを WORD で指定された形式で行う: literal, locale, shell, shell-always, c, escape
(QUOTING_STYLE 環境変数より優先される)
ソート順を反転させる
子ディレクトリを再帰的に一覧表示する
ブロック単位で各ファイルサイズを表示する
ファイルサイズ順にソートする。大きいものから表示される
名前順の代わりに次の WORD で指定した順でソートする: none (-U), size (-S), time (-t), version (-v), extension (-X)
デフォルトを更新時刻 (modification time) から変更する; アクセス時刻 (-u): atime, access, use; 変更時刻 (-c): ctime, status; 作成時刻: birth, creation;
--sort=time と使用した場合、 WORD でソートされる (新しい
ものから表示される)

--time-style=TIME_STYLE -l で使用する時刻/日付形式; 下記の TIME_STYLE 参照

時刻で新しい順にソートする; --time 参照
タブ幅を 8 の代わりに COLS にする
-l と使用した場合、名前でソートし、アクセス時間を表示する。 それ以外の場合、アクセス時間でソートする
ソートをしない。ディレクトリに含まれている要素順で表示する
自然な (バージョン) 数字順でソートする
出力幅を COLS にする。 0 は制限なしを意味する
要素を列優先ではなく行優先で配置する
拡張子のアルファベット順にソートする
各ファイルの SELinux セキュリティコンテキストを表示する
-1
1 ファイル 1 行で表示する
使い方を表示して終了する
バージョン情報を表示して終了する

SIZE 引数は整数で、追加で単位を指定できます (例えば 10M は 10*1024*1024 です)。 単位には K, M, G, T, P, E, Z, Y (1024 の累乗) や KB, MB, ... (1000 の累乗) が使用できます。 二進接頭辞も使用することもできます: KiB=K, MiB=M など。

TIME_STYLE 引数には full-iso, long-iso, iso, locale, +FORMAT の いずれかを指定できます。 FORMAT は date(1) と同様に解釈されます。 FORMAT が FORMAT1<newline>FORMAT2 の場合、 FORMAT1 は最近でない時間 のファイルに適用され、 FORMAT2 は最近の時間のファイルに適用されます。 TIME_STYLE の接頭辞として `posix-` をつけた場合、 POSIX ロケールで ない場合にのみ TIME_STYLE が効果を持ちます。 また、環境変数 TIME_STYLE でデフォルトで使用するスタイルを設定できます。

デフォルトまたは --color=never を指定した場合、ファイルの種類を判別するための カラー表示は無効となります。 --color=auto を指定した場合、標準出力が端末に接続 されている場合のみカラーコードを出力します。LS_COLORS 環境変数によって動作 を設定できます。LS_COLORS を設定する場合は dircolors を使用してください。

終了ステータス:

0
正常終了、
1
軽微な問題が発生 (例: 子ディレクトリにアクセスできない)、
2
重大な問題が発生 (例: コマンド引数が誤っている)。

GNU coreutils のオンラインヘルプ: <https://www.gnu.org/software/coreutils/> 翻訳に関するバグは <https://translationproject.org/team/ja.html> に連絡してください。 詳細な文書 <https://www.gnu.org/software/coreutils/ls> (ローカルでは info '(coreutils) ls invocation' で参照可能)。

作者

作者 Richard M. Stallman および David MacKenzie。

著作権

Copyright © 2020 Free Software Foundation, Inc. ライセンス GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

関連項目

ls の完全なマニュアルは Texinfo マニュアルとして整備されている。もし、 info および ls のプログラムが正しくインストールされているならば、コマンド

info ls

を使用すると完全なマニュアルを読むことができるはずだ。

2021年5月 GNU coreutils