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