Provided by: manpages-ja_0.5.0.0.20110915-1_all bug

POSIX オプション
       -C     ファイルを複数列でリスト表示する。垂直方向にソートする。

       -F     ディレクトリ名の後に `/' を、FIFO の名前の後に `|' を、 実行可能
              なファイル名の後に `*' をそれぞれ付加する。

       -R     サブディレクトリがあれば、再帰的にリスト表示する。

       -a     `.' で始まる名前のファイルをリスト表示に含める。

       -c     ソート (-t) やリスト表示 (-l) のとき、  修正時刻ではなく状態変更
              時刻を使う。

       -d     ディレクトリの中身を表示せず、  他のファイルと同じようにディレク
              トリ名をリスト表示する。

       -i     ファイルのシリアル番号 (i-node 番号)  をファイル名の出力の前に置
              く。

       -l     ファイルのモード・リンクの数・所有者名・グループ名・ (バイト単位
              の) サイズ・タイムスタンプ・名前を (1  列形式で)  書き出す。  デ
              フォルトでは、表示されるタイムスタンプは最終修正時刻である。  オ
              プション -c と -u  のときは、他の  2  つのタイムスタンプを選択す
              る。  デバイススペシャルファイルの場合、通例として、サイズを表示
              する場所が    デバイスのメジャー番号とマイナー番号に置き換えられ
              る。

       -q     ファイル名の中の非表示文字をクエスチョンマークで出力する。 (端末
              への出力では、このオプションをデフォルトにすることが許されてい
              る。)

       -r     ソートの順序を逆にする。

       -t     表示されるタイムスタンプでソートする。

       -u     ソート  (-t) やリスト表示 (-l) のとき、 修正時刻ではなく最終アク
              セス時刻を使う。

       -1     出力を 1 列にする。

GNU 詳細
       標準出力が端末の場合、出力は (垂直方向にソートされて) 複数列になる。

       dir (d という名前でもインストールされる) は  `ls  -C'  と等しい。  つま
       り、デフォルトとして、 ファイルは垂直方向にソートされて複数列でリスト表
       示される。 vdir (v という名前でもインストールされる) は `ls -l'  と等し
       い。 つまり、デフォルトとして、ファイルは長い形式でリスト表示される。

