| Intel(R) Graphics Memory Management Library | |
| ******************************************* | |
| Introduction | |
| ============= | |
| The Intel(R) Graphics Memory Management Library provides device specific and buffer | |
| management for the Intel(R) Graphics Compute Runtime for OpenCL(TM) and the | |
| Intel(R) Media Driver for VAAPI. | |
| License | |
| ======== | |
| The Intel(R) Graphics Memory Management Library is distributed under the MIT | |
| Open Source license. | |
| You may obtain a copy of the License at: | |
| https://opensource.org/licenses/MIT | |
| Building | |
| ======== | |
| 1) Get gmmlib repository | |
| 2) Change it to root directory | |
| ``$ cd gmmlib`` | |
| 3) Make a build directory | |
| ``$ mkdir build && cd build`` | |
| 4) Run the cmake command to prepare build files | |
| ``$ cmake [-DCMAKE_BUILD_TYPE= Release | Debug | ReleaseInternal] [-DARCH= 64 | 32] ..`` | |
| 5) Build the project | |
| ``$ make -j"$(nproc)" (Also performs compile time ULT)`` | |
| Install | |
| ======= | |
| ``$ sudo make install`` | |
| This will install the following files (e.g. on Ubuntu): | |
| | -- Install configuration: "Release" | |
| | -- Installing: /usr/local/lib/libigdgmm.so.12.1.0 | |
| | -- Installing: /usr/local/lib/libigdgmm.so.12 | |
| | | |
| Not a stand alone software component. | |
| GmmLib is built as dynamic library for Intel media driver and Compute runtime for OpenCL | |
| Supported Platforms | |
| ------------------- | |
| Intel Atom and Core Processors supporting Gen8/Gen9/Gen10 graphics devices | |
| BDW (Broadwell) | |
| SKL (Skylake, Kaby Lake, Coffee Lake) | |
| BXTx (BXT: Broxton, APL: Apollo Lake, GLK: Gemini Lake) | |
| KBLx (KBL: Kaby Lake, CFL: Coffe Lake, WHL: Whiskey Lake, CML: Comet Lake, AML: Amber Lake) | |
| CNL (Cannonlake) | |
| ICL (Icelake) | |
| TGLx (TGL: Tiger Lake, RKL: Rocket Lake) | |
| ADLx (ADL-S: Alder Lake S, ADL-P: Alder Lake P, ADL-N: Alder Lake N) | |
| XE_LP (DG1) | |
| XE_HP (XE_HP_SDV) | |
| XE_HPC (PVC: Ponte Vecchio) | |
| XE_HPG (DG2, ACM: Alchemist) | |
| Release Tags | |
| ============ | |
| Gmmlib Release tag versioning schema follows: | |
| | Tag ``intel-gmmlib-<x>.<y>.<z>`` will be stable release series with the same API and ABI version with only bug fixes where, | |
| | x = GMMLIB_API_MAJOR_VERSION + 10, | |
| | y = GMMLIB_API_MINOR_VERSION, | |
| | z = RELEASE NUMBER which is incremented as 0,1,2,...n for changes including new flag, bug fixes, etc. | |
| | | |
| | Example: | |
| | For GMM library ``libigdgmm.so.12.0.0``, | |
| | Tag = ``intel-gmmlib-22.0.0`` where, | |
| | 22 = GMMLIB_API_MAJOR_VERSION + 10 = 12 + 10 | |
| | 0 = GMMLIB_API_MINOR_VERSION | |
| | 0 = RELEASE NUMBER | |
| | | |
| On potential ABI break changes, | |
| | Tag ``intel-gmmlib-<x>.<y>.<z>`` becomes ``intel-gmmlib-<x + 1>.0.0`` | |
| | i.e ``intel-gmmlib-22.5.3`` becomes ``intel-gmmlib-23.0.0`` | |
| Known Issues and Limitations | |
| ============================ | |
| Current Gmmlib support only limited to Linux | |
| (*) Other names and brands may be claimed as property of others. | |
| --------------------------------------------------------------- | |