Linux* ターゲットのサンプリング・ドライバーのビルドとインストール

Linux* ホストシステムでのドライバーのインストール

Linux* ホストシステムで製品のインストール中に、[Advanced (詳細)] オプションによりドライバーのインストール・オプションを制御します。インテル® VTune™ プロファイラーは次のオプションを提供します。

サンプリング・ドライバーのインストールの確認

Linux* ホストシステム上で、サンプリング・ドライバーが正しくインストールされていることを確認するには、次の操作を行います。

1. サンプリング・ドライバーがインストールされているか確認します。

   $ cd <install-dir>/sepdk/src

   $ ./insmod-sep -q

   これは、現在ドライバーがロードされているかどうかと、ドライバーデバイスのグループ所有権とファイルのアクセス権限に関する情報を提供します。

2. グループの権限を確認します。

   ドライバーがロードされていても、ユーザーが query 出力のグループメンバーに登録されていない場合、システム管理者にグループへの登録を申請してください。デフォルトのドライバーのアクセスグループは vtune です。所属するグループを確認するには、コマンドラインから groups を実行します。これは、アクセス権限が 666 以外の場合にのみ必要です。

カーネル設定の確認

カーネルの設定を確認します。

1. カーネルのヘッダーソースが、ホストシステムに存在することを確認します。カーネルバージョンは、2.6.28 以降である必要があります。カーネルのバージョンを調べるには、kernel-src-dir/include/linux/utsrelease.h または、カーネルのバージョンに応じて kernel-src-dir/include/generated/utsrelease.h を参照します。詳細は、sepdk/src ディレクトリーの README.txt ファイルを参照してください。

2. ハードウェア・イベントベース・サンプリング (EBS) 収集のため、次のオプションがカーネル設定で有効であることを確認してください。

   • CONFIG_MODULES=y

   • CONFIG_MODULE_UNLOAD=y

   • CONFIG_PROFILING=y (カーネルのバージョンが 5.16 以前の場合)

   • CONFIG_SMP=y

   • CONFIG_KALLSYMS=y

   • CONFIG_TRACEPOINTS=y(カーネルのバージョンが 5.17 以降では必須ですが、他のすべてのバージョンにも推奨されます)

   • CONFIG_KPROBES=y (カーネルのバージョンが 5.17 以降)

3. また、上記のオプションに加え、スタック付きの EBS 収集向けのカーネル設定では、次のオプションが有効であるか確認してください。

   • CONFIG_KRETPROBES=y

   • CONFIG_FRAME_POINTER=y(オプションですが、コールスタック・モード向けに推奨されます)

4. リモート・ターゲット・システムでカーネルモジュールの署名が必要であるかを決定します (CONFIG_MODULE_SIG_FORCE=y)。署名が必要である場合、ターゲットシステムと一致する署名キーが必要です。

   サンプリング・ドライバーを新たなカーネルソースからビルドして、それを既存のターゲットシステムで使用する場合、オリジナルのキーファイルを取得してサンプリング・ドライバーをオリジナルキーで署名する必要があります。別の方法として、新しいカーネルをビルドして、ターゲットデバイスに書き込んで使用することもできます。

サンプリング・ドライバーのビルド

必要条件:

• Linux* 上でカーネルドライバーをビルドしてロードするには、カーネル・ヘッダー・ソースおよびほかの追加ソフトウェアが必要になります。「カーネル設定の確認」を参照してください。

• リモートターゲット Linux* システム向けにドライバーをクロスビルドするには、<install-dir>/target フォルダーから <extract_dir> へパッケージを展開します。

ドライバーがない場合にビルドするには、次の操作を行います。

1. ビルドスクリプトが格納されるディレクトリーに移動します。

   • ローカルシステム向けにドライバーをビルド:$ cd <install-dir>/sepdk/src

   • リモート・ターゲット・システム向けにドライバーをクロスビルド:$ cd <extract-dir>/sepdk/src

