ls(1) FreeBSD 一般コマンドマニュアル

ls

前のページ 上に戻る 次のページ

ls




解説

     lsfile で指定されたファイル名およびオプションの指定にしたがって、ファ
     イルに関する各種の情報を表示します。なお、 file としてディレクトリが指定
     された場合は、そのディレクトリ配下のファイルに関する情報を表示します。

     file が指定されなかった場合は、カレントディレクトリのファイルを表示しま
     す。表示はファイル名のアルファベット順にソートされます。ただし、 file と
     してディレクトリファイルとそれ以外のファイルを混在して指定した場合は、
     ディレクトリ以外のファイルが先に表示され、その後ディレクトリ配下のファイ
     ルが表示されます。

     オプションとしては、以下のものがあります。

     -A      `.' と `..' を除く全てのエントリを表示します。スーパユーザの場合
             は、通常このオプションがセットされています。

     -B      ファイル名中の非グラフィック文字を強制的に \xxx の形式で表示しま
             す。 xxx は文字の数値であり 8 進数です。

     -C      マルチカラム形式で出力します。端末への出力の場合は、これがデフォ
             ルトになります。

     -F      それぞれのパス名の最後に、ディレクトリならばスラッシュ (/)、実行
             可能ファイルならばアスタリスク (*)、シンボリックリンクならばアッ
             トマーク (@)、ソケットファイルならば等号 (=)、 FIFO ならば縦棒
             (|) をつけて表示します。

     -G      カラー化出力を有効にします。本オプションは、環境変数 CLICOLOR を
             定義することと同等です (後述)。

     -H      コマンドラインのシンボリックリンクを追跡します。 -F, -d, -l オプ
             ションのいずれも指定されなかった場合、このオプションが仮定されま
             す。

     -L      引数がシンボリックリンクファイルの場合、リンクファイル自体ではな
             く、リンク先のファイルやディレクトリを表示します。このオプション
             は -P オプションを打ち消します。

     -P      引数がシンボリックリンクの場合、リンクが参照しているオブジェクト
             ではなくリンク自身を表示します。このオプションは -H, -L オプショ
             ンを打ち消します。

     -R      サブディレクトリを再帰的に表示します。

     -T      ファイルの日付と時間に関する詳細情報 (月・日・時・分・秒・年) を
             表示します。

     -W      ディレクトリ走査時にホワイトアウトも表示します。

     -a      ドット (.) で始まるファイルも含めて表示します。

     -i      各ファイルについて、i ノード番号を表示します。

     -k      -s オプションとともに使用し、ファイルサイズをブロック単位ではなく
             K バイト単位で表示します。このオプションは環境変数 BLOCKSIZE に優
             先します。

     -l      (``エル (L)'' の小文字)。ファイルの詳細情報をロングフォーマットで
             表示します (下記参照)。端末に出力している場合、ロングフォーマット
             の前の行に、全ファイルのサイズの合計値を表示します。

     -n      長い (-l) 出力において、ユーザとグループを名前に変換せずに、ユー
             ザとグループの ID を数値で表示します。

     -o      (-l) オプションによる詳細情報に、ファイルフラグも含めて表示しま
             す。

     -q      ファイル名に表示できない文字が使われていたとき、`?' として表示し
             ます。端末に表示するときは、デフォルトでこの指定になります。

     -r      辞書式順序で逆順または時刻の古い順にソートします。

     -s      各ファイルがファイルシステム上で実際に占有しているブロック数 (512
             バイト単位) を表示します。ブロックの一部だけ占有しているものも整
             数値に切り上げられます。端末に表示するときは、表示の先頭行に、全
             ファイルのサイズの合計値を表示します。環境変数 BLOCKSIZE は単位サ
             イズ 512 バイトに優先します。

     -t      ファイルをアルファベット順に表示する前に、ファイルの最終修正日時
             の順 (新しいものほど先にくる) にソートします。

     -u      (-t) オプションや (-l) オプションで、ファイルの最終修正日時の代わ
             りに、ファイルの最終アクセス日時を使用します。

     -1      (数字の ``1'')。 1 行につき 1 エントリの形式で表示します。端末へ
             の出力でない場合には、これがデフォルトです。

     -1, -C, -l オプションは、互いに他を上書きします。最後に指定されたオプショ
     ンが有効となります。

     -c-u オプションは、互いに他を上書きします。最後に指定されたオプション
     が有効となります。

     -B, -b, -q オプションは互いに優先し合う関係にあります。最後に指定されたも
     のが印字不可文字の書式を決定します。

     -H, -L, -P オプションは互いに優先し合う関係にあります(部分的もしくは全体
     的)。指定された順序で適用されます。

     デフォルトでは ls は標準出力に 1 行 1 エントリずつ表示します。ただし、出
     力先が端末である場合および -C オプションが指定された場合は別です。

     -i, -s, -l オプションが指定された場合、関連するファイルの情報は 1 個以上

     ファイルがキャラクタ型もしくはブロック型の特殊ファイルである場合、ファイ
     ルサイズフィールドにはファイルのメジャー番号とマイナー番号が表示されま
     す。ファイルがシンボリックリンクファイルである場合、リンク先ファイルのパ
     ス名が ``->'' によって表示されます。

     -l オプションのもとで表示されるファイルモードは、エントリタイプ、所有者ア
     クセス許可、所有グループアクセス許可などで成り立っています。エントリタイ
     プの文字はファイルのタイプを表しており、各文字の意味は次のとおりです:

           b     ブロック型特殊ファイル
           c     キャラクタ型特殊ファイル
           d     ディレクトリ
           l     シンボリックリンクファイル
           s     ソケットファイル
           p     FIFO
           -     通常ファイル

     次の 3 つのフィールドは、それぞれ 3 つの文字からなっています: 所有者に対
     するアクセス許可・グループに属するユーザに対するアクセス許可・他のユーザ
     に対するアクセス許可。これらのフィールドはそれぞれ 3 つの文字からなってい
     ます:

           1.   もし r ならば読みだし可能。もし - ならば読みだし不能。

           2.   もし w ならば書き込み可能。もし - ならば書き込み不能。

           3.   その他の場合: 以下のうち最初に該当するものが用いられる。

                      S     所有者に対するアクセス許可において、ファイルが実行
                            可能ではなく、かつ、実効ユーザ ID (set-user-ID) モ
                            ードがセットされている場合。所有グループに対するア
                            クセス許可において、ファイルが実行可能ではなく、か
                            つ、実効グループ ID (set-group-ID) モードがセット
                            されている場合。

                      s     所有者に対するアクセス許可において、ファイルが実行
                            可能で、かつ、実効ユーザ ID モードがセットされてい
                            る場合。所有グループに対するアクセス許可の中で、
                            ファイルが実行可能で、かつ、実効グループ ID モード
                            がセットされている場合。

                      x     ファイルが実効可能またはディレクトリが検索可能であ
                            る場合。

                      -     ファイルは、読み出し、書き込み、実行のいずれも許可
                            されておらず、実効ユーザ ID も実効グループ ID もス
                            ティッキービットも設定されていない場合 (以下参
                            照)。

                次の2つは他のユーザに対するアクセス許可の 3 番目の文字に使用さ
                れます。

     さらに、 sort(1) への -r フラグを使用することにより、結果を大から小へ (逆
     順に) 並べられます。


診断

     ユーティリティ ls は、成功すると 0 で、エラーがあった場合は >0 で終了しま
     す。


環境変数

     以下の環境変数は ls の動作に影響を与えます:

     BLOCKSIZE  ブロック数の表示を行う際、1 ブロックのサイズとして環境変数
                BLOCKSIZE で指定された値が使用されます ( -s オプション参照)。

     CLICOLOR   ANSI カラーシーケンスを使用し、ファイルタイプを区別します。後
                述の LSCOLORS を参照してください。 -F で前述したもの加え、更な
                る属性 (setuid ビット設定等) もまた表示されます。カラー化は、
                適切な termcap(5) ケーパビリティを持つ端末タイプに依存します。
                デフォルトの ``cons25'' コンソールは、適切なケーパビリティを
                持っていますが、例えば xterm(1) でカラー表示したい場合には
                TERM 変数を ``xterm-color'' に設定する必要があります。他の端末
                タイプも同様の修正が必要かもしれません。出力が端末に向けられて
                いない場合、カラー化は黙って無効化されます。ただし、
                CLICOLOR_FORCE 変数が定義されている場合は例外です。

     CLICOLOR_FORCE
                出力が端末に向けられていない場合、通常、カラーシーケンスは無効
                化されます。本フラグを設定することで、この動作を変更可能です。
                TERM 変数は、カラー出力可能な端末を参照することが必要です。そ
                うなっていない場合、どのカラーシーケンスを使用すべきか決定でき
                ません。

     COLUMNS    ターミナルのカラム幅を指定します。マルチカラム表示の際、 1 行
                あたりいくつのファイル名を表示できるかを算出するために参照され
                ます ( -C 参照)。

     LANG       長い -l フォーマット出力における、日と月の順序を決定するために
                使用するロケールです。詳細は environ(7) を参照してください。

     LSCOLORS   本変数の値は、 CLICOLOR によってカラー出力が有効であるときに、
                どの色をどの属性に使用するかを指定します。この文字列は書式 fb
                の結合であり、ここで f は前景色であり、 b は背景色です。

                色の指示は次の通りです:

                      012345     マゼンタ
                      6     シアン
                      7.   キャラクタスペシャル
                      8.   setuid ビットが設定された実行形式
                      9.   setgid ビットが設定された実行形式
                      10.  他者 (others) が書き込み可能なディレクトリであり、
                           スティッキービット付き。
                      11.  他者 (others) が書き込み可能なディレクトリであり、
                           スティッキービット無し。

                デフォルトは "4x5x2x3x1x464301060203" であり、通常のディレクト
                リは前景色青でデフォルト背景色、 setuid 付き実行形式は前景色黒
                で背景色赤等です。

     LS_COLWIDTHS
                この変数が設定されている場合、コロン区切りのリストで各フィール
                ドの最小幅を指定しているものとみなされます。適切でなかったり不
                十分だったりする幅は無視されます (よって 0 を指定すると、フィ
                ールド幅が動的に決まります)。すべてのフィールドの幅を変えられ
                るわけではありません。フィールドの順序は次の通りです: iノー
                ド・ブロック数・リンク数・ユーザ名・グループ名・フラグ・ファイ
                ルサイズ・ファイル名。

     TERM       CLICOLOR の機能は、端末タイプのカラーケーパビリティが必要で
                す。

     TZ         日時を表示するときに使われるタイムゾーンを指定します。詳細は
                environ(7) を参照してください。


互換性

     IEEE Std 1003.2 (``POSIX.2'') 互換とするため、ロングフォーマット形式の出
     力には所有グループ名フィールドが自動的に含められます。


関連項目

     chflags(1), chmod(1), sort(1), xterm(1), termcap(5), symlink(7),
     sticky(8)


歴史

     ls コマンドは Version 1 AT&T UNIX から登場しました。


規格

     ls コマンドの機能は IEEE Std 1003.2 (``POSIX.2'') のスーパセットであると
     想定しています。


バグ

     過去との互換性のために、多くのオプションの関係が複雑になっています。

FreeBSD 4.4                      July 29, 1994                     FreeBSD 4.4

ABELNET VPSサービス