diff --git a/docs/drivers/asahi.rst b/docs/drivers/asahi.rst index 841d77e3cce..d9aa24380c0 100644 --- a/docs/drivers/asahi.rst +++ b/docs/drivers/asahi.rst @@ -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 diff --git a/docs/macos.rst b/docs/macos.rst index 018ab19af36..c74ee394aa5 100644 --- a/docs/macos.rst +++ b/docs/macos.rst @@ -22,5 +22,3 @@ to X11 applications on macOS running via XQuartz. Mesa's software rasterizers also work on macOS. To build, set the build options ``-Dosmesa=true -Dglx=xlib`` and select an appropriate Gallium software rasterizer. - -For native hardware, stay tuned for updates here!