User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Set Up FreeBSD* System

Intel® VTune™ Profiler allows you to collect performance data remotely on a FreeBSD* target system.

Intel® VTune™ Profiler includes a target package for collecting event-based sampling data on a FreeBSD* target system either via the remote collection capability or by collecting the results locally on the FreeBSD system and copying them to a Linux*, Windows*, or macOS* host system. The collected data is then displayed on a host system that supports the graphical interface.

  1. Install VTune Profiler on your Linux, Windows, or macOS host. Refer to the Installation Guide for your host system for detailed instructions.

  2. Install the appropriate sampling drivers on the FreeBSD target system. Use the <vtune-install-dir>/target/freebsd/vtune_profiler_target_x86_64.tgz file for analysis using VTune Profiler or the <vtune-install-dir>/target/freebsd/vtune_profiler_target_sep_x86_64.tgz file for analysis using the sampling enabling product (SEP) collectors.

  3. Collect performance data using one of the following methods. For more information about each of these methods, see FreeBSD* Targets and Remote Linux Target Setup.

    • Remote analysis from the host system using the VTune Profiler command line or GUI.

    • Native analysis on the target system using the VTune Profiler command line.

    • Native analysis on the target system using the SEP collectors.

  4. Review the results on the host system.

Install the Sampling Drivers on FreeBSD

Use the following steps to configure your FreeBSD target system for event-based sampling analysis. Root privileges are required on the target system to install the VTune Profiler drivers.

  1. Copy the <vtune-install-dir>/target/freebsd/vtune_profiler_target_x86_64.tgz file to the target system using FTP, SFTP, or SCP.

  2. Extract the archive to the /opt/intel directory on the target system.

  3. Navigate to the following location: /opt/intel/sepdk/modules

  4. Run the following commands to build the appropriate drivers:

    $ make
    $ make install
  5. Run the following command to install the drivers:

    $ kldload sep pax

Allow non-root users to run an event-based sampling analysis by running the following commands after installing the drivers:

$ chgrp -R <user_group> /dev/pax
$ chgrp -R <user_group> /dev/sep

Remove the Sampling Drivers from FreeBSD

Run the following command to unload the sampling drivers:

$ kldunload sep pax