File: ls.1

package info (click to toggle)
manpages-ja 0.5.0.0.20210215%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 28,568 kB
  • sloc: perl: 161; makefile: 58
file content (656 lines) | stat: -rw-r--r-- 26,710 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
.\" Copyright Andries Brouwer, A. Wik 1998, Ragnar Hojland Espinosa 1998-2002
.\"
.\" This file may be copied under the conditions described
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
.\" that should have been distributed together with this file.
.\"
.\" Japanese Version Copyright (c) 1999-2003 Yuichi SATO
.\"         all rights reserved.                                               
.\" Translated Wed Nov  3 15:25:24 JST 1999
.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\" Updated & Modified Sun Mar  2 14:47:25 JST 2003
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.\"WORD:	allocation	割り当て
.\"WORD:	permission	アクセス権
.\"WORD:	fancy searching	ファンシー検索
.\"WORD:	sequence	シーケンス
.\"
.TH LS 1 "18 June 2002" "GNU fileutils 4.1"
.SH 名前
ls, dir, vdir \- ディレクトリの中身をリスト表示する
.SH 書式
.BI "ls [" options "] [" file... ]
.sp
POSIX オプション:
.BI "[\-CFRacdilqrtu1]"
.sp
GNU オプション (簡略形式):
.B [\-1abcdfghiklmnopqrstuvxABCDFGHLNQRSUX]
.BI "[\-w " cols ]
.BI "[\-T " cols ]
.BI "[\-I " pattern ]
.B [\-\-block\-size=\fISIZE\fR]
.B [\-\-classify]
.B [\-\-color[={none,always,auto}]]
.B [\-\-file\-type]
.B [\-\-full\-time]
.B [\-\-format={across,commas,long,single-column,verbose,vertical}]
.B [\-\-human\-readable]
.B [\-\-indicator\-style={none,file-type,classify}]
.B [\-\-quoting\-style={c,clocale,escape,literal,locale,shell,shell\-always}]
.B [\-\-show\-control\-chars]
.B [\-\-si]
.B [\-\-sort={none,extension,size,time,version}]
.B [\-\-time={atime,access,ctime,status,use}]
.B "[\-\-help] [\-\-version] [\-\-]"
.SH 説明
プログラム
.B ls
は、最初にディレクトリでない引き数
.I file
をリスト表示する。それから、ディレクトリである引き数について、
それぞれのディレクトリにあるリスト表示可能なすべてのファイルを表示する。
オプション以外の引き数が何もない場合、デフォルトの引き数として `.'
(現在のディレクトリ) を仮定する。
\-d オプションは、ディレクトリを
ディレクトリでない引き数として扱わせるようにする。
ファイル名が `.' で始まっていなければ、そのファイルは表示される。
`.' で始まる名前のファイルでも、\-a オプションが指定されていれば表示される。
.PP
それぞれのファイルリスト
(ディレクトリでないファイルのリストと
各ディレクトリ内のファイルのリスト) は、
現在のロケールにおける文字の順序に従って個別にソートされる。
\-l オプションが指定された場合、
リスト中の全ファイルの合計サイズを表示する要約行が
各リストの前に付加される。
このサイズは選択されているブロックサイズを単位とする数値になる。
.PP
出力は標準出力に対して行われ、
\-C オプションで複数列出力が要求されない限り、1 行に 1 エントリである。
しかし、端末に対する出力では、出力が 1 列または複数列の
どちらになるかが定められていない。
オプション \-1 と \-C は、
それぞれ 1 列出力と複数列出力を強制させるために使用される。
.SH POSIX オプション
.TP
.B "\-C"
ファイルを複数列でリスト表示する。垂直方向にソートする。
.TP
.B "\-F"
ディレクトリ名の後に `/' を、FIFO の名前の後に `|' を、
実行可能なファイル名の後に `*' をそれぞれ付加する。
.TP
.B "\-R"
サブディレクトリがあれば、再帰的にリスト表示する。
.TP
.B "\-a"
`.' で始まる名前のファイルをリスト表示に含める。
.TP
.B "\-c"
ソート (\-t) やリスト表示 (\-l) のとき、
修正時刻ではなく状態変更時刻を使う。
.TP
.B "\-d"
ディレクトリの中身を表示せず、
他のファイルと同じようにディレクトリ名をリスト表示する。
.TP
.B "\-i"
ファイルのシリアル番号 (i-node 番号) をファイル名の出力の前に置く。
.TP
.B "\-l"
ファイルのモード・リンクの数・所有者名・グループ名・
(バイト単位の) サイズ・タイムスタンプ・名前を (1 列形式で) 書き出す。
デフォルトでは、表示されるタイムスタンプは最終修正時刻である。
オプション \-c と \-u のときは、他の 2 つのタイムスタンプを選択する。
デバイススペシャルファイルの場合、通例として、サイズを表示する場所が
デバイスのメジャー番号とマイナー番号に置き換えられる。
.TP
.B "\-q"
ファイル名の中の非表示文字をクエスチョンマークで出力する。
(端末への出力では、このオプションをデフォルトにすることが許されている。)
.TP
.B "\-r"
ソートの順序を逆にする。
.TP
.B "\-t"
表示されるタイムスタンプでソートする。
.TP
.B "\-u"
ソート (\-t) やリスト表示 (\-l) のとき、
修正時刻ではなく最終アクセス時刻を使う。
.TP
.B "\-1"
出力を 1 列にする。
.SH GNU 詳細
標準出力が端末の場合、出力は (垂直方向にソートされて) 複数列になる。
.PP
.B dir
.RB "(" d
という名前でもインストールされる) は `ls \-C' と等しい。
つまり、デフォルトとして、
ファイルは垂直方向にソートされて複数列でリスト表示される。
.B vdir
.RB "(" v
という名前でもインストールされる) は `ls \-l' と等しい。
つまり、デフォルトとして、ファイルは長い形式でリスト表示される。
.SH GNU オプション
.TP
.B "\-1, \-\-format=single-column"
1 行に 1 ファイルをリスト表示する。
標準出力が端末でない場合のデフォルトである。
.TP
.B "\-a, \-\-all"
`.' ではじまるファイルを含め、
ディレクトリ中のすべてのファイルをリスト表示する。
.TP
.B "\-b, \-\-escape, \-\-quoting\-style=escape"
ファイル名の中の非表示文字を表すため、
バックスラッシュとアルファベットのシーケンスや
バックスラッシュと 8 進数のシーケンスを用いる。
これらのシーケンスは C 言語で使われているものと同じである。
.TP
.B \-c
ディレクトリの内容をファイルの状態変更時刻
(inode の `ctime') でソートする。
長いリスト表示形式が使われる
.RB "(" \-l
オプションの) 場合、修正時刻ではなく状態変更時刻が表示される。
.TP
.B "\-d, \-\-directory"
ディレクトリの中身を表示せず、
他のファイルと同じようにディレクトリ名をリスト表示する。
.TP
.B "\-f"
ディレクトリの中身をソートせず、ディスク上にある順番にリスト表示する。
このオプションは
.B \-a
も有効にする。
.B \-f 
より前に
.BR \-l ,
.BR \-\-color ,
.B \-s
が指定された場合、それらのオプションは無効になる。
.TP
.B \-g
無視される。Unix との互換性のためにある。
.TP
.B \-h, \-\-human\-readable
それぞれのサイズについて、
例えばメガバイトなら \fBM\fR といったサイズ文字を付加する。
10 の累乗ではなく 2 の累乗を用いるので、\fBM\fR は 1,048,576 バイトを表す。
10 の累乗にしたいときは \fB\-H\fR または \fB\-\-si\fR オプションを使うこと。
.TP
.B "\-i, \-\-inode"
それぞれのファイルについて、ファイル名の左に inode 番号
(ファイルシリアル番号やインデックス番号とも呼ばれる) を表示する。
(この番号が、あるファイルシステム上のそれぞれファイルを
他と重ならないように区別する。)
.TP
.B "\-k, \-\-kilobytes"
ファイルサイズがリスト表示される場合は、キロバイト単位で表示する。
.TP
.B "\-l, \-\-format=long, \-\-format=verbose"
ファイル名に加えて、ファイルタイプ・アクセス権・ハードリンクの数・
所有者名・グループ名・バイト単位のサイズ・タイムスタンプ
(他の時刻が選択されなければ、修正時刻) を表示する。
ファイルの時刻が 6 カ月以上前または 1 時間以上先の場合、
タイムスタンプには時刻のかわりに年が入る。

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

