<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Unix on Tarragon</title><link>https://tarrragon.github.io/blog/tags/unix/</link><description>Recent content in Unix on Tarragon</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><copyright>Tarragon (CC BY 4.0)</copyright><lastBuildDate>Mon, 03 Aug 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://tarrragon.github.io/blog/tags/unix/index.xml" rel="self" type="application/rss+xml"/><item><title>殭屍程序與使用者程序上限：程序表格位的配置與回收</title><link>https://tarrragon.github.io/blog/macos/macos_process_limit_zombie_reaping/</link><pubDate>Mon, 03 Aug 2026 00:00:00 +0800</pubDate><guid>https://tarrragon.github.io/blog/macos/macos_process_limit_zombie_reaping/</guid><description>&lt;p>macOS 的核心維護一張程序表（process table），每個存在的程序佔用其中一個格位，而格位總數有上限。佔用格位的條件是「核心還保留著這個程序的紀錄」，跟這個程序是否還在執行沒有關係——已經結束、但紀錄尚未被回收的程序同樣佔一格。這條區分是理解 &lt;code>fork&lt;/code> 失敗的起點。&lt;code>fork&lt;/code> 是 Unix 建立新程序的系統呼叫，任何開新程序的動作——執行一條指令、跑一個腳本、編譯器開一個子行程——最終都經過它；可用格位耗盡時它回傳失敗，訊息是 &lt;code>Resource temporarily unavailable&lt;/code>，錯誤碼在 macOS 上是 35。看到這串字的時候，剩餘記憶體、CPU 使用率、以及正在執行的程序數量都可能完全正常。&lt;/p>
&lt;h2 id="兩道-fork-關卡與一道天花板">兩道 fork 關卡與一道天花板&lt;/h2>
&lt;p>程序數量的上限由三個參數共同決定，但它們的執行時機分成兩處：其中兩個由核心在每次 &lt;code>fork&lt;/code> 時檢查，第三個在 &lt;code>setrlimit&lt;/code> 時把可設定的範圍壓住。&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">sysctl kern.maxproc kern.maxprocperuid
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">launchctl limit maxproc
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">3&lt;/span>&lt;span class="cl">&lt;span class="nb">ulimit&lt;/span> -u&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>一台 Apple Silicon Mac 上的實測輸出：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-text" data-lang="text">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">kern.maxproc: 4000
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">kern.maxprocperuid: 2666
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">3&lt;/span>&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">4&lt;/span>&lt;span class="cl">	maxproc 2666 4000
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">5&lt;/span>&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">6&lt;/span>&lt;span class="cl">2666&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>fork&lt;/code> 實際檢查的兩道是：全系統程序總數對 &lt;code>kern.maxproc&lt;/code>，以及該 uid 的程序數對它自己的 &lt;code>RLIMIT_NPROC&lt;/code>（soft limit，也就是 &lt;code>ulimit -u&lt;/code> 讀到的那個值）。任一道不通過就回傳失敗。&lt;/p>
&lt;p>&lt;code>kern.maxprocperuid&lt;/code> 的執行點在第三處——&lt;code>setrlimit&lt;/code>，也就是程序調整自己資源上限的那個系統呼叫（&lt;code>ulimit&lt;/code> 這個 shell 指令是它的前端）。&lt;code>kern.maxprocperuid&lt;/code> 規定 &lt;code>RLIMIT_NPROC&lt;/code> 能被設到多高，因此它是天花板而非關卡：程序不會在 &lt;code>fork&lt;/code> 的時候撞到它，而是在嘗試把自己的上限調高時被它壓住。&lt;code>kern.maxproc&lt;/code> 由核心在開機時依機器規格決定，&lt;code>kern.maxprocperuid&lt;/code> 在本機是前者的三分之二，目的是讓單一使用者的失控程式仍留給系統其他部分足夠的格位運作；這個比值不必記，每台機器直接讀 &lt;code>sysctl&lt;/code> 就有。&lt;code>launchctl limit maxproc&lt;/code> 印出的兩欄分別是 soft 與 hard limit，兩者都會被子程序繼承。&lt;/p>
&lt;p>這個分工決定了調高上限的實際效果，而效果與直覺不同。把 &lt;code>ulimit -u&lt;/code> 設成超過 &lt;code>kern.maxprocperuid&lt;/code> 的值時，核心把它&lt;strong>靜默壓回&lt;/strong> 2666，並且把 hard limit 一併降到 2666——而降低 hard limit 是單向不可逆的：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">python3 -c &lt;span class="s2">&amp;#34;
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">&lt;span class="s2">import resource as r
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">3&lt;/span>&lt;span class="cl">&lt;span class="s2">print(&amp;#39;before:&amp;#39;, r.getrlimit(r.RLIMIT_NPROC))
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">4&lt;/span>&lt;span class="cl">&lt;span class="s2">r.setrlimit(r.RLIMIT_NPROC, (3000, 4000))
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">5&lt;/span>&lt;span class="cl">&lt;span class="s2">print(&amp;#39;set 3000 -&amp;gt;&amp;#39;, r.getrlimit(r.RLIMIT_NPROC))
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">6&lt;/span>&lt;span class="cl">&lt;span class="s2">&amp;#34;&lt;/span>&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>