GNU オプション
       -1, --format=single-column
              1 行に 1 ファイルをリスト表示する。 標準出力が端末でない場合のデ
              フォルトである。

       -a, --all
              `.' ではじまるファイルを含め、  ディレクトリ中のすべてのファイル
              をリスト表示する。

       -b, --escape, --quoting-style=escape
              ファイル名の中の非表示文字を表すため、    バックスラッシュとアル
              ファベットのシーケンスや バックスラッシュと 8 進数のシーケンスを
              用いる。 これらのシーケンスは C 言語で使われているものと同じであ
              る。

       -c     ディレクトリの内容をファイルの状態変更時刻 (inode の `ctime') で
              ソートする。  長いリスト表示形式が使われる  (-l オプションの) 場
              合、修正時刻ではなく状態変更時刻が表示される。

       -d, --directory
              ディレクトリの中身を表示せず、  他のファイルと同じようにディレク
              トリ名をリスト表示する。

       -f     ディレクトリの中身をソートせず、ディスク上にある順番にリスト表示
              する。  このオプションは  -a  も有効にする。  -f  より前に   -l,
              --color, -s が指定された場合、それらのオプションは無効になる。

       -g     無視される。Unix との互換性のためにある。

       -h, --human-readable
              それぞれのサイズについて、 例えばメガバイトなら M といったサイズ
              文字を付加する。 10 の累乗ではなく  2  の累乗を用いるので、M  は
              1,048,576  バイトを表す。 10 の累乗にしたいときは -H または --si
              オプションを使うこと。

       -i, --inode
              それぞれのファイルについて、ファイル名の左に inode 番号  (ファイ
              ルシリアル番号やインデックス番号とも呼ばれる) を表示する。 (この
              番号が、あるファイルシステム上のそれぞれファイルを  他と重ならな
              いように区別する。)

       -k, --kilobytes
              ファイルサイズがリスト表示される場合は、キロバイト単位で表示す
              る。

       -l, --format=long, --format=verbose
              ファイル名に加えて、ファイルタイプ・アクセス権・ハードリンクの
              数・    所有者名・グループ名・バイト単位のサイズ・タイムスタンプ
              (他の時刻が選択されなければ、修正時刻) を表示する。 ファイルの時
              刻が  6 カ月以上前または 1 時間以上先の場合、 タイムスタンプには
              時刻のかわりに年が入る。

              リスト表示される各ディレクトリについて、ファイル表示の前に
              `total  blocks' という行を置く。ここで、 blocks はディレクトリ内
              の全てのファイルによって使用されるディスク容量の合計である。  デ
              フォルトでは  1024 バイトブロックが用いられるが、 この値は上書き
              することができる。 計算された blocks  では、それぞれのハードリン
              クが別個に数えられている。 これはバグだという議論もある。

              リスト表示されるアクセス権はシンボルモードの仕様と同じであるが、
              ls は複数のビットを各アクセス権のセットの 3 文字目に組み入れてい
              る。

              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, --file-type, --indicator-style=file-type
              ファイルタイプを示す文字を各ファイル名に加える。  -F  と似ている
              が、実行可能ファイルにはマークしない。

       -q, --hide-control-chars
              ファイル名の中の非表示文字の代わりにクエスチョンマークを表示す
              る。 出力が端末、プログラムが ls の場合のデフォルトである。

       -r, --reverse
              ディレクトリの中身を逆順にソートする。

       -s, --size
              それぞれのファイルのディスク割り当て量をファイル名の左に表示す
              る。 これはファイルによって使用されるディスクの総量である。 この
              大きさは普通はファイルのサイズよりいくらか大きいが、  ファイルが
              ホール (穴) を持っている場合は小さくなることもある。

              各ファイルの割り当て量は 1024 バイトブロック単位でファイル名の左
              に表示される。  しかし、このブロックサイズは上書きされるかもしれ
              ない。

       -t, --sort=time
              アルファベット順ではなく修正時刻  (inode  の `mtime') でソートす
              る。 最も新しいファイルが最初にくる。

       -u     修正時刻ではなく最終アクセス時刻 (inode の `atime') で  ディレク
              トリの中身をソートする。 長いリスト表示形式が使われる場合、 修正
              時刻ではなく最終アクセス時刻が表示される。

       -v, --sort=version
              バージョン名とバージョン番号でソートする。  バージョンの一番低い
              ものが最初にくる。 デフォルトのソートのように動作するが、10 進の
              数字のシーケンスは、  インデックス番号またはバージョン番号として
              数値的に扱われる。 ゼロを前にもつ数値部分は小数として扱われる。

                 ls -1           ls -1v
                 bar-1.gz        bar-1.gz
                 bar-100.gz      bar-2.gz
                 bar-12.gz       bar-12.gz
                 bar-2.gz        bar-100.gz
                 foo-1.007.gz    foo-1.007.gz
                 foo-1.012b.gz   foo-1.01a.gz
                 foo-1.01a.gz    foo-1.012b.gz

       -w, --width cols
              スクリーンの幅を  cols 文字と仮定する。 可能ならばターミナルドラ
              イバからデフォルトの値を採用する。  それが不可能な場合には、環境
              変数 COLUMNS が設定されていればその値を使う。 設定されていない場
              合のデフォルトは 80 文字である。

       -x, --format=across, --format=horizontal
              ファイルを複数列でリスト表示する。水平方向にソートする。

       -A, --almost-all
              ディレクトリ内の `.' と `..'  以外のすべてのファイルをリスト表示
              する。

       -B, --ignore-backups
              コマンドラインで指定した場合を除いて、`~' で終わるファイルをリス
              ト表示しない。

       -C, --format=vertical
              ファイルを複数列でリスト表示する。垂直方向にソートする。  標準出
              力が端末のときのデフォルトである。 dird ではこのオプションが
              常にデフォルトになっている。  最も少ない行でなるべく多くのファイ
              ルを表示するため GNU ls は可変幅の列を使う。

       -D, --dired
              長いリスト表示 (-l) と一緒に使われた場合、メインの出力の後に以下
              のような追加の行を表示する:

                 //DIRED//
                 BEG1 END1 BEG2 END2 ...

              BEGnENDn は符号なし整数で、リスト出力における 各ファイル名の
              始めと終わりのバイト位置を記録したものである。  このオプションを
              使うと、  ファイル名にスペースや改行といった普段使わない文字が含
              まれている場合でも、  Emacs でファイル名を探すのが (ファンシー検
              索 (fancy searching) を使わ なくても) 簡単になる。

              ディレクトリが再帰的にリスト表示される  (-R   オプションの)   場
              合、各サブディレクトリの後に以下ような行を出力する:

                 //SUBDIRED//
                 BEG1 END1 ...

              最後に、以下のような行を出力する。

                 //DIRED-OPTIONS// --quoting-style=WORD

              ここで WORD はクォートのスタイルである。

       -F, --classify
              --indicator-style=classify と同じ。

       -G, --no-group
              長い形式でのディレクトリのリスト表示の場合に、グループ情報の表示
              をさせない。

       -H, --si
              それぞれのサイズについて、 例えばメガバイトなら M といったサイズ
              文字を付加する (SIとは国際単位系のことで、これらの文字を接頭辞と
              定義している)。 2 の累乗ではなく 10  の累乗を用いるので、  M  は
              1,000,000   バイトを表す。   2  の累乗にしたいときは  -h  または
              --human-readable オプションを使うこと。

       -I, --ignore=pattern
              コマンドラインで与えられない限り、    シェルパターン     pattern
              (注:正規表現とは異なる)  にマッチする名前のファイルはリスト表示
              しない。 シェルと同様に、ファイル名の先頭にある `.'  は  pattern
              の始めにあるワイルドカードにはマッチしない。 たとえば、

              lightside:~% ls --ignore='.??*' --ignore='.[^.]' \
                 --ignore='#*'

              では、  1 つ目のオプションが `.' で始まる 3 文字以上の長さの名前
              を リストから除外する。 また、2 つ目のオプションが  `..'  以外の
              `.' で始まる 2 文字の名前を除外する。 さらに、3 つ目のオプション
              が `#' で始まる名前をリストから除外する。

       -L, --dereference
              シンボリックリンクそのものではなく、  参照しているファイルの情報
              をリスト表示する。

       -N, --literal
              ファイル名中の非表示文字の変換を行わない。

       -Q, --quote-name, --quoting-style=c
              ファイル名をダブルクォートで囲む。 さらに、非表示文字を C 言語で
              使われている形式に変換して表示する。

       -R, --recursive
              すべてのディレクトリの中身を再帰的にリスト表示する。

       -S, --sort=size
              アルファベット順でなく、ファイルサイズでディレクトリの中身をソー
              トする。 最も大きいファイルが最初に表示される。

       -T, --tabsize cols
              タブストップの幅を  cols  文字分と仮定する。デフォルトは  8 文字
              分。  ls  は効率をよくするために出力中の可能な場所でタブを使う。
              cols がゼロの場合、タブをまったく使わない。

       -U, --sort=none
              ディレクトリの中身をソートせず、ディスク上にある順番にリスト表示
              する (-U-f の違いは、-f オプションが他のオプションを  有効に
              したり無効にしたりする点にある)。 非常に大きなディレクトリをリス
              ト表示する場合、 このオプションは特に有用である。 なぜなら、ソー
              トをしないことにより著しく速くできるからである。

       -X, --sort=extension
              ディレクトリの中身をファイル拡張子  (最後の `.' の後につづく文字
              列) の アルファベット順にソートする。 拡張子のないファイルは最初
              にソートされる。

       --block-size=SIZE
              環境変数の値を上書きして、ブロックサイズを SIZE に設定する。

       --color[=when]
              ファイルタイプを区別するための色づけの有無を指定する。  色は環境
              変数 LS_COLORS を用いて指定される。 この変数の設定法についての情
              報は  dircolors(1) を参照すること。 when は省略できる。 以下のい
              ずれか 1 つを指定することもできる:

              none   まったく色づけしない。これがデフォルトである。

              auto   標準出力が端末の場合のみ色づけする。

              always 常に色づけする。 --color を指定して when に何にも指定しな
                     いのは --color=always と等しい。

       --full-time
              時刻に関する情報を標準の省略形式ではなく完全な形式でリスト表示す
              る。 時刻の表示形式は date(1) のデフォルトと同じ。この形式は変更
              できないが、  時刻の文字列を cut(1) で取り出し、結果を `date -d'
              に渡すことができる。

              時刻の出力に秒単位の情報を含んでいるので、このオプションはとても
              有用である。 (Unix ファイルシステムは、 四捨五入した秒単位までの
              タイムスタンプしか持たないので、  このオプションはタイムスタンプ
              にあるすべての情報を表示する。)  例えば、Makefile でファイルを正
              しく再生成してくれない場合に このオプションが役立つ。

       --indicator-style=WORD
              各ファイル名にファイルタイプを示す文字を付加する。  付加される文
              字は WORD に依存する:

              none   ファイルタイプを示す文字を付加しない。これがデフォルトの
                     動作である。

              file-type
                     ディレクトリに `/' を、シンボリックリンクに `@' を、 FIFO
                     に `|' を、ソケットに `=' を付加する。 通常のファイルには
                     何もつけない。 -p--file-type に等しい。

              classify
                     file-type と同じであるが、 さらに実行可能ファイルには `*'
                     をつける。 -F--classify に等しい。

       --quoting-style=WORD
              出力されるファイル名をクォートするために、 WORD で指示されるスタ
              イルを使用する。 WORD は次のいずれかでなければならない:

              literal
                     ファイル名をそのまま出力する。これがデフォルトの動作であ
                     るが、  将来のバージョンでは shell がデフォルトになるかも
                     しれない。

              shell  ファイル名がシェルのメタキャラクタを含む場合や、 シェルに
                     よくわからない出力を引き起こさせるかもしれない場合には、
                     ファイル名をクォートする。

              shell-always
                     通常はクォートを必要としないファイル名に対しても、クォー
                     トを行う。

              c      C 言語における文字列の形式でファイル名をクォートする。 -Q--quote-name に等しい。

              escape c  と同じであるが、ファイル名を囲むダブルクォート文字を省
                     略する。 -b--escape に等しい。

              locale c  形式と似ているが、  "このように"  適切なロケール固有の
                     クォートシンボルを使う。

              clocale
                     c  形式と似ているが、  `このように'  適切なロケール固有の
                     クォートシンボルを使う。

              --quoting-style       オプションのデフォルトの値は      環境変数
              QUOTING_STYLE で指定することができる。

       --show-control-chars
              ファイル名の中の非表示文字をそのまま出力する。  出力が端末でない
              か、プログラムが ls でない場合はデフォルトである。

       --time=atime, --time=access
              --sort=time  または -t と一緒に使われると、 -u (atime でソートす
              る) と等しくなる。  普通に時刻を表示するオプションと一緒に使われ
              ると、  各ファイルの最終修正時刻ではなく最終アクセス時刻を表示す
              る。

       --time=ctime, --time=status, --time=use
              --sort=time または -t と一緒に使われると、 -c (ctime  でソートす
              る)  と等しくなる。 普通に時刻を表示するオプションと一緒に使われ
              ると、 各ファイルの最終修正時刻ではなく inode の最終変更時刻を表
              示する。

GNU 標準オプション
       --help 標準出力に使用方法のメッセージを出力して正常終了する。

       --version
              標準出力にバージョン情報を出力して正常終了する。

       --     オプションリストの終りを示す。

ブロックサイズ
       デフォルトの出力ファイルブロックサイズは  1024  バイト (POSIXLY_CORRECT
       が設定されているときは 512 バイト) である。  この値は以下の環境変数のど
       れかを設定することで変更できる。           また、これらの環境変数の値は
       --block-size=SIZE が オプションに与えられると無視される。

       優先順位:
              LS_BLOCK_SIZE, BLOCK_SIZE, POSIXLY_CORRECT.

       これらの変数の値は、数字でも human-readable でも si でもよい。 数字の後
       には、何倍であるかを指定するサイズ文字と、  通常のバイトを選択する B ま
       たは  10  進の「商業用」バイトを選択する  D   を続けてもよい。   たとえ
       ば、`BLOCK_SIZE=1KB'  は  `BLOCK_SIZE=1024' に等しく、 `BLOCK_SIZE=1KD'
       は `BLOCK_SIZE=1000' に等しい。

       以下の文字が認識される (また --human-readable--si  オプションで表示
       されるときに用いられる)

       k      キロ: --human-readable なら 2^10 = 1024、 --si なら 10^3 = 1000

       M      メガ: 2^20 = 1,048,576 または 10^6 = 1,000,000

       G      ギガ: 2^30 = 1,073,741,824 または 10^9 = 1,000,000,000

       T      テラ: 2^40 = 1,099,511,627,776 または 10^12 = 1,000,000,000,000

       P      ペタ:    2^50    =    1,125,899,906,842,624   または   10^15   =
              1,000,000,000,000,000

       E      エクサ:  2^60  =  1,152,921,504,606,846,976   または   10^18   =
              1,000,000,000,000,000,000

       Z      ゼタ:   2^70  =  1,180,591,620,717,411,303,424  または  10^21  =
              1,000,000,000,000,000,000,000

       Y      ヨタ: 2^80 = 1,208,925,819,614,629,174,706,176  または  10^24  =
              1,000,000,000,000,000,000,000,000

環境変数
       変数 LS_BLOCK_SIZE, BLOCK_SIZE, POSIXLY_CORRECT は 出力ファイルブロック
       サイズの選択を決定する。 変数 COLUMNS は (10 進の整数表現を含んでいる場
       合)、 (-C オプションで使われる) 出力の列の幅を決定する。 ファイル名は複
       数列での出力にあわせるために短くされたりはしない。  変数  QUOTING_STYLE
       は出力のクォートのスタイルを決定する。  変数 LS_COLORS は使用される色を
       指定するために使われる。  変数  LANG,  LC_ALL,  LC_COLLATE,   LC_CTYPE,
       LC_MESSAGES,  LC_TIME が通常の意味を持つ。 変数 TZ は ls によって書き出
       される時刻の文字列のためのタイムゾーンを与える。

バグ
       BSD システムでは、HP-UX システムから NFS マウントしたファイルに対して、
       -s  オプションでは正しい値の半分の値を表示してしまう。 HP-UX システムで
       は、BSD システムから NFS マウントしたファイルに対して、 ls は正しい値の
       2 倍の値を表示してしまう。 これは HP-UX の欠陥によるもので、HP-UX の ls
       プログラムにも影響を及ぼしている。

準拠
       POSIX 1003.2

関連項目
       dircolors(1)

注意
       このページは fileutils-4.1 パッケージの ls コマンドについて説明したもの
       である; その他のバージョンでは少し違いがあるかもしれない。 修正や追加は
       aeb@cwi.nl, aw@mail1.bet1.puv.fi, ragnar@ragnar-hojland.com  宛にメール
       で連絡してください。  プログラムのバグについては  bug-fileutils@gnu.org
       へ報告してください。