compute-runtime/third_party/metrics_discovery
ocldev 78f6ec27dd build: metrics-discovery revision update
Signed-off-by: ocldev <ocldev@intel.com>
2025-03-17 14:57:04 +01:00
..
.revision L0 and Ocl Metric Api sub device support 2021-03-15 17:14:55 +01:00
.version build: metrics-discovery revision update 2025-03-17 14:57:04 +01:00
LICENSE.md Enable Performance Counters for OCL and L0. 2020-04-02 12:04:56 +02:00
README.md Enable Performance Counters for OCL and L0. 2020-04-02 12:04:56 +02:00
metrics_discovery_api.h build: metrics-discovery revision update 2025-03-17 14:57:04 +01:00

README.md

Intel(R) Metrics Discovery Application Programming Interface

Introduction

This software is a user mode library that provides access to GPU performance data.

The library has OS abstraction layer that allows for interoperability in different environments.

License

Intel(R) Metrics Discovery Application Programming Interface is distributed under the MIT License.

You may obtain a copy of the License at: https://opensource.org/licenses/MIT

Supported Platforms

  • Intel(R) Processors with Gen11 graphics devices (formerly Ice Lake, Elkhart Lake),
  • Intel(R) Processors with Gen9 graphics devices (formerly Skylake, Kaby Lake, Apollo Lake/Broxton, Gemini Lake, Coffee Lake),
  • Intel(R) Processors with Gen8 graphics devices (formerly Broadwell),
  • Intel(R) Processors with Gen7.5 graphics devices (formerly Haswell).

Supported Operating Systems

Intel(R) Metrics Discovery Application Programming Interface is supported on Linux family operating systems with minimum kernel version 4.14. Event based measurements require minimum Mesa version 18.2.

Detailed minimum version requirements

Platform Code Name Minimum Linux Kernel Version Minimum Mesa Version
Gen11 Elkhart Lake 5.3 19.1
Gen11 Ice Lake 4.18 19.1
Gen9, Gen8 * 4.14 18.2
Gen7.5 Haswell 4.17 18.2

Build and Install

1. Download sources.

2. Run CMake generation:

cmake .

3. Build:

make -j$(nproc)

4. Built library will be here (for 64-bit Linux):

(project_root)/dump/linux64/release/md/libmd.so

5. Install:

sudo make install

Note: To clear CMake params remove CMakeCache.txt, then regenerate.

(*) Other names and brands my be claimed as property of others.