2. カーネルに対応したドライバーをビルドする ./build-driver スクリプトを使用します。次に例を示します:

• $ ./build-driver

  スクリプトは、ローカルシステム向けのデフォルトのビルドオプションを表示します。

• $ ./build-driver -ni

  スクリプトは入力を促すことなく、デフォルトオプションでローカルシステム向けのドライバーをビルドします。

• $ ./build-driver -ni -pu

  スクリプトは入力を促すことなく、ユーザーごとのイベントベース・サンプリング収集を行うドライバーをビルドします。

• $ ./build-driver -ni \

  --c-compiler=i586-i586-xxx-linux-gcc \

  --kernel-version="<kernel-version>" \

  --kernel-src-dir=<kernel-source-dir> \

  --make-args="PLATFORM=x32 ARITY=smp"

  --install-dir=<path>

  スクリプトは、特定のカーネルバージョン向けに指定されたクロスコンパイラーでドライバーをビルドします。これは通常、現在のホスト上でリモート・ターゲット・システム向けのクロスビルドに使用されます。例えば、次のオプションを使用します。

  • -niは、インタラクティブなビルドを無効にします。

  • --c-compilerは、クロスビルド・コンパイラーを指定します。コンパイラーのパスは、PATH 環境変数に設定されている必要があります。オプションが省略されると、ビルドには GCC コンパイラーが使用されます。

  • --kernel-versionは、ターゲットシステムのカーネルのバージョンを指定します。ターゲットシステムの uname -r の出力と、カーネルのバージョンに対応して、kernel-src-dir/include/generated/utsrelease.h または kernel-src-dir/include/linux/utsrelease.h の UTS_RELEASE と一致する必要があります。

  • --kernel-src-dir は、カーネル・ソース・ディレクトリーを指定します。

  • --make-args は、ビルドの引数を指定します。32 ビットのターゲットシステムには PLATFORM=x32 を使用します。64 ビットのターゲットシステムには PLATFORM=x32_64 を使用します。

  • --install-dir は、ビルドが成功した後にドライバーとスクリプトをコピーする書き込み可能なディレクトリーへのパスを指定します。

スクリプトの使い方に関するヘルプを表示するには、./build-driver -h コマンドを使用します。

Open Build Service (OBS) を使用して、RPM としてサンプリング・ドライバーをビルドするには:

<install_dir>/sepdk/src ディレクトリーにある sepdk.spec ファイルを使用します。

サンプリング・ドライバーのインストール

リモート・ターゲット・システム要件: ssh、ftp、adb、sdb、または他の手段を使用してターゲットシステム向けにドライバーを構築する場合、sepdk/src フォルダーまたは、--install-dir オプションで指定されるフォルダーをコピーします。

ドライバーをインストールするには、次の操作を行います。

1. ドライバーのビルドが成功したら、insmod-sep スクリプトを使用して手動でインストールします。

   $ cd <install_dir>/sepdk/src

   $ ./insmod-sep -r -g <group>

   ここで、<group> は、ドライバーへのアクセス権を持つユーザーのグループです。

   ユーザーごとのイベントベース・サンプリング収集を行うようにビルドされたドライバーをインストールするには、次のように-pu (-per-user)オプションを追加します。

   $ ./insmod-sep -g <group> -pu

   リソースが制限された環境で実行する場合、次のように-reオプションを追加します。

   $ ./insmod-sep -re

2. ブート時に Linux* システムが自動的にドライバーをロードするようにします。

   $ cd <install_dir>/sepdk/src

   ユーザーごとのイベントベース・サンプリング収集を行うようにビルドされたドライバーをインストールするには、次のように-pu (-per-user)オプションを追加します。

   $ ./boot-script --install -g <group> -pu

   -g <group> オプションは、ドライバーがビルドされたときのグループをオーバーライドする場合にのみ必要です。