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

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

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

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

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

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

   > cd <install-dir>/sepdk/src

   > ./insmod-sep -q

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

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

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

   • CONFIG_SMP=y

   • CONFIG_TRACEPOINTS=y (これはオプションですが、推奨されます)

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

   • CONFIG_KPROBES=y

   • CONFIG_RING_BUFFER=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 <グループ>

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

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

   > ./insmod-sep -g <グループ> -pu

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

   > ./insmod-sep -re

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

   > cd <install_dir>/sepdk/src

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

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