リスト表示されるアクセス権はシンボルモードの仕様と同じであるが、
.B ls
は複数のビットを各アクセス権のセットの 3 文字目に組み入れている。
.RS
.TP
.B s
setuid ビットまたは setgid ビットが設定されていて、
さらに対応する実行ビットが設定されている場合。
.TP
.B S
setuid ビットまたは setgid ビットが設定されているが、
対応する実行ビットが設定されていない場合。
.TP
.B t
sticky ビットとその他のユーザーに対する実行ビットがともに設定されている場合。
.TP
.B T
sticky ビットは設定されているが、
その他のユーザーに対する実行ビットが設定されていない場合。
.TP
.B x
実行ビットは設定されているが、上のどれも適用されていない場合。
.TP
.B -
その他。
.RE     
.TP
.B "\-m, \-\-format=commas"
ファイル名をコンマとスペースで区切って、
それぞれの行にできるだけ多く詰め込み、横にリスト表示する。
.TP
.B "\-n, \-\-numeric-uid-gid"
所有者のユーザ名・グループ名のかわりに数字の UID と GID をリスト表示する。
.TP
.B \-o
長い形式でのディレクトリのリスト表示をするが、グループ情報は表示しない。
.B "\-\-format=long \-\-no-group"
を用いるのと同じである。
このオプションは他のバージョンの
.B ls
との互換性のために提供された。
.TP
.B \-p, \-\-file\-type, \-\-indicator\-style=file\-type
ファイルタイプを示す文字を各ファイル名に加える。
.B \-F
と似ているが、実行可能ファイルにはマークしない。
.TP
.B "\-q, \-\-hide-control-chars"
ファイル名の中の非表示文字の代わりにクエスチョンマークを表示する。
出力が端末、プログラムが \fBls\fR の場合のデフォルトである。
.TP
.B "\-r, \-\-reverse"
ディレクトリの中身を逆順にソートする。
.TP
.B "\-s, \-\-size"
それぞれのファイルのディスク割り当て量をファイル名の左に表示する。
これはファイルによって使用されるディスクの総量である。
この大きさは普通はファイルのサイズよりいくらか大きいが、
ファイルがホール (穴) を持っている場合は小さくなることもある。

