14.3 stat: ファイルやファイルシステムの状態を報告する

stat は指定されたファイルに関する情報を表示する。

書式:

stat [option]… [file]…

オプションなしで実行すると、stat は指定されたファイルについてすべての情報を報告する。また、stat を使って、指定されたファイルが存在しているファイルシステムの情報を報告させることもできる。 ファイルがリンクの場合は、リンクが指しているファイルについて情報を提供させることも可能だ。

シェルの組み込み機能の stat やエイリアスのために、 stat に何の修飾も付けずに対話的に使ったり、スクリプトの中で使ったりすると、 動作がここで述べているものとは違うことがあるかもしれない。 シェルによる干渉を避けるためには、env 経由で stat を起動すればよい (すなわち、env stat … のようにだ)。

‘-L’

‘--dereference’

stat がシンボリックリンクを処理する方法を変更する。 このオプションを付けると、stat は、引数中の各シンボリックリンクが参照しているファイルを操作の対象にする。 このオプションがないと、stat が対象にするのは、引数のシンボリックリンクそのものになる。

‘-f’

‘--file-system’

指定されたファイルそのものについての情報ではなく、 そのファイルが存在しているファイルシステムについての情報を報告する。 このオプションを指定すると、自動的に ‘-L’ オプションも指定される。

‘-c’

‘--format=format’

デフォルトの書式の代わりに、format を使用する。 format の末尾には自動的に改行が付けられるので、 下記のようなコマンドを 2 個以上の file オペランドに対して実行すると、 各オペランドあたり 1 行の出力を生じることになる。

$ stat --format=%d:%i / /usr 2050:2 2057:2

‘--printf=format’

デフォルトの書式の代わりに、format を使用する。‘--format’ に似ているが、バックスラッシュ・エスケープを解釈して変換する。 また、行末に自動的に改行を付けることもしない。そこで、改行がしたければ、 format 中で ‘\n’ を指定する必要がある。 ‘--printf’ を使って ‘/’ と ‘/usr’ のデバイス番号と inode 番号を表示するには、こんなふうにする。

$ stat --printf='%d:%i\n' / /usr 2050:2 2057:2

‘-t’

‘--terse’

情報を簡潔な形式で表示する。他のプログラムで解析するときに都合がよい。

下記の二つのコマンドの出力は全く同じである。また、下記の ‘--format’ は、デフォルトの出力書式が (もっと詳細な形で) 表示する項目とほぼ同じものを指定している。 もっとも、SELinux セキュリティ・コンテキストが有効になっている場合には、 このフォーマット文字列の末尾に、もう一つ ‘%C’ を付け加えることになるだろうが。

$ stat --format="%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o" ... $ stat --terse ...

‘--file-system’ モードのときの簡潔形式の出力を上と同じように説明的に表現すると、

$ stat -f --format="%n %i %l %t %s %S %b %f %a %c %d" ... $ stat -f --terse ...

‘--format’ や ‘--printf’ の format 中で、 ファイルに対して使用できる書式指定子には以下のものがある。

