About Social Code
aboutsummaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2025-11-06docs: Give more reproducible instructions for how to build the docs.Emma Anholt
I routinely don't update the docs because the build (hawkmoth in particular) is a pain. The prior instructions almost worked, except that on Debian you need to use a venv (which is a good idea to do for py3-clang as well for reproducibility, anyway), and the versions that were listed didn't actually run any more due to a revoked dependency. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38266>
2025-11-06vulkan/runtime: Add an environment variable to validate shader binariesFaith Ekstrand
Setting MESA_VK_VALIDATE_SHADER_BINARIES will cause the shader code to round-trip every shader through [de]serialize and only ever use the deserialized version. This catches bugs where the driver may drop things in the [de]serialization process. It also deserializes the new shader again and compares it against the original to ensure that deserialize -> serialize is idempotent. Acked-by: Eric R. Smith <eric.smith@collabora.com> Reviewed-by: Lars-Ivar Hesselberg Simonsen <lars-ivar.simonsen@arm.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36647>
2025-11-05docs/perfetto: Put V3D at the same level of heading as other drivers.Emma Anholt
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05docs/perfetto: Be more clear about the role of MESA_GPU_TRACES=perfettoEmma Anholt
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05docs/perfetto: Explain using tracebox, and put commands in the list.Emma Anholt
This binary that perfetto builds automatically launches traced and traced_probes, doesn't need tmux installed, doesn't need you to know tmux ui, and doesn't need the tmux helper script hacked to not call the wrong arch's ninja if you cross compiled. Also, it's silly to send people into an explanation and links to docs, when we have the instructions they actually want below. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05docs/perfetto: Give a hint on how to cross compile the tools.Emma Anholt
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05docs/perfetto: Be helpful and opinionated about config selection.Emma Anholt
system.cfg should be your go-to, regardless of driver. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05docs/perfetto: Add row for panvk support.Emma Anholt
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37826>
2025-11-05pvr: add device info for GE8300 (22.67.54.30)Alessio Belle
Requested by the community [1]. [1] https://gitlab.freedesktop.org/imagination/linux-firmware/-/issues/13 Signed-off-by: Alessio Belle <alessio.belle@imgtec.com> Reviewed-by: Simon Perretta <simon.perretta@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38211>
2025-11-05pvr: add device info for GE7800 (15.5.1.64)Alessio Belle
Requested by the community [1]. [1] https://gitlab.freedesktop.org/imagination/linux-firmware/-/issues/13 Signed-off-by: Alessio Belle <alessio.belle@imgtec.com> Reviewed-by: Simon Perretta <simon.perretta@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38211>
2025-11-04nvk: VK_EXT_shader_uniform_buffer_unsized_arrayFaith Ekstrand
Reviewed-by: Mel Henning <mhenning@darkrefraction.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38230>
2025-11-01kk: enable VK_KHR_vertex_attribute_divisorArcady Goldmints-Orlov
And also VK_EXT_vertex_attribute_divisor Reviewed-by: Aitor Camacho <aitor@lunarg.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38154>
2025-11-01kk: enable VK_KHR_workgroup_memory_explicit_layoutArcady Goldmints-Orlov
Reviewed-by: Aitor Camacho <aitor@lunarg.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38154>
2025-10-31radv: advertise VK_KHR_maintenance10Samuel Pitoiset
Signed-off-by: Samuel Pitoiset <samuel.pitoiset@gmail.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38043>
2025-10-30nvk: Add an NVK_DEBUG=coherent flagFaith Ekstrand
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38163>
2025-10-30nvk: Document some environment variablesFaith Ekstrand
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38163>
2025-10-30radv: remove some RADV_DEBUG deprecated optionsSamuel Pitoiset
They have been marked as deprecated in 25.3, so one release cycle before they are removed completely. Signed-off-by: Samuel Pitoiset <samuel.pitoiset@gmail.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38085>
2025-10-29docs/envvars: Remove references to nineMel Henning
nine is gone, so no need to document its env vars. Reviewed-by: Emma Anholt <emma@anholt.net> Reviewed-by: David Heidelberg <david@ixit.cz> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37828>
2025-10-29docs/nvk: Document NVK_DEBUG=trash_memoryMel Henning
Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37828>
2025-10-29docs/nvk: Update hardware supportMel Henning
Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37828>
2025-10-29docs/nvk: Add some developer hardware docsMel Henning
Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37828>
2025-10-29docs/nvk: Add a list of external hardware docsMel Henning
Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37828>
2025-10-29docs: Reorder VK_EXT_image_robustnessAitor Camacho
Acked-by: Alyssa Rosenzweig <alyssa.rosenzweig@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38137>
2025-10-29docs: Add KosmicKrisp to VulkanAitor Camacho
Acked-by: Alyssa Rosenzweig <alyssa.rosenzweig@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38137>
2025-10-29docs: add sha sum for 25.2.6Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38142>
2025-10-29docs: add release notes for 25.2.6Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38142>
2025-10-29docs: update calendar for 25.2.6Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38142>
2025-10-29panvk: support VK_EXT_device_memory_reportYiwei Zhang
This change adds the minimum support for VK_EXT_device_memory_report, which only reports device memory events at this point. We can make it more useful later (like what's done in ANV) if desired by some tools. Reviewed-by: Christoph Pillmayer <christoph.pillmayer@arm.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37987>
2025-10-29radeonsi: enable ACO by defaultMarek Olšák
NIR+ACO is the best SSA-based shader compiler for AMD GPUs that exists. There are many reasons why NIR+ACO is better than LLVM, and I have a long list that I've collected over the years, but the major ones are better GPU performance (faster GPU memory access thanks to better clauses and scheduling, a lot less SGPR/VGPR spilling, better loop support, slightly smaller shader binaries), 8x lower shader compile times, and smaller memory footprint of the IR. It also shows that NIR is a mature SSA-based shader compiler that helps drivers generate optimized code very quickly. And most importantly, radeonsi has slightly better Viewperf performance with NIR+ACO than LLVM, and that's difficult to ignore. Reviewed-by: Qiang Yu <yuq825@gmail.com> Reviewed-by: Pierre-Eric Pelloux-Prayer <pierre-eric.pelloux-prayer@amd.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38070>
2025-10-28radv: advertise VK_EXT_shader_uniform_buffer_unsized_arraySamuel Pitoiset
Signed-off-by: Samuel Pitoiset <samuel.pitoiset@gmail.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38047>
2025-10-27nvk: Advertise VK_KHR_maintenance10Faith Ekstrand
Reviewed-by: Mel Henning <mhenning@darkrefraction.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38094>
2025-10-27anv: implement VK_KHR_maintenance10Lionel Landwerlin
Signed-off-by: Lionel Landwerlin <lionel.g.landwerlin@intel.com> Reviewed-by: Faith Ekstrand <faith.ekstrand@collabora.com> Reviewed-by: Alyssa Rosenzweig <alyssa.rosenzweig@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38045>
2025-10-27docs/envvars: Add section: Android System PropertiesTim Van Patten
Add documentation describing Android system property usage in Mesa. For example, how environment varible names are translated by os_get_option(), how to get/set values, and corresponding example commands. A new section is added to doc/envvars.rst which points to the full details within the new "Android System Properties" section in docs/android.rst. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37942>
2025-10-27hk: Enable VK_KHR_present_id[2] and VK_KHR_present_wait[2]Mario Kleiner
These extensions are implemented in shared Vulkan/WSI code and not driver specific. A Vulkan driver just needs to support VK_KHR_timeline_semaphore, which Honeykrisp already supports since its inclusion into Mesa. Successfully tested on Apple MacBookAir 2020 with M1 SoC on top of KDE KWin 6.4 and GNOME mutter 48. Signed-off-by: Mario Kleiner <mario.kleiner.de@gmail.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38069>
2025-10-24iris: Enable GL_KHR_shader_subgroup_* extensions for Gfx >= 9 when possibleCaio Oliveira
For platforms that don't have native float64 support, skip the arithmetic and clustered ops. While they would work, the lowering for float64 for those increase significantly the shader for some of those operations. Reviewed-by: Kenneth Graunke <kenneth@whitecape.org> Reviewed-by: Ian Romanick <ian.d.romanick@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/35844>
2025-10-22docs: update/fix vk spec urlsEric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37993>
2025-10-21nvk: implement VK_EXT_discard_rectanglesLorenzo Rossi
Reviewed-by: Mel Henning <mhenning@darkrefraction.com> Signed-off-by: Lorenzo Rossi <git@rossilorenzo.dev> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/33476>
2025-10-21panvk: support VK_EXT_external_memory_acquire_unmodifiedYiwei Zhang
Upon acquiring an external image from external/foreign queue family, skip AFBC metadata invalidation if the app has explicitly requested acquireUnmodifiedMemory. This also applies to CRC which may or may not get hooked up later. Reviewed-by: John Anthony <john.anthony@arm.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37972>
2025-10-17pvr: Advertise VK_KHR_storage_buffer_storage_classFrank Binns
Signed-off-by: Frank Binns <frank.binns@imgtec.com> Reviewed-by: Karmjit Mahil <karmjit.mahil@igalia.com> Reviewed-by: Simon Perretta <simon.perretta@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37913>
2025-10-17pvr: Advertise VK_KHR_relaxed_block_layoutFrank Binns
This is already supported by the compiler and all the relevant conformance tests pass. Signed-off-by: Frank Binns <frank.binns@imgtec.com> Reviewed-by: Karmjit Mahil <karmjit.mahil@igalia.com> Reviewed-by: Simon Perretta <simon.perretta@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37913>
2025-10-16docs: update calendar for 25.3.0-rc1Dylan Baker
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37921>
2025-10-16docs: Update LAVA caching setupValentine Burley
After a recent change, `piglit-traces.sh` automatically sets the caching proxy, so update the docs to reflect this. Also update the name of the variable from `FDO_HTTP_CACHE_URI` to `LAVA_HTTP_CACHE_URI`. Fixes: fa74e939bfd ("ci/piglit: automatically use LAVA proxy") Signed-off-by: Valentine Burley <valentine.burley@collabora.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37862>
2025-10-16docs: reset new_features.txtDylan Baker
Signed-off-by: Dylan Baker <dylan.c.baker@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37901>
2025-10-15nvk: Implement VK_NVX_image_view_handleAutumn Ashton
This is used by DLSS to pass in image view descriptors via parameter buffers for its kernel launches. Signed-off-by: Autumn Ashton <misyl@froggi.es> Reviewed-by: Faith Ekstrand <faith.ekstrand@collabora.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37889>
2025-10-15docs: add sha sum for 25.2.5Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37895>
2025-10-15docs: add release notes for 25.2.5Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37895>
2025-10-15docs: update calendar for 25.2.5Eric Engestrom
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37895>
2025-10-15pvr: enable KHR_wayland_surfaceErico Nunes
Just expose the extension to enable Wayland WSI. The current use case for this is being able to run Wayland clients on e.g. an offscreen compositor. Signed-off-by: Erico Nunes <nunes.erico@gmail.com> Reviewed-by: Frank Binns <frank.binns@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37721>
2025-10-14zink: enable GL_EXT_mesh_shaderMike Blumenkrantz
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37788>
2025-10-14pvr: implement buffer device addressElla Stanforth
Reviewed-by: Frank Binns <frank.binns@imgtec.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37726>