Beyond Linux® From Scratch (System V Edition) - Version r12.4-426

Chapter 42. Multimedia Libraries and Drivers

intel-media-driver-25.3.4

Introduction to intel-media-driver

The intel-media-driver package provides a VA API driver for Intel GPUs that are provided with Broadwell CPUs and higher. This includes support for a variety of codecs.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

[Note]

Note

On GitHub we've forked the upstream repository into our own lfs-book namespace and recreated a tag for the release. This is done to ensure the downloaded tarball file name to be correct and consistent (i.e. it shouldn't change when using the browser instead of a tool like wget). Our tag and the upstream release tag are on the same commit, so we've not introduced any change to the tarball content except the name of its top-level directory (that Git does not track).

intel-media-driver Dependencies

Required

CMake-4.1.2, gmmlib-22.8.2, libva-2.22.0, and Xorg build environment

Kernel Configuration

Enable the following options in the kernel configuration. Recompile the kernel if necessary: 

Device Drivers --->
  Graphics support --->
    <*/M>   Direct Rendering Manager (XFree86 4.1.0 and higher DRI support) --->
                                                                      ...  [DRM]
    < /*/M> Intel 8xx/9xx/G3x/G4x/HD Graphics                         [DRM_I915]
    < /*/M> Intel Xe2 Graphics                                          [DRM_XE]
    (*)       Force probe xe for selected Intel hardware IDs
                                                       ...  [DRM_XE_FORCE_PROBE]

See Mesa Kernel Configuration for more info about the i915 driver and the Xe driver.

Installation of intel-media-driver

[Note]

Note

This package takes a long time to build because it compiles code specific to each individual generation of Intel GPUs and for a variety of media codecs.

If you know the model of your Intel GPU, you can pass the -D{GEN{8,9,11,12},MTL,ARL,LNL,BMG,PTL}=OFF option to the cmake command but leaving the option for your GPU out. Note that the “GEN” number here is the generation of the GPU, not the CPU. For example, with an Intel Core i7-1065G7 CPU shipping a 11th-generation Intel GPU, the -D{GEN{8,9,12},MTL,ARL,LNL,BMG,PTL}=OFF option can be used so the code specific to the other generations of Intel GPUs won't be built.

To determine the model of the Intel GPU, install pciutils-3.14.0 and run lspci -nn | grep -Ei 'VGA|DISPLAY' first. It will output some information about the GPU, including the PCI vendor ID (8086 for Intel) and the PCI device ID. For example, with an Intel Core i5-11300H CPU, the output is 8086:9a49. Now searching for the registration of this device ID in the intel-media-driver source tree: 

grep -ri 'RegisterDevice(0x9a49'

And determine the GPU model from the file name containing the registration. For the example above, the file name is media_sysinfo_g12.cpp, indicating the model is GEN12.

Install intel-media-driver by running the following commands: 

mkdir build &&
cd    build &&

cmake -D CMAKE_INSTALL_PREFIX=$XORG_PREFIX \
      -D CMAKE_POLICY_VERSION_MINIMUM=3.5  \
      -D INSTALL_DRIVER_SYSCONF=OFF        \
      -D BUILD_TYPE=Release                \
      -D MEDIA_BUILD_FATAL_WARNINGS=OFF    \
      -G Ninja                             \
      -W no-dev ..                         &&
ninja

This package does not come with a test suite.

Now, as the root user: 

ninja install

Contents

Installed Programs: None
Installed Libraries: libigfxcmrt.so
Installed Drivers: iHD_drv_video.so
Installed Directories: /usr/include/igfxcmrt

Short Descriptions

libigfxcmrt.so

provides API functions which allow running GPU kernels on the render engine