&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-text" data-lang="text">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">before: (2666, 4000)
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">set 3000 -&amp;gt; (2666, 2666)&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>再嘗試設回 4000 會直接失敗（&lt;code>not allowed to raise maximum limit&lt;/code>）——原本 4000 的 hard limit 額度就這樣消失了，恢復要重開 shell。&lt;/p>
&lt;p>這裡還有一個讀數陷阱值得單獨記下。macOS 的預設 shell 是 zsh，而 zsh 的 &lt;code>ulimit&lt;/code> builtin 回報的是&lt;strong>它想設的值&lt;/strong>，不是核心實際持有的值：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-text" data-lang="text">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">zsh: ulimit -u 3000 -&amp;gt; zsh 回報 soft=3000 hard=4000 | 核心持有 (2666, 2666)
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">bash: ulimit -u 3000 -&amp;gt; bash 回報 soft=2666 hard=2666 | 核心持有 (2666, 2666)&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>照著 zsh 的輸出判斷會得到「調高成功」的結論，而實際上限一點都沒動、hard limit 還少了三分之一。要確認核心持有什麼，讀 &lt;code>getrlimit&lt;/code> 而非 shell builtin。&lt;/p>
&lt;p>真正的天花板因此在 &lt;code>kern.maxprocperuid&lt;/code> 這一層，調整它需要 root 權限。無論從哪一層調高，那個動作的作用都是延後撞牆的時間點，已經被佔住的格位一個都沒有因此釋放。&lt;/p>
&lt;p>一般桌面使用的常駐程序數量落在幾百的量級，距離兩千多的上限有相當餘裕。當前用量可以直接量：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">&lt;span class="nb">echo&lt;/span> &lt;span class="k">$((&lt;/span> &lt;span class="k">$(&lt;/span>ps -u &lt;span class="s2">&amp;#34;&lt;/span>&lt;span class="k">$(&lt;/span>id -un&lt;span class="k">)&lt;/span>&lt;span class="s2">&amp;#34;&lt;/span> &lt;span class="p">|&lt;/span> wc -l&lt;span class="k">)&lt;/span> &lt;span class="o">-&lt;/span> &lt;span class="m">1&lt;/span> &lt;span class="k">))&lt;/span> &lt;span class="c1"># 扣掉表頭那一行&lt;/span>&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h2 id="程序結束分成兩個階段">程序結束分成兩個階段&lt;/h2>
&lt;p>子程序呼叫 &lt;code>exit&lt;/code> 的那一刻，它並沒有從程序表上消失。核心先釋放它持有的資源，再把一小塊紀錄留在原地等父程序來取——殭屍狀態就是這兩個動作之間的空檔，而觸發它們的是兩個不同的角色。&lt;/p>
&lt;p>&lt;strong>第一階段由子程序自己觸發&lt;/strong>。子程序呼叫 &lt;code>exit&lt;/code>（或被信號終止）時，核心回收它的位址空間、開啟中的檔案描述子、以及其他持有的資源。這一階段結束後，這個程序已經不執行任何指令、不佔用記憶體、不排入 CPU 排程佇列。&lt;/p>
&lt;p>&lt;strong>第二階段由父程序觸發&lt;/strong>。核心在第一階段刻意保留一小塊紀錄，存放結束碼（exit status）與資源使用統計，因為父程序有權知道子程序是怎麼結束的。核心送出 &lt;code>SIGCHLD&lt;/code> 通知父程序，父程序呼叫 &lt;code>wait()&lt;/code> 或 &lt;code>waitpid()&lt;/code> 領取這塊紀錄，核心才釋放程序表格位。這個動作在 Unix 傳統上稱為收屍（reaping）。&lt;/p></description><content:encoded><![CDATA[<p>macOS 的核心維護一張程序表（process table），每個存在的程序佔用其中一個格位，而格位總數有上限。佔用格位的條件是「核心還保留著這個程序的紀錄」，跟這個程序是否還在執行沒有關係——已經結束、但紀錄尚未被回收的程序同樣佔一格。這條區分是理解 <code>fork</code> 失敗的起點。<code>fork</code> 是 Unix 建立新程序的系統呼叫，任何開新程序的動作——執行一條指令、跑一個腳本、編譯器開一個子行程——最終都經過它；可用格位耗盡時它回傳失敗，訊息是 <code>Resource temporarily unavailable</code>，錯誤碼在 macOS 上是 35。看到這串字的時候，剩餘記憶體、CPU 使用率、以及正在執行的程序數量都可能完全正常。</p>
<h2 id="兩道-fork-關卡與一道天花板">兩道 fork 關卡與一道天花板</h2>
<p>程序數量的上限由三個參數共同決定，但它們的執行時機分成兩處：其中兩個由核心在每次 <code>fork</code> 時檢查，第三個在 <code>setrlimit</code> 時把可設定的範圍壓住。</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">sysctl kern.maxproc kern.maxprocperuid
</span></span><span class="line"><span class="ln">2</span><span class="cl">launchctl limit maxproc
</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nb">ulimit</span> -u</span></span></code></pre></div><p>一台 Apple Silicon Mac 上的實測輸出：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">kern.maxproc: 4000
</span></span><span class="line"><span class="ln">2</span><span class="cl">kern.maxprocperuid: 2666
</span></span><span class="line"><span class="ln">3</span><span class="cl">
</span></span><span class="line"><span class="ln">4</span><span class="cl">	maxproc     2666           4000
</span></span><span class="line"><span class="ln">5</span><span class="cl">
</span></span><span class="line"><span class="ln">6</span><span class="cl">2666</span></span></code></pre></div><p><code>fork</code> 實際檢查的兩道是：全系統程序總數對 <code>kern.maxproc</code>，以及該 uid 的程序數對它自己的 <code>RLIMIT_NPROC</code>（soft limit，也就是 <code>ulimit -u</code> 讀到的那個值）。任一道不通過就回傳失敗。</p>
<p><code>kern.maxprocperuid</code> 的執行點在第三處——<code>setrlimit</code>，也就是程序調整自己資源上限的那個系統呼叫（<code>ulimit</code> 這個 shell 指令是它的前端）。<code>kern.maxprocperuid</code> 規定 <code>RLIMIT_NPROC</code> 能被設到多高，因此它是天花板而非關卡：程序不會在 <code>fork</code> 的時候撞到它，而是在嘗試把自己的上限調高時被它壓住。<code>kern.maxproc</code> 由核心在開機時依機器規格決定，<code>kern.maxprocperuid</code> 在本機是前者的三分之二，目的是讓單一使用者的失控程式仍留給系統其他部分足夠的格位運作；這個比值不必記，每台機器直接讀 <code>sysctl</code> 就有。<code>launchctl limit maxproc</code> 印出的兩欄分別是 soft 與 hard limit，兩者都會被子程序繼承。</p>
<p>這個分工決定了調高上限的實際效果，而效果與直覺不同。把 <code>ulimit -u</code> 設成超過 <code>kern.maxprocperuid</code> 的值時，核心把它<strong>靜默壓回</strong> 2666，並且把 hard limit 一併降到 2666——而降低 hard limit 是單向不可逆的：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">python3 -c <span class="s2">&#34;
</span></span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="s2">import resource as r
</span></span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="s2">print(&#39;before:&#39;, r.getrlimit(r.RLIMIT_NPROC))
</span></span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="s2">r.setrlimit(r.RLIMIT_NPROC, (3000, 4000))
</span></span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="s2">print(&#39;set 3000 -&gt;&#39;, r.getrlimit(r.RLIMIT_NPROC))
</span></span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="s2">&#34;</span></span></span></code></pre></div>




<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">before: (2666, 4000)
</span></span><span class="line"><span class="ln">2</span><span class="cl">set 3000 -&gt; (2666, 2666)</span></span></code></pre></div><p>再嘗試設回 4000 會直接失敗（<code>not allowed to raise maximum limit</code>）——原本 4000 的 hard limit 額度就這樣消失了，恢復要重開 shell。</p>
<p>這裡還有一個讀數陷阱值得單獨記下。macOS 的預設 shell 是 zsh，而 zsh 的 <code>ulimit</code> builtin 回報的是<strong>它想設的值</strong>，不是核心實際持有的值：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">zsh:  ulimit -u 3000  -&gt;  zsh 回報 soft=3000 hard=4000  |  核心持有 (2666, 2666)
</span></span><span class="line"><span class="ln">2</span><span class="cl">bash: ulimit -u 3000  -&gt;  bash 回報 soft=2666 hard=2666  |  核心持有 (2666, 2666)</span></span></code></pre></div><p>照著 zsh 的輸出判斷會得到「調高成功」的結論，而實際上限一點都沒動、hard limit 還少了三分之一。要確認核心持有什麼，讀 <code>getrlimit</code> 而非 shell builtin。</p>
<p>真正的天花板因此在 <code>kern.maxprocperuid</code> 這一層，調整它需要 root 權限。無論從哪一層調高，那個動作的作用都是延後撞牆的時間點，已經被佔住的格位一個都沒有因此釋放。</p>
<p>一般桌面使用的常駐程序數量落在幾百的量級，距離兩千多的上限有相當餘裕。當前用量可以直接量：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="nb">echo</span> <span class="k">$((</span> <span class="k">$(</span>ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> <span class="p">|</span> wc -l<span class="k">)</span> <span class="o">-</span> <span class="m">1</span> <span class="k">))</span>   <span class="c1"># 扣掉表頭那一行</span></span></span></code></pre></div><h2 id="程序結束分成兩個階段">程序結束分成兩個階段</h2>
<p>子程序呼叫 <code>exit</code> 的那一刻，它並沒有從程序表上消失。核心先釋放它持有的資源，再把一小塊紀錄留在原地等父程序來取——殭屍狀態就是這兩個動作之間的空檔，而觸發它們的是兩個不同的角色。</p>
<p><strong>第一階段由子程序自己觸發</strong>。子程序呼叫 <code>exit</code>（或被信號終止）時，核心回收它的位址空間、開啟中的檔案描述子、以及其他持有的資源。這一階段結束後，這個程序已經不執行任何指令、不佔用記憶體、不排入 CPU 排程佇列。</p>
<p><strong>第二階段由父程序觸發</strong>。核心在第一階段刻意保留一小塊紀錄，存放結束碼（exit status）與資源使用統計，因為父程序有權知道子程序是怎麼結束的。核心送出 <code>SIGCHLD</code> 通知父程序，父程序呼叫 <code>wait()</code> 或 <code>waitpid()</code> 領取這塊紀錄，核心才釋放程序表格位。這個動作在 Unix 傳統上稱為收屍（reaping）。</p>
<p>處於兩階段之間的程序就是殭屍（zombie）。它在 <code>ps</code> 的 <code>STAT</code> 欄位顯示為 <code>Z</code>，<code>comm</code> 欄位顯示為 <code>&lt;defunct&gt;</code>。設計良好的父程序在毫秒級內完成領取，殭屍狀態短到幾乎觀察不到；殭屍在列表裡穩定存在，代表第二階段沒有發生。</p>
<p>殭屍難以察覺的原因就在第一階段已經把大部分資源還回去了。它不佔使用者記憶體、不耗 CPU、沒有開啟的檔案，因此記憶體監控、CPU 監控、活動監視器的資源排行全部看不到它。它唯一消耗的是程序表格位，而程序表格位剛好就是 <code>fork</code> 那道 per-uid 關卡在計數的單位。一具殭屍的資源成本接近零，一千具的資源成本仍然接近零，但額度已經去掉超過三分之一。</p>
<h2 id="父程序漏收的成因">父程序漏收的成因</h2>
<p>第二階段沒有發生的原因集中在父程序這一側，常見的有三種。</p>
<p><strong>未處理 <code>SIGCHLD</code></strong>：父程序沒有安裝 handler，也沒有在主迴圈裡週期性呼叫 <code>waitpid(-1, ..., WNOHANG)</code>——<code>WNOHANG</code> 這個旗標讓呼叫在沒有子程序可收時立刻回來，因此它適合放在主迴圈裡不阻塞地掃一遍。核心送出的通知無人接收，紀錄就留著。</p>
<p><strong>handler 存在但遲遲排不到執行</strong>：父程序卡在某個阻塞的系統呼叫、或主執行緒被長時間佔用，<code>SIGCHLD</code> 排隊等待處理。信號在傳統 Unix 語意下不排隊累積，短時間內多個子程序結束時，父程序可能只看到一次通知，若 handler 只呼叫一次 <code>wait()</code> 就會漏掉其餘的。正確的寫法是在 handler 內以迴圈呼叫 <code>waitpid</code> 直到回傳零或負值。</p>
<p><strong>父程序長時間存活</strong>：這是讓漏收從瑕疵變成故障的放大條件。父程序若在幾秒內結束，殘留的殭屍會立刻被收走（機制見下節）；父程序連續執行數天甚至數週時，同樣的漏收率會線性累積成上千具。</p>
<p>Unix 提供一個明示放棄結束狀態的機制：父程序把 <code>SIGCHLD</code> 設為 <code>SIG_IGN</code>，核心就直接回收子程序的紀錄、不再產生殭屍。應用程式若對子程序的結束碼沒有需求，這是最省事的做法。另一個常見的迴避手法是 double-fork——fork 出中介程序，中介程序再 fork 出真正的工作程序後立即結束，工作程序因此變成孤兒、由系統的 init 程序負責收屍。這個手法有一個容易漏掉的收尾：原父程序仍要對中介程序呼叫一次 <code>waitpid</code>。少了這一步，中介程序自己成為殭屍，一具換一具、什麼也沒省下。</p>
<h2 id="孤兒的-reparenting">孤兒的 reparenting</h2>
<p>父程序先於子程序結束時，子程序成為孤兒（orphan），核心把它的 ppid 改成 1，交由 <code>launchd</code> 接手。這個過程稱為 reparenting。</p>
<p><code>launchd</code> 是 macOS 的 PID 1，職責之一就是對收養來的子程序持續呼叫 <code>wait()</code>。這決定了一個實用的性質：終止一個堆積殭屍的父程序時，它底下的所有殭屍會在同一時間被 <code>launchd</code> 收養並立即收屍，格位一次全數釋放。回收量等於該父程序名下的殭屍總數，不需要逐一處理。</p>
<p>同一個性質也解釋了為什麼短命程式很少造成問題。一個執行三秒的腳本即使完全沒有收屍邏輯，它結束時所有遺留的殭屍都會被 <code>launchd</code> 清掉。殭屍的堆積需要「漏收」與「父程序長存」兩個條件同時成立。</p>
<h2 id="格位耗盡時的表現">格位耗盡時的表現</h2>
<p>可用格位耗盡時，<code>fork</code> 回傳 <code>EAGAIN</code>。在 macOS 上這個錯誤碼是 35，對應訊息字串為 <code>Resource temporarily unavailable</code>：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">python3 -c <span class="s2">&#34;import errno, os; print(errno.EAGAIN, os.strerror(errno.EAGAIN))&#34;</span></span></span></code></pre></div>




<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">35 Resource temporarily unavailable</span></span></code></pre></div><p>錯誤碼的數值跨系統不同，這點會影響查表方向：Linux 的 <code>EAGAIN</code> 是 11，macOS 沿用 BSD 的 35。看到 <code>os error 35</code> 這串字時要對照的是 macOS 的表，用 Linux 的表查會得到 <code>EDEADLK</code>——而它的訊息字串是 <code>Resource deadlock avoided</code>，與 macOS 的 <code>Resource temporarily unavailable</code> 形狀相近、讀起來同樣像是「某項資源暫時有狀況」。查錯表的人因此不會察覺自己查錯了，而是被推去追鎖與死結。</p>
<p>額度見底之後，最先有反應的是那些每分鐘要開幾十次新程序的元件，而這個先後順序具有誤導性。已經在執行的常駐程序完全不受影響——瀏覽器、編輯器、正在跑的伺服器都照常運作，因為它們早就佔好了自己的格位。最先失敗的是高頻建立短命程序的元件：</p>
<p><strong>shell prompt 的狀態查詢</strong>：像 <code>gitstatusd</code> 這類每次按下 enter 就查一次 repo 狀態的元件，每次都要 fork。</p>
<p><strong>多層 shebang 的腳本</strong>：<code>#!/usr/bin/env -S uv run --script</code> 這種寫法執行一次會疊起兩個並存的程序——直譯器管理工具，加上它開出來的直譯器本身。（<code>env</code> 不算在內：它用 <code>execve</code> 把自己替換掉，不多佔一格。）剩餘額度只有十來個時，同時要拿到兩格的呼叫是最先失敗的一批。</p>
<p><strong>建置與測試工具鏈</strong>：編譯器、測試框架、任何會平行開子程序的工具。</p>
<p>失敗集中在這些元件上，容易讓人以為是該元件本身出了問題。判準是：失敗的操作彼此在功能上沒有關聯，唯一的共同點是都需要新開程序。符合這個形狀時，先量格位。</p>
<h2 id="診斷順序">診斷順序</h2>
<p>診斷用三個固定成本的查詢完成，每一步的輸出直接決定下一步，中間不需要推測。</p>
<p>先提一件反直覺的事：這些指令自己也要 fork。<code>ps | sort | uniq -c</code> 這種管線一次要開三到四個程序，而執行它的時機正好是格位最緊的時候。額度已經見底到指令跑不起來時，順序要倒過來——先從候選集裡關掉一個最大的常駐程式（模擬器、虛擬機），把格位騰出來，再回頭做診斷。關掉的那個若正好是元凶，殭屍會一併消失，這本身就是答案。</p>
<p><strong>第一步量總額</strong>，確認格位確實見底：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="nb">echo</span> <span class="k">$((</span> <span class="k">$(</span>ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> <span class="p">|</span> wc -l<span class="k">)</span> <span class="o">-</span> <span class="m">1</span> <span class="k">))</span>   <span class="c1"># 目前程序數</span>
</span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="nb">ulimit</span> -u                                       <span class="c1"># 上限</span></span></span></code></pre></div><p><strong>第二步分類</strong>，判斷佔額度的是活程序還是殭屍：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> -o stat <span class="p">|</span> grep -c <span class="s1">&#39;^Z&#39;</span></span></span></code></pre></div><p>範圍要限定在同一個 uid。配額是 per-uid 的，而 <code>ps -eo stat</code> 掃的是全系統——兩個數字並置比較時基準不同，會把別的使用者（含系統服務）的殭屍算進自己的帳上。</p>
<p>殭屍數若接近第一步的總數，方向就確定了。殭屍數接近零而總數仍逼近上限時，代表確實有那麼多活程序在跑，這時改依執行檔聚合，看是哪一支開出了幾百份：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> -o comm <span class="p">|</span> sort <span class="p">|</span> uniq -c <span class="p">|</span> sort -rn <span class="p">|</span> head -10</span></span></code></pre></div><p>正常的機器上這份清單的頭幾名是 shell、瀏覽器的 renderer、編輯器的 language server，數量落在數十。某一支衝到三位數就是那條線索——常見的是重複啟動的開發伺服器（每次熱重載留下一份舊的）、平行度設定過高的測試套件，或退出時沒有清乾淨的容器。</p>
<p><strong>第三步指認父程序</strong>，把所有殭屍依 ppid 聚合：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> -o ppid,stat,comm <span class="p">|</span> awk <span class="s1">&#39;$2 ~ /^Z/ {print $1}&#39;</span> <span class="p">|</span> sort <span class="p">|</span> uniq -c <span class="p">|</span> sort -rn <span class="p">|</span> head -5</span></span></code></pre></div><p>輸出的每一行是「殭屍數量 + 父程序 PID」。一台已經撞到上限的機器上，這行指令的輸出可能只有一行：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">2008 89668</span></span></code></pre></div><p>聚合結果集中在單一 PID 時，父程序已經確定，剩下的只有查它的身分：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">ps -o pid,ppid,etime,command -p &lt;ppid&gt;</span></span></code></pre></div><p>一個實測例子的輸出：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">  PID  PPID     ELAPSED COMMAND
</span></span><span class="line"><span class="ln">2</span><span class="cl">89668     1 10-05:12:33 qemu-system-aarch64 -netdelay none -netspeed full -avd Medium_Tablet_2</span></span></code></pre></div><p><code>ELAPSED</code> 欄位讀作十天五小時十二分，這個數字補上了時間維度：殭屍是十天內線性長出來的，跟查詢當天執行了什麼操作沒有關係，只是當天正好跨過上限那條線。累積型故障的共同特徵就是發作時機與觸發原因在時間上完全脫鉤，<code>ELAPSED</code> 是把兩者接回去的欄位。</p>
<p>ppid 聚合值得排在任何因果推測之前，理由是成本結構：它是一行指令的定值查詢，直接指認父程序，不依賴關於「誰在耗資源」的任何假設。當一個定值查詢能取代一串推論時，先跑查詢。</p>
<p>這條順序有一個超出 macOS 的理由。本文案例裡的模擬器十天內 fork 了兩千多次、平均每小時八次，遠少於 hook 的呼叫頻率——它之所以能吃掉四分之三的額度，是因為這兩千多次沒有一次歸還。佔用量是申請頻率乘上持有時間，而申請頻率的差距以倍數計、持有時間的跨度沒有上界，於是佔用量的排序由持有時間主導，報錯的位置卻只跟申請頻率有關。檔案描述子、連線池、鎖與 rate limit 額度上都存在同一組落差，跨資源的歸因順序與判讀徵兆整理在 <a href="/blog/report/resource-exhaustion-symptom-vs-holder/" data-link-title="配額耗盡的症狀落在申請最頻繁的元件、成因在持有最久的那個" data-link-desc="共享配額耗盡型故障要歸因時使用。症狀的位置由申請頻率決定，佔用量由申請頻率乘持有時間決定，而持有時間主導後者；系統保存的持有者紀錄能把搜尋範圍縮到一個元件">#252 配額耗盡的症狀落在申請最頻繁的元件、成因在持有最久的那個</a>。</p>
<h2 id="回收格位的手段">回收格位的手段</h2>
<p>要拿回那些格位，動作全部落在父程序身上——殭屍自己已經沒有可以被操作的部分。對殭屍本身送信號沒有作用——信號的生效前提是接收方會再被排程執行一次，而殭屍在第一階段就已經停止執行，<code>kill -9</code> 送出後沒有任何指令會因此被執行。</p>
<p><strong>催父程序去領</strong>：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="nb">kill</span> -CHLD &lt;parent-pid&gt;</span></span></code></pre></div><p>這會補送一次 <code>SIGCHLD</code>。父程序若有 handler 但錯過了先前的通知，可能因此開始回收。父程序沒有安裝 handler、或卡在阻塞呼叫時，這一步沒有反應，成本是一行指令，值得先試。</p>
<p><strong>終止父程序</strong>：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="nb">kill</span> &lt;parent-pid&gt;          <span class="c1"># 先給正常關閉的機會</span>
</span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="nb">kill</span> -9 &lt;parent-pid&gt;       <span class="c1"># 未退出時再強制</span></span></span></code></pre></div><p>父程序結束後，reparenting 讓 <code>launchd</code> 一次收完所有殭屍。這是回收量最大、也最確定的手段。父程序是有使用者介面的應用程式時（模擬器、虛擬機、開發工具），從介面正常關閉的效果相同，且能讓它完成自己的清理流程。</p>
<p>重新開機同樣有效，但它是「終止父程序」的高成本超集。三步診斷已經指認出父程序的情況下，重開機只是把附帶損失擴大到整台機器。</p>
<h2 id="哪類程式會累積殭屍">哪類程式會累積殭屍</h2>
<p>會累積殭屍的程式有一組共同特徵：長時間常駐、且在生命週期內反覆建立子程序而沒有確實收屍。這組描述對應前面那兩個必要條件——後半句是「漏收」，前半句是「父程序長存」；反覆建立子程序本身只是讓漏收有機會反覆發生，正確收屍的程式同樣頻繁 fork、而格位用完就還。前面那個 qemu 就是這個形狀的典型：模擬器為了周邊功能反覆開子程序，而它被設計成開著就不關。同一個形狀在開發環境裡還有幾個常見的落點——開發伺服器與檔案監看器、language server、長跑的容器 runtime，共同處境都是「本來就設計成一直開著」，於是再低的漏收率也終究會累積到上限。</p>
<p>日常檢查的成本是一行指令。寫成只在超線時才輸出，就可以掛進週期任務或 shell 啟動檔——門檻要能主動找上人，否則它只是事後判讀的參考值，而事後才去量的時候故障已經發生了：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="nv">z</span><span class="o">=</span><span class="k">$(</span>ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> -o stat <span class="p">|</span> grep -c <span class="s1">&#39;^Z&#39;</span><span class="k">)</span><span class="p">;</span> <span class="nv">p</span><span class="o">=</span><span class="k">$((</span> <span class="k">$(</span>ps -u <span class="s2">&#34;</span><span class="k">$(</span>id -un<span class="k">)</span><span class="s2">&#34;</span> <span class="p">|</span> wc -l<span class="k">)</span> <span class="o">-</span> <span class="m">1</span> <span class="k">))</span><span class="p">;</span> <span class="nv">l</span><span class="o">=</span><span class="k">$(</span><span class="nb">ulimit</span> -u<span class="k">)</span>
</span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="o">[</span> <span class="nv">$z</span> -gt <span class="k">$((</span>l/100<span class="k">))</span> <span class="o">]</span> <span class="o">||</span> <span class="o">[</span> <span class="nv">$p</span> -gt <span class="k">$((</span>l*7/10<span class="k">))</span> <span class="o">]</span> <span class="o">&amp;&amp;</span> <span class="nb">echo</span> <span class="s2">&#34;procs </span><span class="nv">$p</span><span class="s2">/</span><span class="nv">$l</span><span class="s2">, zombies </span><span class="nv">$z</span><span class="s2">&#34;</span></span></span></code></pre></div><p>判讀門檻用比值寫、不用絕對數，因為上限隨機器規格變動（本機 2666，別台機器可能是別的數）。兩條參考線：</p>
<p><strong>殭屍數超過上限的百分之一</strong>（本機約 27 具）就值得去找父程序是誰。個位數的殭屍是正常的瞬時狀態——父程序還沒輪到處理 <code>SIGCHLD</code>；累積到這個量級代表某個父程序的回收邏輯有缺陷，而它會繼續累積下去。這條線的依據是「正常狀態的殭屍數不隨時間成長」，因此門檻設在哪都行，只要它明顯高於瞬時波動。</p>
<p>第二條線看總數：上限的七成（本機 1866）。這條線刻意留得寬，而且它沒有精確的推導——剩下的三成在本機是 800 格，遠多於一次建置或一輪測試所需的數十到上百個短命程序。寬是有理由的：撞到這條線的代價只是提早查一次，而撞到真正上限的代價是建置中斷、測試莫名其妙掛掉，且那些失敗不會說出自己是資源不足。</p>
<p>要把這條線收窄成有依據的值，在自己最重的工作型態下量一次峰值即可——建置或測試跑到最忙時讀一次 <code>ps -u &quot;$(id -un)&quot; | wc -l</code>，把那個讀數當作必須保留的餘裕。平行度開得高的測試套件、本機同時跑好幾個容器、或一邊編譯一邊跑模擬器，量出來的峰值都會比上面那個範圍大。</p>
<p>操作面最有效的預防是把用完的模擬器與虛擬機關掉。長跑的 Android 模擬器另有一組完全不同的表現層症狀——半活狀態會讓 <code>flutter devices</code> 掛在 device property 查詢上，判讀訊號與恢復順序見 <a href="../../work-log/flutter_devices_hangs_on_zombie_android_emulator/">flutter devices 卡住的訊號</a>。兩者的來源同屬長跑程序，但一個表現為單一工具的查詢逾時，一個表現為全使用者範圍的 fork 失敗。</p>
<p>模擬器與虛擬機同時也是磁碟空間的大戶，常駐成本在空間與程序表兩邊各記一筆，磁碟側的排查流程見 <a href="../macos_disk_space_diagnosis/">磁碟空間診斷流程</a>。</p>
]]></content:encoded></item></channel></rss>