From f69fe8c279934c64af1d48ed8e24a1712ec06d93 Mon Sep 17 00:00:00 2001 From: Erik Faye-Lund Date: Thu, 20 Oct 2022 11:45:29 +0200 Subject: [PATCH] docs: llvmpipe -> LLVMpipe Reviewed-by: David Heidelberg Part-of: --- docs/ci/docker.rst | 2 +- docs/drivers/llvmpipe.rst | 10 +++++----- docs/faq.rst | 2 +- docs/gallium/debugging.rst | 4 ++-- docs/history.rst | 2 +- docs/osmesa.rst | 4 ++-- docs/releasing.rst | 2 +- docs/sourcetree.rst | 4 ++-- 8 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/ci/docker.rst b/docs/ci/docker.rst index 7c5c6e11a1e..a51a1892951 100644 --- a/docs/ci/docker.rst +++ b/docs/ci/docker.rst @@ -1,7 +1,7 @@ Docker CI ========= -For llvmpipe and swrast CI, we run tests in a container containing +For LLVMpipe and swrast CI, we run tests in a container containing VK-GL-CTS, on the shared GitLab runners provided by `freedesktop `_ diff --git a/docs/drivers/llvmpipe.rst b/docs/drivers/llvmpipe.rst index 68624be55b0..2673402e682 100644 --- a/docs/drivers/llvmpipe.rst +++ b/docs/drivers/llvmpipe.rst @@ -4,7 +4,7 @@ LLVMpipe Introduction ------------ -The Gallium llvmpipe driver is a software rasterizer that uses LLVM to +The Gallium LLVMpipe driver is a software rasterizer that uses LLVM to do runtime code generation. Shaders, point/line/triangle rasterization and vertex processing are implemented with LLVM IR which is translated to x86, x86-64, or ppc64le machine code. Also, the driver is @@ -92,10 +92,10 @@ Environment variables ``LP_NATIVE_VECTOR_WIDTH`` We can use it to override vector bits. Because sometimes it turns - out llvmpipe can be fastest by using 128 bit vectors, + out LLVMpipe can be fastest by using 128 bit vectors, yet use AVX instructions. ``GALLIUM_OVERRIDE_CPU_CAPS`` - Override CPU capabilities for llvmpipe and softpipe, possible values for x86: + Override CPU capabilities for LLVMpipe and softpipe, possible values for x86: `nosse` `sse` `sse2` @@ -140,7 +140,7 @@ be used by replacing the native ICD driver, but it's quite an advanced usage, so you need to ask, don't even try it. There is however an easy way to replace the OpenGL software renderer -that comes with Microsoft Windows 7 (or later) with llvmpipe (that is, +that comes with Microsoft Windows 7 (or later) with LLVMpipe (that is, on systems without any OpenGL drivers): - copy @@ -177,7 +177,7 @@ On Linux, it is possible to have symbol resolution of JIT code with perf record -g /my/application perf report -When run inside Linux perf, llvmpipe will create a +When run inside Linux perf, LLVMpipe will create a ``/tmp/perf-XXXXX.map`` file with symbol address table. It also dumps assembly code to ``/tmp/perf-XXXXX.map.asm``, which can be used by the ``bin/perf-annotate-jit.py`` script to produce disassembly of the diff --git a/docs/faq.rst b/docs/faq.rst index 22b5e5fadf6..3d5e1ab08f2 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -200,7 +200,7 @@ and then install with ``sudo ninja install``. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If Mesa can't use its hardware accelerated drivers it falls back on one -of its software renderers. (e.g. classic swrast, softpipe or llvmpipe) +of its software renderers. (e.g. classic swrast, softpipe or LLVMpipe) You can run the ``glxinfo`` program to learn about your OpenGL library. Look for the ``OpenGL vendor`` and ``OpenGL renderer`` values. That will diff --git a/docs/gallium/debugging.rst b/docs/gallium/debugging.rst index 39e90476534..a567c09d115 100644 --- a/docs/gallium/debugging.rst +++ b/docs/gallium/debugging.rst @@ -80,11 +80,11 @@ Dump all commands going to the hardware. .. envvar:: LP_DEBUG (0x0) -Debug :ref:`flags` for the llvmpipe driver. +Debug :ref:`flags` for the LLVMpipe driver. .. envvar:: LP_NUM_THREADS (number of CPUs) -Number of threads that the llvmpipe driver should use. +Number of threads that the LLVMpipe driver should use. .. envvar:: FD_MESA_DEBUG (0x0) diff --git a/docs/history.rst b/docs/history.rst index 3c167f54a4d..449d99dd7af 100644 --- a/docs/history.rst +++ b/docs/history.rst @@ -88,7 +88,7 @@ Ongoing: Mesa is the OpenGL implementation for devices designed by Intel, AMD, NVIDIA, Qualcomm, Broadcom, Vivante, plus the VMware and VirGL virtual GPUs. There's also several software-based renderers: swrast (the legacy Mesa rasterizer), softpipe (a Gallium reference -driver) and llvmpipe (LLVM/JIT-based high-speed rasterizer). +driver) and LLVMpipe (LLVM/JIT-based high-speed rasterizer). Work continues on the drivers and core Mesa to implement newer versions of the OpenGL, OpenGL ES and Vulkan specifications. diff --git a/docs/osmesa.rst b/docs/osmesa.rst index 776a083708e..cf1c99d8758 100644 --- a/docs/osmesa.rst +++ b/docs/osmesa.rst @@ -13,7 +13,7 @@ information about the API functions. The OSMesa interface may be used with the gallium software renderers: -#. llvmpipe - this is the high-performance Gallium LLVM driver +#. LLVMpipe - this is the high-performance Gallium LLVM driver #. softpipe - this is the reference Gallium software driver There are several examples of OSMesa in the mesa/demos repository. @@ -28,7 +28,7 @@ Configure and build Mesa with something like: meson builddir -Dosmesa=true -Dgallium-drivers=swrast -Ddri-drivers=[] -Dvulkan-drivers=[] -Dprefix=$PWD/builddir/install ninja -C builddir install -Make sure you have LLVM installed first if you want to use the llvmpipe +Make sure you have LLVM installed first if you want to use the LLVMpipe driver. When the build is complete you should find: diff --git a/docs/releasing.rst b/docs/releasing.rst index 3a7170f45d7..b5c82c85297 100644 --- a/docs/releasing.rst +++ b/docs/releasing.rst @@ -142,7 +142,7 @@ Regression/functionality testing - *no regressions should be observed for Piglit/dEQP/CTS/Vulkan on Intel platforms* - *no regressions should be observed for Piglit using the swrast, - softpipe and llvmpipe drivers* + softpipe and LLVMpipe drivers* .. _stagingbranch: diff --git a/docs/sourcetree.rst b/docs/sourcetree.rst index b9a340ad790..80628036e24 100644 --- a/docs/sourcetree.rst +++ b/docs/sourcetree.rst @@ -135,11 +135,11 @@ each directory. device drivers - **clover** - OpenCL frontend - - **d3d10umd** - D3D10 frontend for Windows only. It's similar to Microsoft WARP, but using llvmpipe/softpipe. + - **d3d10umd** - D3D10 frontend for Windows only. It's similar to Microsoft WARP, but using LLVMpipe/softpipe. - **dri** - Meta frontend for DRI drivers, see mesa/state_tracker - **glx** - Meta frontend for GLX - **hgl** - Haiku OpenGL - - **lavapipe** - Vulkan frontend, software Vulkan rasterizer using llvmpipe. + - **lavapipe** - Vulkan frontend, software Vulkan rasterizer using LLVMpipe. - **nine** - D3D9 frontend, see targets/d3dadapter9 - **omx** - OpenMAX Bellagio frontend - **osmesa** - Off-screen OpenGL rendering library