58bf403e8b
This update: * Clarifies the information about the acceptable source trees for updating the include/drm-uapi Mesa directory * Includes information about the current drm tree location * Expands the explanation of the process for generating the drm-uapi files * Expands the explanation of how what information to include in the Mesa commit that updates the drm-uapi files. Signed-off-by: Jordan Justen <jordan.l.justen@intel.com> Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29973>
42 lines
1.6 KiB
Plaintext
42 lines
1.6 KiB
Plaintext
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
|