Changeset 68df8455 for x


Ignore:
Timestamp:
06/14/2024 10:48:08 AM (3 weeks ago)
Author:
Xi Ruoyao <xry111@…>
Branches:
trunk
Children:
c9b65a3d, ebffd4b
Parents:
c7bab5e
git-author:
Xi Ruoyao <xry111@…> (06/14/2024 10:40:28 AM)
git-committer:
Xi Ruoyao <xry111@…> (06/14/2024 10:48:08 AM)
Message:

mesa: Update dependency & driver info

Rust code is only used for Nouveau vulkan driver, not swrast vulkan
driver.

libclc is used for the gallium driver but ply is used for the vulkan
driver, split them up.

Add a space after -D in commands and explanations.

Add -D vulkan-drivers into explanations, using a style like -D
gallium-drivers.

Add zink into gallium driver list.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • x/installing/mesa.xml

    rc7bab5e r68df8455  
    137137        <listitem>
    138138          <para>
    139             <xref linkend="libclc"/> and <xref linkend="ply"/> (required for
    140             the Intel drivers)
     139            <xref linkend="libclc"/> (required for the Intel iris
     140            gallium driver)
     141          </para>
     142        </listitem>
     143        <listitem>
     144          <para>
     145            <xref linkend="ply"/> (required for the Intel vulkan driver)
    141146          </para>
    142147        </listitem>
    … …  
    144149          <para>
    145150            <xref linkend="cbindgen"/> and <xref linkend="rust-bindgen"/>
    146             (required for the swrast Vulkan driver and the Nouveau driver)
     151            (required for the Nouveau Vulkan driver)
    147152          </para>
    148153        </listitem>
    … …  
    165170        have.  In some cases it is built into the CPU.  In others is is a
    166171        separate PCI card.  In either case you can tell what video hardware you
    167         have by running:
    168       </para>
    169 
    170       <para>
    171         <command>lspci | grep VGA</command>
    172       </para>
     172        have by installing <xref linkend='pciutils'/> and running:
     173      </para>
     174
     175      <screen role='nodump'><userinput>lspci | grep VGA</userinput></screen>
    173176
    174177      <para>
    175178        The video device is most likely one of three families: AMD, Intel, or
    176         Nvidia.  See the Command Explanations for 'gallium-drivers' below to
     179        Nvidia.  See the Command Explanations for
     180        <parameter>-D gallium-drivers=auto</parameter> below to
    177181        see what options are available for your specific video hardware (or
    178182        emulated video hardware).  You should probably add the swrast option as
    … …  
    193197        OpenGL for rendering video on the GPU. If you do not want to do this
    194198        you may or may not want to install them.
     199        See the Command Explanations for
     200        <parameter>-D vulkan-drivers=auto</parameter> below to
     201        see what options are available for your specific video hardware (or
     202        emulated video hardware).  You should probably add the swrast option
     203        as a backup driver unless you don't need Vulkan at all.
    195204      </para>
    196205    </note>
    … …  
    381390    <para>
    382391      To test the results, issue:
    383       <command>meson configure -Dbuild-tests=true &amp;&amp; ninja test</command>.
     392      <command>meson configure -D build-tests=true &amp;&amp; ninja test</command>.
    384393    </para>
    385394<!-- All 88 tests passed for me for 22.3.3 [pierre]
    … …  
    418427    <para>
    419428      <anchor id='mesa-gallium-drivers' xreflabel='Mesa Gallium3D Drivers'/>
    420       <parameter>-Dgallium-drivers=auto</parameter>: This parameter
     429      <parameter>-D gallium-drivers=auto</parameter>: This parameter
    421430      controls which Gallium3D drivers should be built:
    422431
    … …  
    425434          <para>
    426435            <literal>auto</literal> selects all Gallium3D drivers available
    427             for x86. With a comma-separated list, only a subset of these 
     436            for x86. With a comma-separated list, only a subset of these
    428437            drivers will be built. If you precisely know which drivers you
    429             need, you can build. for example.
    430             <option>-Dgallium-drivers=radeonsi,iris,swrast</option>.
     438            need, you can select them explicitly. for example.
     439            <option>-D gallium-drivers=radeonsi,iris,swrast</option>.
    431440          </para>
    432441        </listitem>
    … …  
    479488          <para>
    480489             <literal>iris</literal> (for Intel GPUs shipped with Broadwell
    481              or newer CPUs)
     490             or newer CPUs, or as a dedicated PCIe card)
    482491          </para>
    483492        </listitem>
    … …  
    495504          </para>
    496505        </listitem>
     506        <listitem>
     507          <para>
     508             <literal>zink</literal> (using Vulkan to implement OpenGL,
     509             it's not very useful on x86 as at now but it may replace other
     510             drivers for modern GPU models in the future)
     511          </para>
     512        </listitem>
    497513      </itemizedlist>
    498514    </para>
    499515
    500516    <para>
    501       <parameter>-Dplatforms=...</parameter>: This parameter
     517      <parameter>-D vulkan-drivers=auto</parameter>: This parameter
     518      controls which Gallium3D drivers should be built:
     519
     520      <itemizedlist spacing="compact">
     521        <listitem>
     522          <para>
     523            <literal>auto</literal> selects all Vulkan drivers available
     524            for x86. With a comma-separated list, only a subset of these
     525            drivers will be built. If you precisely know which drivers you
     526            need, you can select them explicitly. for example.
     527            <option>-D gallium-drivers=amd,nouveau,swrast</option>.
     528          </para>
     529        </listitem>
     530
     531        <listitem>
     532          <para>
     533            <literal>amd</literal> (for AMD Radeon HD 7730 or newer AMD GPUs)
     534          </para>
     535        </listitem>
     536
     537        <listitem>
     538          <para>
     539            <literal>intel</literal> (for Intel GPUs shipped with Skylake
     540            or newer CPUs, or as a dedicated PCIe card)
     541          </para>
     542        </listitem>
     543
     544        <listitem>
     545          <para>
     546            <literal>intel_hasvk</literal> (for Intel GPUs shipped with
     547            Ivy Bridge, Haswell, or Broadwell CPUs)
     548          </para>
     549        </listitem>
     550
     551        <listitem>
     552          <para>
     553            <literal>nouveau</literal> (for GTX 16XX, RTX 20XX, or
     554            newer NVIDIA GPUs)
     555          </para>
     556        </listitem>
     557
     558        <listitem>
     559          <para>
     560            <literal>swrast</literal> (using CPU for 3D rasterisation.
     561            Note that it's much slower than using a modern 3D-capable GPU,
     562            so it should be only used if the GPU is not supported by other
     563            drivers)
     564          </para>
     565        </listitem>
     566      </itemizedlist>
     567    </para>
     568
     569    <para>
     570      <parameter>-D platforms=...</parameter>: This parameter
    502571      controls which windowing systems will be supported. Available
    503572      linux platforms are x11 and wayland.
    … …  
    505574
    506575    <para>
    507       <parameter>-Dvulkan-drivers=auto</parameter>: This switch enables support
     576      <parameter>-D vulkan-drivers=auto</parameter>: This switch enables support
    508577      for the Vulkan graphics API. It automatically builds all graphics drivers
    509578      that are available for Vulkan. If you wish to build specific drivers,
    … …  
    514583
    515584    <para>
    516       <parameter>-Dvalgrind=disabled</parameter>: This parameter disables
     585      <parameter>-D valgrind=disabled</parameter>: This parameter disables
    517586      the usage of Valgrind during the build process. Remove this parameter
    518587      if you have Valgrind installed, and wish to check for memory leaks.
    … …  
    520589
    521590    <para>
    522       <parameter>-Dlibunwind=disabled</parameter>: This parameter disables
     591      <parameter>-D libunwind=disabled</parameter>: This parameter disables
    523592      the usage of libunwind.
    524593    </para>
    525594
    526595    <para>
    527       <command>meson configure -Dbuild-tests=true</command>: This command will
    528       reconfigure the build to set <option>-Dbuild-tests=true</option>, but
     596      <command>meson configure -D build-tests=true</command>: This command will
     597      reconfigure the build to set <option>-D build-tests=true</option>, but
    529598      keep the other options specified in the <command>meson setup</command>
    530599      command unchanged.  It allows <command>ninja test</command> to build and
    … …  
    533602
    534603    <para>
    535       <option>-Degl-native-platform="..."</option>: This parameter
     604      <option>-D egl-native-platform="..."</option>: This parameter
    536605      controls which Embedded Graphics Library support will be built. Available
    537606      linux options are auto (default), x11, wayland, surfaceless, and drm.
Note: See TracChangeset for help on using the changeset viewer.