From 4d2c8bf85991a12e1b1ef5838b17c2bf60a142b7 Mon Sep 17 00:00:00 2001 From: Alyssa Rosenzweig Date: Thu, 30 Mar 2023 11:37:43 -0400 Subject: [PATCH] docs: Remove docs about macOS hardware drivers We dropped support for hardware macOS drivers in afe134a49c5 ("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 Part-of: --- docs/drivers/asahi.rst | 26 +++----------------------- docs/macos.rst | 2 -- 2 files changed, 3 insertions(+), 25 deletions(-) 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!