各ファイルの割り当て量は 1024 バイトブロック単位でファイル名の左に表示される。
しかし、このブロックサイズは上書きされるかもしれない。
.TP
.B "\-t, \-\-sort=time"
アルファベット順ではなく修正時刻 (inode の `mtime') でソートする。
最も新しいファイルが最初にくる。
.TP
.B \-u
修正時刻ではなく最終アクセス時刻 (inode の `atime') で
ディレクトリの中身をソートする。
長いリスト表示形式が使われる場合、
修正時刻ではなく最終アクセス時刻が表示される。
.TP
.B \-v, \-\-sort=version
バージョン名とバージョン番号でソートする。
バージョンの一番低いものが最初にくる。
デフォルトのソートのように動作するが、10 進の数字のシーケンスは、
インデックス番号またはバージョン番号として数値的に扱われる。
ゼロを前にもつ数値部分は小数として扱われる。
.sp
.nf
.B "   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
.fi
.sp
.TP
.BI "\-w, \-\-width " cols
スクリーンの幅を
.I cols
文字と仮定する。
可能ならばターミナルドライバからデフォルトの値を採用する。
それが不可能な場合には、環境変数
.B COLUMNS
が設定されていればその値を使う。
設定されていない場合のデフォルトは 80 文字である。
.TP
.B "\-x, \-\-format=across, \-\-format=horizontal"
ファイルを複数列でリスト表示する。水平方向にソートする。
.TP
.B "\-A, \-\-almost\-all"
ディレクトリ内の `.' と `..' 以外のすべてのファイルをリスト表示する。
.TP
.B "\-B, \-\-ignore\-backups"
コマンドラインで指定した場合を除いて、`~' で終わるファイルをリスト表示しない。
.TP
.B "\-C, \-\-format=vertical"
ファイルを複数列でリスト表示する。垂直方向にソートする。
標準出力が端末のときのデフォルトである。
.BR dir " と " d 
ではこのオプションが常にデフォルトになっている。
最も少ない行でなるべく多くのファイルを表示するため
GNU \fBls\fR は可変幅の列を使う。
.TP
.B "\-D, \-\-dired"
長いリスト表示
.RB ( \-l  )
と一緒に使われた場合、メインの出力の後に以下のような追加の行を表示する:
.sp
.nf
.B "   //DIRED//"
.I "   BEG1 END1 BEG2 END2 ..."
.fi
.sp
.IR BEGn " と " ENDn
は符号なし整数で、リスト出力における
各ファイル名の始めと終わりのバイト位置を記録したものである。
このオプションを使うと、
ファイル名にスペースや改行といった普段使わない文字が含まれている場合でも、
Emacs でファイル名を探すのが (ファンシー検索 (fancy searching) を使わ
なくても) 簡単になる。

ディレクトリが再帰的にリスト表示される
.RB ( \-R
オプションの) 場合、各サブディレクトリの後に以下ような行を出力する:
.sp
.nf
.B "   //SUBDIRED//"
.I "   BEG1 END1 ..."
.fi
.sp
最後に、以下のような行を出力する。
.sp
.nf
.B "   //DIRED-OPTIONS// \-\-quoting-style=\fIWORD\fR"
.fi
.sp
ここで \fIWORD\fR はクォートのスタイルである。
.TP
.B "\-F, \-\-classify
\fB\-\-indicator\-style=classify\fR と同じ。
.TP
.B "\-G, \-\-no\-group"
長い形式でのディレクトリのリスト表示の場合に、グループ情報の表示をさせない。
.TP
.B \-H, \-\-si
それぞれのサイズについて、
例えばメガバイトなら \fBM\fR といったサイズ文字を付加する
(SIとは国際単位系のことで、これらの文字を接頭辞と定義している)。
2 の累乗ではなく 10 の累乗を用いるので、
\fBM\fR は 1,000,000 バイトを表す。
2 の累乗にしたいときは \fB\-h\fR または
\fB\-\-human\-readable\fR オプションを使うこと。
.TP
.BI "\-I, \-\-ignore=" pattern
コマンドラインで与えられない限り、
シェルパターン 
.I pattern
(注:正規表現とは異なる) にマッチする名前のファイルはリスト表示しない。
シェルと同様に、ファイル名の先頭にある `.' は
.I pattern
の始めにあるワイルドカードにはマッチしない。
たとえば、
.sp
.nf
lightside:~% ls \-\-ignore='.??*' \-\-ignore='.[^.]' \e
   \-\-ignore='#*'
.fi	  
.sp
では、
1 つ目のオプションが `.' で始まる 3 文字以上の長さの名前を
リストから除外する。
また、2 つ目のオプションが `..' 以外の `.' で始まる 2 文字の名前を除外する。
さらに、3 つ目のオプションが `#' で始まる名前をリストから除外する。
.TP
.B "\-L, \-\-dereference"
シンボリックリンクそのものではなく、
参照しているファイルの情報をリスト表示する。
.TP
.B "\-N, \-\-literal"
ファイル名中の非表示文字の変換を行わない。
.TP
.B "\-Q, \-\-quote\-name, \-\-quoting\-style=c"
ファイル名をダブルクォートで囲む。
さらに、非表示文字を C 言語で使われている形式に変換して表示する。
.TP
.B "\-R, \-\-recursive"
すべてのディレクトリの中身を再帰的にリスト表示する。
.TP
.B "\-S, \-\-sort=size"
アルファベット順でなく、ファイルサイズでディレクトリの中身をソートする。
最も大きいファイルが最初に表示される。
.TP
.BI "\-T, \-\-tabsize " cols
タブストップの幅を
.I cols
文字分と仮定する。デフォルトは 8 文字分。
.B ls
は効率をよくするために出力中の可能な場所でタブを使う。
.I cols
がゼロの場合、タブをまったく使わない。
.TP
.B "\-U, \-\-sort=none"
ディレクトリの中身をソートせず、ディスク上にある順番にリスト表示する
.RB ( \-U 
.B \-f
の違いは、\-f オプションが他のオプションを
有効にしたり無効にしたりする点にある)。
非常に大きなディレクトリをリスト表示する場合、
このオプションは特に有用である。
なぜなら、ソートをしないことにより著しく速くできるからである。
.TP
.B "\-X, \-\-sort=extension"
ディレクトリの中身をファイル拡張子 (最後の `.' の後につづく文字列) の
アルファベット順にソートする。
拡張子のないファイルは最初にソートされる。
.TP
.B \-\-block\-size=\fISIZE
環境変数の値を上書きして、ブロックサイズを \fISIZE\fR に設定する。
.TP
.BI "\-\-color[=" when ]
ファイルタイプを区別するための色づけの有無を指定する。
色は環境変数 LS_COLORS を用いて指定される。
この変数の設定法についての情報は
.BR dircolors (1)
を参照すること。
.I when
は省略できる。
以下のいずれか 1 つを指定することもできる:
.RS
.TP
.B none
まったく色づけしない。これがデフォルトである。
.TP
.B auto
標準出力が端末の場合のみ色づけする。
.TP
.B always
常に色づけする。
.B \-\-color
を指定して
.I when
に何にも指定しないのは
.B \-\-color=always
と等しい。
.RE
.TP
.B "\-\-full-time"
時刻に関する情報を標準の省略形式ではなく完全な形式でリスト表示する。
時刻の表示形式は
.BR date (1)
のデフォルトと同じ。この形式は変更できないが、
時刻の文字列を
.BR cut (1)
で取り出し、結果を `date \-d' に渡すことができる。

時刻の出力に秒単位の情報を含んでいるので、このオプションはとても有用である。
(Unix ファイルシステムは、
四捨五入した秒単位までのタイムスタンプしか持たないので、
このオプションはタイムスタンプにあるすべての情報を表示する。)
例えば、Makefile でファイルを正しく再生成してくれない場合に
このオプションが役立つ。
.TP
.B \-\-indicator\-style=\fIWORD
各ファイル名にファイルタイプを示す文字を付加する。
付加される文字は \fIWORD\fR に依存する:
.RS
.TP
.B none
ファイルタイプを示す文字を付加しない。これがデフォルトの動作である。
.TP
.B file\-type
ディレクトリに `/' を、シンボリックリンクに `@' を、
FIFO に `|' を、ソケットに `=' を付加する。
通常のファイルには何もつけない。
\fB\-p\fR と \fB\-\-file\-type\fR に等しい。
.TP
.B classify
\fBfile\-type\fR と同じであるが、
さらに実行可能ファイルには `*' をつける。
\fB\-F\fR と \fB\-\-classify\fR に等しい。
.RE
.TP
.B \-\-quoting\-style\=\fIWORD
出力されるファイル名をクォートするために、
\fIWORD\fR で指示されるスタイルを使用する。
\fIWORD\fR は次のいずれかでなければならない:
.RS
.TP
.B literal
ファイル名をそのまま出力する。これがデフォルトの動作であるが、
将来のバージョンでは shell がデフォルトになるかもしれない。
.TP
.B shell
ファイル名がシェルのメタキャラクタを含む場合や、
シェルによくわからない出力を引き起こさせるかもしれない場合には、
ファイル名をクォートする。
.TP
.B shell\-always
通常はクォートを必要としないファイル名に対しても、クォートを行う。
.TP
.B c
C 言語における文字列の形式でファイル名をクォートする。
\fB\-Q\fR と \fB\-\-quote\-name\fR に等しい。
.TP
.B escape
\fBc\fR と同じであるが、ファイル名を囲むダブルクォート文字を省略する。
\fB\-b\fR と \fB\-\-escape\fR に等しい。
.TP
.B locale
\fBc\fR 形式と似ているが、
"このように" 適切なロケール固有のクォートシンボルを使う。
.TP
.B clocale
\fBc\fR 形式と似ているが、
`このように' 適切なロケール固有のクォートシンボルを使う。
.PP
\fB\-\-quoting-style\fR オプションのデフォルトの値は
環境変数 \fBQUOTING_STYLE\fR で指定することができる。
.RE
.TP
.B \-\-show\-control\-chars
ファイル名の中の非表示文字をそのまま出力する。
出力が端末でないか、プログラムが \fBls\fR でない場合はデフォルトである。
.TP
.B "\-\-time=atime, \-\-time=access"
\fB\-\-sort=time\fR または \fB\-t\fR と一緒に使われると、
\fB\-u\fR (atime でソートする) と等しくなる。
普通に時刻を表示するオプションと一緒に使われると、
各ファイルの最終修正時刻ではなく最終アクセス時刻を表示する。
.TP
.B \-\-time=ctime, \-\-time=status, \-\-time=use
\fB\-\-sort=time\fR または \fB\-t\fR と一緒に使われると、
\fB\-c\fR (ctime でソートする) と等しくなる。
普通に時刻を表示するオプションと一緒に使われると、
各ファイルの最終修正時刻ではなく inode の最終変更時刻を表示する。
.SH GNU 標準オプション
.TP
.B "\-\-help"
標準出力に使用方法のメッセージを出力して正常終了する。
.TP
.B "\-\-version"
標準出力にバージョン情報を出力して正常終了する。
.TP
.B "\-\-"
オプションリストの終りを示す。
.SH ブロックサイズ
デフォルトの出力ファイルブロックサイズは
1024 バイト (\fBPOSIXLY_CORRECT\fR が設定されているときは 512 バイト) である。
この値は以下の環境変数のどれかを設定することで変更できる。
また、これらの環境変数の値は \fB\-\-block\-size=\fISIZE\fR が
オプションに与えられると無視される。
.TP
優先順位:
.BR LS_BLOCK_SIZE ", " BLOCK_SIZE ", " POSIXLY_CORRECT .
.PP
これらの変数の値は、数字でも \fBhuman\-readable\fR でも \fBsi\fR でもよい。
数字の後には、何倍であるかを指定するサイズ文字と、
通常のバイトを選択する \fBB\fR または
10 進の「商業用」バイトを選択する \fBD\fR を続けてもよい。
たとえば、`BLOCK_SIZE=1KB' は `BLOCK_SIZE=1024' に等しく、
`BLOCK_SIZE=1KD' は `BLOCK_SIZE=1000' に等しい。

