名前

kallsyms -デバッグ用に全てのカーネルシンボルを抽出する

書式

kallsyms [-Vh] kernel_filename

説明

kallsyms はカーネルからスタック以外のシンボルをすべて抽出し、オブジェクトデータをビルドする。このデータはそのカーネルからリンクすることができ、デバッガから利用できる。

通常のカーネルはモジュールから利用されるシンボルしかエクスポートしない。デバッグするときには、このエクスポートされたリストだけでなく、スタックシンボル以外の全てのリストがほしい場合があるかもしれない。 kallsyms はカーネルから全てのセクションとシンボルを抽出し、セクション・シンボル及びそれらのアドレスのリストを構築し、 __kallsyms セクションのみからなるリロケータブルなオブジェクトを書きだす。 __kallsyms セクションをカーネルにリンクし、そのカーネルをブートすると、デバッガは __kallsyms セクションのデータを利用してより多くのシンボルを解決できるようになる。

例えば、デバッガは __kallsyms データを用いて、以下のようなもののカーネルアドレスを求めることができる:

*

__kallsyms セクションが所属するカーネルまたはモジュール

*

__kallsyms セクションの所属するコード内部のセクション

*

一番近いシンボル

オプション

-h, --help

オプションの一覧を表示して終了する。

-V, --version

kallsyms のバージョンを表示する。

リンク作業

正しく __kallsyms セクションを含んだカーネルを作成するには、 4 段階のリンク作業を行わなければならない (通常は 1 段階のみ)。 kallsyms とリンカは高速だから、P200 なら余分の 3 段階には数秒しかかからない。

1

__kallsyms データがない状態での、カーネルの最初のビルド。 kallsyms をこのリンクの出力に対して実行し、生カーネルの全てのセクションと全てのシンボルを含む、リロケータブルなオブジェクトを作成する。

2

再びカーネルをリンクする。今回は (1) での kallsyms の出力も含める。 __kallsyms セクションを追加すると、セクション数や多くのカーネルシンボルのオフセットが変更されるので、もう一度 kallsyms をこの二番目のリンクに実行し、再びリロケータブルな出力をセーブする。

3

再びカーネルをリンクする。今回は (2) での kallsyms の出力を含める。 kallsyms を一番新しいカーネルに対して実行する。この段階で __kallsyms セクションのサイズと位置は安定し、これ以降はカーネルの各セクション・シンボルは変わらない。 kallsyms の出力にはカーネルシンボルの最終値が含まれる。

4

(3) での kallsyms の出力を含め、最終的なカーネルをリンクする。

データフォーマット

__kallsyms セクションは通常と少々異なる。これはリロケータブルなデータを故意に持たず、全ての「ポインタ」はセクションへのバイトオフセットか、あるいは絶対値として表される。すなわちこのセクションはどこにでも置くことができ、リロケーションの問題を気にしなくてよい。これはカーネルイメージの内部に置くことができ、カーネルイメージの外部にも置くことができ、ロード直前のモジュールに追加することもでき、別の領域に置くこともできる、などなど。

/usr/include/sys/kallsyms.h には __kallsyms データのマッピングが記述されている。

関連項目

insmod(8)

履歴

最初のバージョンは 2000 年に Keith Owens <kaos@ocs.com.au>によって作成された。