ByteScope

find

読み取りのみ

ディレクトリツリーを歩いて一致したものを印字します。大きなファイル、空のフォルダ、残骸を探すのに使います。

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

構文

find <path> [-type f|d] [-size +<N><suffix>] [-empty] [-maxdepth <n>] [-iname <pattern>] [-printf <format> | -exec stat -c <format> {} +]

フラグと引数

トークン意味
-type f | d通常ファイル、またはディレクトリ。
-size +<N><suffix>N 単位より大きいもの。接尾辞は必ず書いてください(`c` バイト、`k` KiB、`m` MiB、`g` GiB)。数値だけだと 512 バイトブロックの意味になり、新しいビルドではもっと悪いことになります。
-empty中身が何もないディレクトリ、または空のファイル。
-maxdepth <n>どこまで降りるか。
-iname <pattern>大文字小文字を無視する名前の一致。パターンは引用して、端末のシェルが手を出さないようにします。
-printf <format>Android 11 以降一致ごとに選んだフィールドを印字します:`%s` バイト単位のサイズ、`%p` パス、`%T@` 更新時刻。

使用例

出力の読み方

既定では一致したパスを 1 行ずつ。同じパスでサイズも得るには、Android 11 以降なら `-printf`、どこでも使えるのは `-exec stat -c … {} +` です。ファイルごとに `stat` を別途走らせるのは、ケーブル越しでは遅く、しかも競合します。

出力フィールド

フィールド意味
<path>一致 1 つにつき 1 行。
%sバイト単位のファイルサイズ。
%pパス。
%T@更新時刻。秒のあとは小数ではなく「ナノ秒の数」なので、`…0.5` は 5 ナノ秒です。
find: bad arg '-printf'Android 10 以前です。`-exec stat` にフォールバックしてください。

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

これには UI があります

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

Android Storage Analyzer を開く

関連コマンド

find と同じ作業で出てくるコマンド。

コマンド何をするか
duディレクトリツリーが占めているディスク容量を報告します。
dfマウントされているファイルシステムごとの空きと使用量を報告します。
rm端末上のファイル、またはディレクトリツリーを削除します。
dumpsys diskstatsパーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。

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 経由で実行します。あるいは全コマンドを見る