top
唯讀一次性的行程表：CPU 占用、記憶體、狀態與指令列。
- 指令
- adb shell top
- 指令
- 系統與紀錄
- 風險
- 唯讀
語法
top -b -n 1 [-m <rows>] [-H] [-q]旗標與參數
| token | 意義 |
|---|---|
| -b | 批次模式：印出單純的行而不是游標控制碼。 |
| -n 1 | 只跑一次就結束。沒有它它不會回來。 |
| -m <rows> | 限制行程列的數量，這也是把傳輸量壓小的方法。 |
| -H | 看執行緒而不是行程。 |
| -q | 隱藏標頭。在這裡永遠沒有用，因為標頭就是結構定義。 |
| -p <pid>, | 把表格限縮到這幾個行程 id，用逗號分隔。這是隔著一條線盯著一個 app、又不用把手機上每一列都運過來的最便宜方法。 |
| -u <user>, | 把表格限縮到這幾個使用者。在 Android 上，使用者是像 `u0_a234` 這樣的 uid 名稱，安裝的 app 的列就住在那裡；系統服務有自己的名字。 |
| -d <seconds> | 每一輪之間的間隔，可以帶小數。它以毫秒儲存，下限是十分之一秒、預設是三秒，而一旦用了 `-n 1` 它就不重要了。 |
| -k <field>, | 備援的排序欄位。內建預設是先看狀態，再看 CPU、經過時間、pid——這就是為什麼一列看起來很閒的東西可以坐在表格最上面。 |
| -o <field>, | 整組換掉欄位。它和 `-O` 互斥，也是把一次擷取縮小最快的方法：五欄而不是十二欄，還不到一半的位元組。 |
| -O <field>, | 在預設欄位組上再加欄位，而它是把記憶體與優先權那一段欄位擠掉，不是接在列的最後面。 |
範例
top -b -n 1 -m 10最忙的十個行程，跑一次。
top -b -n 1所有行程。在新一點的手機上會有好幾百列。
top -b -n 1 -H -m 20以執行緒為單位，適合忙在某一處的 app。
top -b -n 1 -o PID,USER,%CPU,RSS,ARGS比較窄的表：五欄而不是十二欄，傳輸量小很多，而且仍然足夠找出誰在忙。
top -b -n 1 -p 3062一個行程、取樣一次——當你已經知道自己在跟哪個 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先是摘要行，接著標頭，然後一行一個行程。請透過那個標頭來讀欄位：被排序的那一欄外面包著方括號——`S[%CPU] %MEM` 是兩欄而不是一欄——而不剝掉括號、直接精確比對標籤的讀法，會剛好丟掉整張表正在排序的那一欄。
輸出欄位
| 欄位 | 意義 |
|---|---|
| PID / USER | 行程 id 與 Android 的 uid 名稱（`u0_a234` 是一個 app）。 |
| %CPU | 取樣區間內的占用率，一位小數。 |
| RES / VIRT / SHR | 常駐、虛擬與共享記憶體，以四捨五入到三位有效數字的人類可讀位元組值表示。 |
| RSS | 以假設 4 KiB 分頁換算的 KiB 常駐記憶體——那是 toybox 自己的假設，所以在 16 KiB 分頁的裝置上會報得偏小。 |
| S | 行程狀態：S 睡眠、R 執行中、D 不可中斷、Z 僵屍。 |
| TIME+ | 累計 CPU 時間，格式是分:秒.百分秒——而那是「總分鐘數」，所以兩小時的 CPU 時間會印成 120:00.00。 |
| ARGS | 指令列，含空白。永遠是最後一欄。 |
| PR | 排程優先權，以文字形式帶著，因為即時行程在那個位置印的是 `RT` 兩個字母而不是數字。 |
| NI | nice 值。Android 主要是靠排程群組在節流，所以很多其實正被壓著的行程，這一欄都是零。 |
| %MEM | 占實體記憶體的比例，一位小數；到了一百之後小數點就不印了。 |
| Tasks: … total, … running | 第一行摘要：那是計數而不是大小。它底下的記憶體摘要是把核心的計數器四捨五入之後改寫的，不是拿來計算的數字。 |
需要什麼權限
不用 root，也不用 `adb root`——而這件事能成立，是有人刻意安排的結果，不是檔案模式的意外。`/proc` 在第一階段 init 就以 `hidepid=2` 與 `AID_READPROC` 這個 gid 掛載，把每一個行程目錄對群組外的人藏起來；`adbd` 接著在放掉權限之前，把 `AID_READPROC` 放進它交給 `shell` 使用者的附加群組清單裡。所以一條線看得到整張行程表，而同一支手機上的 app 只看得到自己，全部的差別就是一個附加 gid，而不是什麼可以在執行期被授予的權限。這一頁上的東西全部唯讀：`top` 打開 `/proc` 底下的各行程檔案，把讀到的東西印出來。數字的來源帶出兩個後果。取樣到一半就結束的行程只會從表上消失而不會產生錯誤，所以連續兩次的單次執行，合理地會對「有幾個工作」給出不一樣的答案。而指令列那一欄讀的檔案，對核心執行緒來說是空的，對一個 shell 沒資格檢視的行程來說可能讀不到，所以一個空白的指令列是「資訊缺了」而不是「解析失敗」。要結束一個行程是 `am force-stop`，那是另一頁、對存取問題有另一個答案；這一頁停不了任何東西。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| top: Unknown option 'x' (see "top --help") | toybox 不認識那個字母，而且它引出來的是破折號後面剩下的東西，所以 `-bx` 會被回報成 `x` 而不是整個字。請對照這一頁的旗標表而不是 GNU 的手冊：這兩個叫做 `top` 的程式除了名字以外幾乎沒有共通點。 |
| top: -n < 1 (see "top --help") | `-n 0` 不代表「一直跑」；這個選項宣告的最小值是 1，所以 0 就只是超出範圍，什麼都不會跑。要取一次樣就結束，`-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` 是 toybox 而不是 procps，旗標與欄位都和 GNU 的手冊頁不同。預設的欄位組是由程式碼而不是說明文字決定的。
- `-n 1` 還是會花掉大約四分之一秒，因為 CPU 占用率需要兩次取樣。你拿到的是一次真實的短時間量測，而不是開機以來的平均。
- 不要從摘要行推導記憶體總量：那是把核心的計數器四捨五入後改寫的有損形式。`/proc/meminfo` 是更好的來源。
- `/proc` 是以 `hidepid=2` 與一個 `readproc` gid 掛載的，而 shell 是被 `adbd` 放進那個群組的。單單這一個安排，就是為什麼一條線不用 root 也看得到每一個行程——也是為什麼同一個指令在 app 裡面只看得到那個 app 自己。
- 內建的備援排序是先看狀態再看 CPU，所以表格最上面那一列是被排到那裡的，不見得就是手機上最忙的東西。從位置下結論之前，先讀 `%CPU`。
這個我們有 UI
Android System Monitor 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。
相關指令
和 top 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| dumpsys meminfo | 哪些行程最吃記憶體，量的是 PSS（按比例分攤的用量）。 |
| am force-stop | 殺掉屬於某個 app 的所有行程與服務。 |
| dumpsys activity activities | 現在哪個 app 在前景，以及它背後的 task 與 stack 結構。 |
其他系統與紀錄指令
這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。