docs: Remove docs about macOS hardware drivers

We dropped support for hardware macOS drivers in afe134a49c ("asahi: Drop macOS
backend"), so drop the corresponding documentation. Layered and software drivers
are still supported on macOS for better or worse, so the main "Notes on macOS"
page can stay I think.

Signed-off-by: Alyssa Rosenzweig <alyssa@rosenzweig.io>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22213>
This commit is contained in:
Alyssa Rosenzweig
2023-03-30 11:37:43 -04:00
committed by Marge Bot
parent 31778ac869
commit 4d2c8bf859
2 changed files with 3 additions and 25 deletions

View File

@@ -3,34 +3,14 @@ Asahi
The Asahi driver aims to provide an OpenGL implementation for the Apple M1.
Testing on macOS
-----------------
On macOS, the experimental Asahi driver may built with options:
-Dosmesa=true -Dglx=xlib -Dgallium-drivers=asahi,swrast
To use, set the ``DYLD_LIBRARY_PATH`` environment variable:
.. code-block:: console
DYLD_LIBRARY_PATH=/Users/nobody/mesa/build/src/gallium/targets/libgl-xlib/ glmark2 --reuse-context
Only X11 apps are supported. XQuartz must be setup separately.
Wrap (macOS only)
-----------------
Mesa includes a library that wraps the key IOKit entrypoints used in the macOS
UABI for AGX. The wrapped routines print information about the kernel calls made
and dump work submitted to the GPU using agxdecode.
This library allows debugging Mesa, particularly around the undocumented macOS
user-kernel interface. Logs from Mesa may compared to Metal to check that the
UABI is being used correctly.
Furthermore, it allows reverse-engineering the hardware, as glue to get at the
"interesting" GPU memory.
and dump work submitted to the GPU using agxdecode. This facilitates
reverse-engineering the hardware, as glue to get at the "interesting" GPU
memory.
The library is only built if ``-Dtools=asahi`` is passed. It builds a single
``wrap.dylib`` file, which should be inserted into a process with the