以下の文字が認識される 
(また \fB\-\-human\-readable\fR と 
\fB\-\-si\fR オプションで表示されるときに用いられる)
.TP
.B k
キロ: \fB\-\-human-readable\fR なら 2^10 = 1024、
\fB\-\-si\fR なら 10^3 = 1000 
.TP
.B M
メガ: 2^20 = 1,048,576 または 10^6 = 1,000,000
.TP
.B G
ギガ: 2^30 = 1,073,741,824 または 10^9 = 1,000,000,000
.TP
.B T
テラ: 2^40 = 1,099,511,627,776 または 10^12 = 1,000,000,000,000
.TP
.B P
ペタ: 2^50 = 1,125,899,906,842,624 または 10^15 = 1,000,000,000,000,000
.TP
.B E
エクサ: 2^60 = 1,152,921,504,606,846,976 または 
10^18 = 1,000,000,000,000,000,000
.TP
.B Z
ゼタ: 2^70 = 1,180,591,620,717,411,303,424 または
10^21 = 1,000,000,000,000,000,000,000
.TP
.B Y
ヨタ: 2^80 = 1,208,925,819,614,629,174,706,176 または
10^24 = 1,000,000,000,000,000,000,000,000
.SH 環境変数
変数 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 は
.B ls
によって書き出される時刻の文字列のためのタイムゾーンを与える。
.SH バグ
BSD システムでは、HP-UX システムから NFS マウントしたファイルに対して、
.B "\-s"
オプションでは正しい値の半分の値を表示してしまう。
HP-UX システムでは、BSD システムから NFS マウントしたファイルに対して、
.B ls 
は正しい値の 2 倍の値を表示してしまう。
これは HP-UX の欠陥によるもので、HP-UX の 
.B ls
プログラムにも影響を及ぼしている。
.SH 準拠
POSIX 1003.2
.SH 関連項目
.BR dircolors (1)
.SH 注意
このページは fileutils-4.1 パッケージの
.B ls
コマンドについて説明したものである;
その他のバージョンでは少し違いがあるかもしれない。
修正や追加は aeb@cwi.nl, aw@mail1.bet1.puv.fi, ragnar@ragnar-hojland.com
宛にメールで連絡してください。
プログラムのバグについては bug-fileutils@gnu.org へ報告してください。