top
読み取りのみ1 回分のプロセス表：CPU 使用率、メモリ、状態、コマンドライン。
- コマンド
- adb shell top
- コマンド
- システムとログ
- リスク
- 読み取りのみ
構文
top -b -n 1 [-m <rows>] [-H] [-q]フラグと引数
| トークン | 意味 |
|---|---|
| -b | バッチモード：カーソル制御ではなくただの行を出します。 |
| -n 1 | 1 回だけ実行して終了します。これがないと戻ってきません。 |
| -m <rows> | プロセス行の数を制限します。転送量を小さく保つのはこれです。 |
| -H | プロセスではなくスレッド。 |
| -q | ヘッダを抑制します。ここでは決して有用ではありません。ヘッダがスキーマだからです。 |
| -p <pid>, | 表をこれらのプロセス id に絞ります。カンマ区切りです。端末上の全行を道連れにせず、ケーブル越しにアプリ 1 つを見張るいちばん安い方法です。 |
| -u <user>, | 表をこれらのユーザーに絞ります。Android でのユーザーは `u0_a234` のような uid 名で、インストールしたアプリの行はそこにいます。システムのサービスは自分たちの名前で答えます。 |
| -d <seconds> | 周期の間隔で、小数も受け付けます。ミリ秒で保持され、下限は 0.1 秒、既定は 3 秒ですが、`-n 1` を使っている時点で無関係です。 |
| -k <field>, | 副次的なソートのフィールド。組み込みの既定は状態、CPU、経過時間、pid の順で、暇に見える行が表の先頭に居座り得るのはそのためです。 |
| -o <field>, | 列の組をまるごと置き換えます。`-O` とは排他で、取得を小さくするいちばん速い方法です。12 列ではなく 5 列なら、バイト数は半分以下になります。 |
| -O <field>, | 既定の組に列を足しますが、行末に付け足すのではなく、メモリと優先度の列の塊を押しのけます。 |
使用例
top -b -n 1 -m 10いちばん忙しい 10 プロセスを 1 回。
top -b -n 1全プロセス。最近の端末では数百行になります。
top -b -n 1 -H -m 201 か所で忙しいアプリのために、スレッド単位で。
top -b -n 1 -o PID,USER,%CPU,RSS,ARGS狭い表：12 列ではなく 5 列で、転送はずっと小さく、それでも何が忙しいかを見つけるには十分です。
top -b -n 1 -p 3062プロセス 1 つを 1 回だけ。相手の pid が既に分かっているときに手を伸ばす形です。
出力の読み方
出力例
Tasks: 1003 total, 1 running, 1002 sleeping, 0 stopped, 0 zombie
PID USER PR NI VIRT RES SHR S[%CPU] %MEM TIME+ ARGS
3062 u0_a234 20 0 14.2G 353M 210M S 6.2 3.0 12:04.51 com.example要約行、ヘッダ、そして 1 行 1 プロセスです。列はそのヘッダを通して読んでください。ソートされている列は角括弧で囲まれ、`S[%CPU] %MEM` は 1 列ではなく 2 列です。括弧を外さずにラベルを厳密一致させる読み方をすると、まさに表がソートされている列を失います。
出力フィールド
| フィールド | 意味 |
|---|---|
| PID / USER | プロセス id と Android の uid 名（`u0_a234` はアプリ）。 |
| %CPU | サンプル区間での使用率。小数第 1 位まで。 |
| RES / VIRT / SHR | 常駐・仮想・共有メモリを、有効桁 3 つに丸めた人間向けのバイト値で。 |
| RSS | 4 KiB ページを仮定した KiB 単位の常駐メモリ。これは toybox 自身の仮定なので、16 KiB ページの端末では小さく出ます。 |
| S | プロセスの状態：S 休眠、R 実行中、D 割り込み不可、Z ゾンビ。 |
| TIME+ | 累積 CPU 時間、分:秒.100 分の 1 秒。しかもそれは「総分数」なので、CPU 時間 2 時間は 120:00.00 と出ます。 |
| ARGS | コマンドライン。空白を含みます。常に最後の列です。 |
| PR | スケジューリングの優先度。realtime のプロセスは数値の代わりに `RT` の 2 文字を印字するので、テキストとして運ばれます。 |
| NI | nice 値。Android は主にスケジューラのグループで絞るので、実際には抑えられているプロセスでもここは 0 と読めます。 |
| %MEM | 物理メモリに占める割合を小数第 1 位まで。100 に達すると小数なしで印字されます。 |
| Tasks: … total, … running | 最初の要約行：サイズではなく個数です。その下のメモリの要約はカーネルのカウンタを丸めて言い換えたもので、計算に使う数値ではありません。 |
必要な権限
root も `adb root` も不要です。そしてこれが動くこと自体、ファイルモードの偶然ではなく誰かが意図して用意した仕掛けです。`/proc` は first-stage init のときに `hidepid=2` と `AID_READPROC` の gid でマウントされ、そのグループの外からはプロセスのディレクトリが 1 つも見えません。`adbd` はそのうえで、権限を落とす直前に `shell` ユーザーへ渡す補助グループの一覧に `AID_READPROC` を入れます。だからケーブルはプロセス表の全体を見て、同じ端末のアプリは自分だけを見る。違いは実行時に何かが与えられる権限ではなく、補助 gid が 1 つあるかどうかです。このページのすべては読み取り専用で、`top` は `/proc` の下のプロセスごとのファイルを開いて読んだものを印字します。数値の出どころから 2 つ帰結します。サンプルの最中に終了したプロセスはエラーを出さずに表から消えるので、続けて 2 回撮った 1 回きりの実行が、タスクの数について正当に食い違うことがあります。そしてコマンドラインの列は、カーネルスレッドでは空で、shell が覗く筋合いのないプロセスでは読めないことがあるファイルから読まれるので、空のコマンドラインは解析の失敗ではなく情報の欠落です。プロセスを終わらせるのは `am force-stop`、アクセスの問いに別の答えを持つ別のページで、ここには何かを止める手段はありません。
エラーメッセージの読み解き
| メッセージ | 意味 |
|---|---|
| top: Unknown option 'x' (see "top --help") | toybox がその文字を知らず、ダッシュの後ろに残っていたものを引用するので、`-bx` は打った語全体ではなく `x` として報告されます。GNU の man ではなくこのページのフラグの表と突き合わせてください。`top` という名前の 2 つのプログラムは、名前以外ほとんど何も共有していません。 |
| top: -n < 1 (see "top --help") | `-n 0` は「永久に走る」ではありません。このオプションは最小値 1 で宣言されているので、0 は単に範囲外で何も走りません。1 回だけ撮って終わるなら `-n 1` がすべての答えです。 |
| top: Max 0 arguments (see "top --help") | `top` は位置引数をまったく受け付けません。実際にはフラグを失った `-p` や `-u` の一覧か、上の行から紛れ込んだ語です。確認は何かが走る前に起きるので、何もサンプルされていません。 |
| top: No 'O' with 'o' (see "top --help") | `-o` は列の組を丸ごと置き換え、`-O` は足すので、両方頼むとヘッダが決まらなくなります。コマンドは選ばずに断ります。置き換えたいのか、足したいのか、意図に合うほうを選んでください。 |
| top: no /proc | `/proc` のツリーをまったく歩けなかったので、どのプロセスも記述できませんでした。起動済みの端末では、これは端末についてではなくコマンドが走っている場所について語っています。`/proc` がマウントされていない環境で出るもので、端末にプロセスがない証拠ではありません。 |
バージョンとメーカーに関する注意
- Android の `top` は procps ではなく toybox で、フラグも列も GNU の man ページとは違います。既定の列の組はヘルプではなくコードが決めています。
- `-n 1` でも 4 分の 1 秒ほどかかります。CPU 使用率には 2 回のサンプルが必要だからです。得られる数値は起動以来の平均ではなく、本物の短時間の測定です。
- 要約行からメモリの合計を導かないでください。カーネルのカウンタを丸めて言い換えた不可逆な形です。`/proc/meminfo` の方が良い情報源です。
- `/proc` は `hidepid=2` と `readproc` の gid でマウントされ、shell は `adbd` によってそのグループに入れられます。root なしでケーブルが全プロセスを見られるのはその 1 つの仕掛けのおかげで、同じコマンドをアプリの中で走らせるとそのアプリしか見えないのも同じ理由です。
- 組み込みの副次的なソートは CPU より先に状態で並べるので、表の先頭の行は「そこに並べられた」だけで、必ずしも端末でいちばん忙しいものではありません。位置から結論を出す前に `%CPU` を読んでください。
これには UI があります
Android System Monitor はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
関連コマンド
top と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| dumpsys meminfo | どのプロセスがメモリを最も使っているかを、PSS（比例配分したサイズ）で表示します。 |
| am force-stop | あるアプリのプロセスとサービスをすべて終了させます。 |
| dumpsys activity activities | いまどのアプリが前面にいるか、そしてその背後のタスクとスタックの構造。 |
他のシステムとログコマンド
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。