df

読み取りのみ

マウントされているファイルシステムごとの空きと使用量を報告します。

コマンド: adb shell df
コマンド: ファイルとストレージ
リスク: 読み取りのみ

構文

df [-k] [-h] [-H] [-P] [-i] [<path>]

フラグと引数

トークン	意味
-k	1024 バイトブロック。ヘッダのラベルを頼れるものに固定するフラグです。
-h	人間向け、1024 進。
-H	人間向け、1000 進。
-P	POSIX 出力：512 バイトブロックで、割合の列名は Capacity になります。
-i	バイトではなく inode を数えます。列の中身は inode 数になります。

使用例

```
df -k /data
```
userdata パーティションの空き容量を KiB で。
```
df -k
```
マウントされているファイルシステムすべて。
```
df -h /data
```
目で読むには速いですが、計算に使う数値ではありません。

出力の読み方

出力例

Filesystem     1K-blocks      Used Available Use% Mounted on
/dev/block/dm-9 111222333  98765432  12345678  89% /data

ヘッダ行がそのまま単位の宣言で、単位が現れるのはそこだけです。だから位置ではなくヘッダを通して列を読みます。`1K-blocks` は 1 ブロック 1024 バイト、`512-blocks` は 512 バイト、`Size` は人間向けに丸められた値、`Inodes` なら数値はバイトではありません。

出力フィールド

フィールド	意味
1K-blocks	1024 バイトブロック単位の合計。`-k` と既定。
512-blocks	512 バイトブロック単位の合計。`-P` の出力。
Size / Avail	`-h` または `-H` による人間向けの値。有効桁 3 つ。
Use% / Capacity	使用率。ラベルはフラグ次第で変わります。
Mounted on	マウントポイント。ヘッダでは 2 語、行では 1 列です。
-	測れなかったファイルシステム。0 ではありません。

バージョンとメーカーに関する注意

`-h` と `-H` は出力から見分けられません。列のラベルも単位の文字も同じで、大文字小文字で分かるのはキロバイトの接尾辞だけです。人間向けの値からはどちらの基数か分からないので、重要ならブロックで頼んでください。
シェルは標準エラーを出力に混ぜるので、`df: /mnt/media_rw/0000-1111: No such file or directory` のような行が表の途中に届き、語数だけは行として通ってしまいます。本物の行は、ヘッダが数値を約束した場所に数値があります。
Android 5.1 以前の `df` は別実装で、ヘッダも違い、マウントポイントの独立した列もなく、`-k` を理解せずパスとして扱います。

これには UI があります

Android Storage Analyzer はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android Storage Analyzer を開く

コマンド	何をするか
du	ディレクトリツリーが占めているディスク容量を報告します。
dumpsys diskstats	パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。
pm trim-caches	指定した空き容量に達するまで、システムにキャッシュファイルを捨てさせます。

他のファイルとストレージコマンド

コマンド	何をするか
find	ディレクトリツリーを歩いて一致したものを印字します。大きなファイル、空のフォルダ、残骸を探すのに使います。
rm	端末上のファイル、またはディレクトリツリーを削除します。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。

自分の端末では出力が違って見えるのはなぜ？

Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。

端末ではなくブラウザから実行できますか？

多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文