Provided by:
manpages-ja_0.5.0.0.20080615-1_all 
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
ファイルを複数列でリスト表示する。垂直方向にソートする。
標準出力が端末のとい離妊侫ルトである。 dir と d
ではこのオプションが常にデフォルトになっている。
最も少ない行でなるべく多くのファイルを表示するため GNU ls
は可変幅の列を使う。
-D, --dired
長いリスト表示 (-l)
と一緒に使われた場合、メインの出力の後に以下のような追加の行を表示する：
//DIRED//
BEG1 END1 BEG2 END2 ...
BEGn と ENDn は符号なし整数で、リスト出力における
各ファイル名の始めと終わりのバイト位置を杵燭靴燭發里任△襦
このオプションを使うと、
ファイル名にスペースや改行といった普段使わない文字が含まれている場合でも、
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 へ報告してください。