<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>システムを一時的に停止させるstop-machineというカーネルモジュールを紹介します。ソースは<a href="https://github.com/satoru-takeuchi/stop-machine" target="_blank" rel="nofollow noopener noreferrer">ここ</a>にあります。使いかたはREADMEを見てもらえればわかります。</p>
<p>Ubuntu 18.04上でlinuxカーネル4.18.0-18-genericを起動させた状態で動作検証をしました。</p>
<p>現在の実装ではカーネルモジュールをロードしてから5秒だけシステムを停止させます。ソースの中のSTOP_MSECS定数を変更すればミリ秒単位で一時停止させる時間を変更可能です<sup class="footnote-ref"><a href="#fn-324b-1" id="fnref-324b-1">[1]</a></sup>。ここでいう停止とは次のようなものです。</p>
<ul>
<li>あらゆるプロセスが動作できない</li>
<li>あらゆるデバイスが動けない。正確にいうとデバイスから割り込みが上がってきても停止が解除するまで待たせられる。</li>
<li>上記に伴いストレージI/O、ネットワークI/Oが動かないし、ユーザからの操作も一切付けつけない</li>
</ul>
<h1 id="%E8%80%83%E3%81%88%E3%82%89%E3%82%8C%E3%82%8B%E7%94%A8%E9%80%94">
<a class="header-anchor-link" href="#%E8%80%83%E3%81%88%E3%82%89%E3%82%8C%E3%82%8B%E7%94%A8%E9%80%94" aria-hidden="true"></a> 考えられる用途</h1>
<p>このモジュールは、システムが応答しなくなったような状態でソフトウェアがどう振舞うかというテストを簡単にできるので便利です。Chaos Engineeringの部品の一つとして、間欠的なノード障害を手軽に起こすという手段としても使えるかと思います。</p>
<h1 id="%E4%BE%8B">
<a class="header-anchor-link" href="#%E4%BE%8B" aria-hidden="true"></a> 例</h1>
<p>本当に止まっているかを確認してみましょう。まずはモジュールをロードするのとは別の端末を開いて、1秒ごとに現在時刻を表示するスクリプトを動かします。</p>
<div class="code-block-container"><pre><code>$ for ((;;)) ; do sleep 1 ; date -R ; done
Sat, 04 May 2019 09:40:27 +0900
Sat, 04 May 2019 09:40:28 +0900
Sat, 04 May 2019 09:40:29 +0900
Sat, 04 May 2019 09:40:30 +0900
Sat, 04 May 2019 09:40:31 +0900
...
</code></pre></div><p>この状態でもとの端末に戻ってモジュールをロードすると、約5秒後にshellのプロンプトが出てきます。</p>
<div class="code-block-container"><pre><code>$ sudo insmod stop-machine.ko
$　　　　　　　　　　　　　　　　　# insmodコマンドを発行してから約5秒後にこのプロンプトが出てくる 
</code></pre></div><p>一秒ごとに現在時刻を出力していた端末では5秒間時間が飛んだように見えていることがわかります(以下実行例の☆1から☆2の間)。</p>
<div class="code-block-container"><pre><code>...
Sat, 04 May 2019 09:44:38 +0900
Sat, 04 May 2019 09:44:39 +0900
Sat, 04 May 2019 09:44:40 +0900
Sat, 04 May 2019 09:44:41 +0900
Sat, 04 May 2019 09:44:42 +0900
Sat, 04 May 2019 09:44:43 +0900
Sat, 04 May 2019 09:44:44 +0900 ☆1
Sat, 04 May 2019 09:44:49 +0900 ☆2
Sat, 04 May 2019 09:44:50 +0900
Sat, 04 May 2019 09:44:51 +0900
...
</code></pre></div><p>最後に現在時刻を出していた端末を閉じた上で、モジュールを以下のようにアンロードしておきましょう。</p>
<div class="code-block-container"><pre><code>$ sudo rmmod stop-machine
$ 
</code></pre></div><h1 id="%E5%AE%9F%E8%A3%85%E3%81%AE%E3%81%AF%E3%81%AA%E3%81%97">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85%E3%81%AE%E3%81%AF%E3%81%AA%E3%81%97" aria-hidden="true"></a> 実装のはなし</h1>
<p>このモジュールは、linuxカーネル内のstop_machine()という関数を使っています。この関数は第一引数によってシステム停止中に実行するハンドラを、第二引数によってこのハンドラ実行時に渡される引数を、第三引数によって「どのCPUを停止させるか」を決めます(NULLにすれば全CPU)。stop_machine()関数はカーネル内で他の処理に一切割り込まれたくない処理において使われます。このモジュールにおいてはハンドラの中で1秒だけCPUを使うような無限ループを全CPU上で回しています。</p>
<p>stop_machine関数について興味のあるかたはソース<sup class="footnote-ref"><a href="#fn-324b-2" id="fnref-324b-2">[2]</a></sup>をごらんください。この記事を書いた後にakachochinさんが<a href="https://qiita.com/akachochin/items/fa415c6ad8a313b986b0" target="_blank" rel="nofollow noopener noreferrer">大変よい記事</a>を書いてくださったのでまずはこちらを読むといいと思います。</p>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-324b-1" class="footnote-item">
<p>モジュールパラメタを使えばロード時にこの値を変更できるようになります。興味のあるかたはやってみてください。 <a href="#fnref-324b-1" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-324b-2" class="footnote-item">
<p>カーネルソース内のinclude/linux/stop_machine.hやkernel/stop_machine.cなど <a href="#fnref-324b-2" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>


たのしく学ぶLinuxカーネル開発(第二回): システムを一時的に停止させる

Discussion