• %a - 8 進数で表現したアクセス権 (printf のフラグ ‘#’ と ‘0’ に留意)
• %A - 人間にわかりやすい形式で表現したアクセス権
• %b - 割り当てられているブロック数 (‘%B’ を参照)
• %B - ‘%b’ の報告で使われる 1 ブロックのバイト数
• %C - ファイルの SELinux セキュリティ・コンテキスト (取得できる場合)
• %d - 10 進数で表現したデバイス番号
• %D - 16 進数で表現したデバイス番号
• %f - 16 進数で表現した Raw モード
• %F - ファイルの種類
• %g - 所有グループの ID 番号
• %G - 所有グループ名
• %h - ハードリンク数
• %i - Inode 番号
• %m - マウントポイント (下記の説明を参照)
• %n - ファイル名
• %N - 引用符で囲んだファイル名。シンボリックリンクなら、参照先も表示 (下記参照）
• %o - I/O 転送サイズの最適値の提案
• %s - ファイル全体の大きさ。サイズはバイト数
• %t - 16 進数で表現したメジャー・デバイス番号 (下記参照)
• %T - 16 進数で表現したマイナー・デバイス番号 (下記参照)
• %u - 所有者のユーザ ID 番号
• %U - 所有者のユーザ名
• %w - ファイルの作成日時 (the birth time)。不明の場合は ‘-’ を表示
• %W - Unix 紀元からの秒数で表したファイルの作成日時、または ‘0’
• %x - 最終アクセス日時 (atime)
• %X - Unix 紀元からの秒数で表した最終アクセス日時
• %y - 最終データ更新日時 (mtime)
• %Y - Unix 紀元からの秒数で表した最終データ更新日時
• %z - 最終ステータス変更日時 (ctime)
• %Z - Unix 紀元からの秒数で表した最終ステータス変更日時

‘%a’ という書式はファイルのモードを 8 進数で表示するので、 printf の ‘#’ と ‘0’ フラグを使って、出力の先頭のゼロ埋めをコントロールするとよい。 たとえば、先頭を 0 で埋めて、表示を少なくとも 3 桁にし、それより大きい数値も、 8 進数であることをはっきりさせるには、‘%#03a’ を使えばよい。

‘%N’ の書式は、環境変数 QUOTING_STYLE によって設定することができる。 その環境変数が設定されていない場合、デフォルトの値は、‘shell-escape’ である。使用できるクォーティングスタイルには、以下のものがある。

‘literal’

文字列に手を加えず、そのまま出力する。これは、‘-N’ や ‘--literal’ オプションと同じである。

‘shell’

文字列にシェルのメタ文字がある場合や、出力が誤解を招くものになりそうな場合に、 シェル向けのクォートを施す。このクォート方法は、bash のような POSIX 互換のシェルにはふさわしいものだが、 csh のような非互換のシェルでは、必ずしもうまく働くとはかぎらない。

‘shell-always’

普通ならクォートが不要な場合でも、文字列にシェル向けのクォートを施す。

‘shell-escape’

‘shell’ に似ているが、非表示文字のクォーティングに POSIX 提唱の ‘$''’ という書式を使用する。ほとんどのシェルに適している。 (訳注: ファイル名中に空白 (0x20) がある場合は、ファイル名全体をシングルクォートで囲む。)

‘shell-escape-always’

‘shell-escape’ に似ているが、普通ならクォートが不要な場合でも、 文字列にクォートを施す。

‘c’

C 言語の文字列リテラルをクォートするときのように、文字列をクォートする。 文字列をダブル・クォートで囲むことも行う。 これは、‘-Q’ や ‘--quote-name’ オプションと同じである。

‘escape’

C 言語の文字列リテラルをクォートするときのように、文字列をクォートする。 ただし、文字列をダブル・クォートで囲むことはしない。 これは、‘-b’ や ‘--escape’ と同じである。

‘clocale’

C 言語の文字列リテラルをクォートするときのように、文字列をクォートする。 ただし、文字列を囲む引用符には、ロケールにふさわしいものを使う。

‘locale’

C 言語の文字列リテラルをクォートするときのように、文字列をクォートする。 ただし、文字列を囲む引用符には、ロケールにふさわしいものを使い、 さらに、デフォルトの C ロケールで言うと、"like this" ではなく、 ’like this’ のようにクォートを行う。この方が見栄えのよいディスプレイが多い。

‘%t’ や ‘%T’ という書式指定子は、stat(2) 構造体の st_rdev メンバ に対応するものであり、従って、キャラクタ・スペシャルファイルや ブロック・スペシャルファイルに対してしか動作が定義されていない。 システムやファイルタイプによっては、st_rdev が他のものを表現する ために使われていることもありえる。

‘%W’, ‘%X’, ‘%Y’, ‘%Z’ では、ピリオドに続けて精度を書くことで、 小数点以下何桁まで表示するかを指定することができる。たとえば、‘%.3X’ と指定すると、最終アクセス日時がミリ秒の精度で出力される。ピリオド だけ指定して、精度を省略すると、stat は 9 桁を使用する。従って、 ‘%.X’ は ‘%.9X’ と同じことになるわけだ。なお、余分な精度を捨てる際、 タイムスタンプは負の無限大方向に切り下げられる (訳注: 平たく言うと、 タイムスタンプのような正の数値の場合、指定された桁数より下の部分は切り捨てられるということ。 以下の例を参照)。

0 で埋める:
  $ stat -c '[%015Y]' /usr
  [000001288929712]
スペースで位置を揃える:
  $ stat -c '[%15Y]' /usr
  [     1288929712]
  $ stat -c '[%-15Y]' /usr
  [1288929712     ]
精度指定:
  $ stat -c '[%.3Y]' /usr
  [1288929712.114]
  $ stat -c '[%.Y]' /usr
  [1288929712.114951834]

‘%m’ によって表示されるマウントポイントは、df によるマウントポイントの出力とほぼ同じである。ただし、以下の点で異なっている。

• stat はデフォルトでは、シムリンクの参照を行わない (そのためには、‘-L’ を指定する必要がある)。
• 引数としてデバイスノードが指定された場合、 stat はファイルシステムのリスト中にそのノードを捜し求めたりはせず、 デバイスノードそのものを動作の対象にする (訳注: すなわち、そのデバイス上に存在するファイルシステムのマウントポイントではなく、 デバイスノードそのもののマウントポイントを表示する)。
• bind マウントされているファイルについては、 stat はそのファイルが載っているデバイスの最初のマウントポイントではなく、 bind マウントで指定された別名 (訳注: 原文は alias。‘mount --bind olddir newdir’ における newdir のことか) の方を出力する。出力に変化がなくなるまで、 再帰的に stat を呼び出せば、現在ベースになっているマウントポイントを知ることができる。

  (訳注: 訳者には意味不明。「現在ベースになっているマウントポイント (the current base mount point)」が、上記訳注の newdir のことなら、 stat を再帰的に呼び出すまでもない。‘stat -c "%m" newdir/FILE’ は、 newdir を表示する。また the current base mount point が「根底にある (すなわち、デバイスを最初にマウントした) マウントポイント」のことなら、 stat を再帰的に呼び出しても、それを突き止めることはできない。 ひょっとすると、書式指定子に ‘%m’ が追加された coreutils-8.6 から coreutils-8.20 あたりまでの stat を linux-2.6 時代の古いカーネルと組み合わせて使ったときの動作を言っているのかもしれない。 その場合は、‘stat -c "%m" newdir/FILE’ は上記の olddir を出力するようだ。 従って、そうした組み合わせでは、stat を再帰的に実行することで、 最初にデバイスをマウントしたときのマウントポイントを知ることができる。)

ファイルシステムの情報をリストする際には (すなわち、‘--file-system’ (‘-f’) 使用時には)、書式指定子の別の一群を使わなければならない。

• %a - スーパーユーザ以外にも利用できる未使用ブロック数
• %b - ファイルシステムの総データブロック数。
• %c - ファイルシステムの総 inode 数
• %d - ファイルシステムの未使用 inode 数
• %f - ファイルシステムの未使用ブロック数
• %i - 16 進数で表現したファイルシステム ID
• %l - ファイル名の最大長
• %n - ファイル名
• %s - ブロックサイズ (高速転送用)
• %S - 基本ブロックサイズ (ブロック計算用)
• %t - 16 進数で表現したファイルシステムのタイプ
• %T - 人間にわかりやすい形式で表現したファイルシステムのタイプ

タイムスタンプは、タイムゾーンのルールに従って表示されるが、 そのルールを指定しているのは、環境変数 TZ である。 TZ が設定されていない場合は、システムのデフォルトのルールに従って表示される。 See (libc)TZ Variable section ‘Specifying the Time Zone with TZ’ in The GNU C Library Reference Manual.

終了ステータス 0 は成功を示し、0 以外の値は失敗を示す。

This document was generated on June 7, 2022 using texi2html 1.82.