| This directory contains a copy of the installed kernel headers | |
| required by several drivers to communicate with the kernel. | |
| Whenever one of those driver needs new definitions for new kernel | |
| APIs, these files should be updated. | |
| These files in upstream Mesa should only be updated once the changes | |
| have landed in the drm-next branch of the drm repository. | |
| The drm repository is currently located at: | |
| * https://gitlab.freedesktop.org/drm/kernel | |
| * git url: https://gitlab.freedesktop.org/drm/kernel.git | |
| Tagged Linux kernel releases can also be used. | |
| When using the drm repository, it is recommended that the headers are | |
| generated using a *merge commit* in the drm-next branch. After | |
| checking out the commit in the drm (or tagged Linux release) tree, the | |
| drm-uapi files can be generated by running this from the drm tree: | |
| $ make headers_install INSTALL_HDR_PATH=/path/to/install | |
| This will generate files under /path/to/install/include/drm which can | |
| be copied into the Mesa include/drm-uapi directory. It is not required | |
| to copy/update all kernel header files. | |
| The commit message for the Mesa drm-uapi update should include the | |
| full commit version of the drm kernel tree. An easy way to generate | |
| this is with the following command in the drm tree: | |
| $ git log -1 --pretty=short --no-decorate | |
| Which would produce output similar to this to include in the Mesa | |
| commit: | |
| commit a78313bb206e0c456a989f380c4cbd8af8af7c76 | |
| Merge: 365aa9f57399 79655e867ad6 | |
| Author: Dave Airlie <airlied@redhat.com> | |
| Merge tag 'drm-intel-gt-next-2024-06-12' of https://gitlab.freedesktop.org/drm/i915/kernel into drm-next |