source: x/installing/mesa.xml@ 7eeacb7

trunk
Last change on this file since 7eeacb7 was 899751e, checked in by Douglas R. Reno <renodr@…>, 2 weeks ago

mesa: use version -3 of the patch to fix a FTBFS
  • Property mode set to 100644
File size: 26.8 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mesa-download-http "https://mesa.freedesktop.org/archive/mesa-&mesa-version;.tar.xz">
8 <!ENTITY mesa-download-ftp " ">
9 <!ENTITY mesa-md5sum "c50cf79f8ebb6740af8b7a7207310ee1">
10 <!ENTITY mesa-size "28 MB">
11 <!ENTITY mesa-buildsize "959 MB (with docs, add 538 MB for tests)">
12 <!ENTITY mesa-time "3.0 SBU (with docs; add 1.0 SBU for tests; both with parallelism=4)">
13]>
14
15<sect1 id="mesa" xreflabel="Mesa-&mesa-version;">
16 <?dbhtml filename="mesa.html"?>
17
18 <title>Mesa-&mesa-version;</title>
19
20 <indexterm zone="mesa">
21 <primary sortas="a-Mesa">Mesa</primary>
22 </indexterm>
23
24 <sect2 role="package">
25 <title>Introduction to Mesa</title>
26
27 <para>
28 <application>Mesa</application> is an OpenGL compatible 3D graphics
29 library.
30 </para>
31
32 <note>
33 <para>
34 <application>Mesa</application> is updated relatively often. You may
35 want to use the latest available &mesa-major-minor;.x mesa version.
36 </para>
37 </note>
38
39 &lfs122_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&mesa-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&mesa-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &mesa-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &mesa-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &mesa-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &mesa-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <!-- 9 Apr 23. Change to unversioned patch since it never changes. -->
78 <listitem>
79 <para>
80 Recommended patch:
81 <ulink url="&patch-root;/mesa-add_xdemos-3.patch"/>
82 (installs 2 demo programs for testing Mesa - not needed if you
83 install the <ulink url="https://archive.mesa3d.org/demos/">
84 mesa-demos</ulink> package)
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Required</bridgehead>
92 <para role="required">
93 <xref linkend="xorg7-lib"/>,
94 <xref linkend="libdrm"/>,
95 <xref linkend="Mako"/>, and
96 <xref linkend="PyYAML"/>
97 </para>
98
99 <bridgehead renderas="sect4">Recommended</bridgehead>
100 <para role="recommended">
101
102 <itemizedlist spacing="compact">
103 <listitem>
104 <para>
105 <xref linkend="glslang"/> (required for Vulkan support)
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 <xref linkend="libva"/> (to provide VA-API support for some
111 gallium drivers. Note that there is a circular dependency.
112 You must build <application>libva</application> first without
113 mesa's EGL and GLX support, install this package, and rebuild
114 <application>libva</application>)
115 </para>
116 </listitem>
117 <listitem>
118 <para>
119 <xref linkend="libvdpau"/> (to build VDPAU drivers)
120 </para>
121 </listitem>
122 <listitem>
123 <para>
124 <xref linkend="llvm"/> (required for the r300, r600, and radeonsi
125 drivers, and the LLVMpipe software rasterizer which can make the
126 swrast driver much faster)
127 </para>
128 </listitem>
129 <listitem>
130 <para>
131 <xref linkend="wayland-protocols"/> (required for
132 <xref role="nodep" linkend='plasma-build'/>,
133 GNOME, and recommended for
134 <xref role="nodep" linkend='gtk3'/>)
135 </para>
136 </listitem>
137 <listitem>
138 <para>
139 <xref linkend="libclc"/> (required for the Intel iris
140 gallium driver)
141 </para>
142 </listitem>
143 <listitem>
144 <para>
145 <xref linkend="vulkan-loader"/> (required for the Zink
146 gallium driver)
147 </para>
148 </listitem>
149 <listitem>
150 <para>
151 <xref linkend="ply"/> (required for the Intel vulkan driver)
152 </para>
153 </listitem>
154 <listitem>
155 <para>
156 <xref linkend="cbindgen"/> and <xref linkend="rust-bindgen"/>
157 (required for the Nouveau Vulkan driver)
158 </para>
159 </listitem>
160 </itemizedlist>
161 </para>
162
163 <note>
164 <para>
165 <emphasis role="bold">Choosing Mesa Drivers</emphasis>
166 </para>
167
168 <para>
169 In the instructions below, all the available drivers are built. That
170 will almost always work. However, it is not efficient. Depending on
171 your video hardware, you probably need only specific drivers.
172 </para>
173
174 <para>
175 The first thing you need to know is which type of video device you
176 have. In some cases it is built into the CPU. In others it is a
177 separate PCI card. In either case you can tell what video hardware you
178 have by installing <xref linkend='pciutils'/> and running:
179 </para>
180
181 <screen role='nodump'><userinput>lspci | grep VGA</userinput></screen>
182
183 <para>
184 The video device is most likely one of three families: AMD, Intel, or
185 Nvidia. See the Command Explanations for
186 <parameter>-D gallium-drivers=auto</parameter> below to
187 see what options are available for your specific video hardware (or
188 emulated video hardware). You should probably add the swrast option as
189 a backup driver.
190 </para>
191
192 <para>
193 For 'platforms' you can select x11 and/or wayland. Note that in BLFS
194 currently only Gnome and KDE can use wayland. If you are not going to
195 use one of those desktop environments then you probably only want x11.
196 </para>
197
198 <para>
199 For 'vulkan-drivers' you may want to limit the selection to your
200 current hardware. These drivers are used by some specific applications.
201
202 For example, ffmpeg (including ffplay) will use Vulkan instead of
203 OpenGL for rendering video on the GPU. If you do not want to do this
204 you may or may not want to install them.
205 See the Command Explanations for
206 <parameter>-D vulkan-drivers=auto</parameter> below to
207 see what options are available for your specific video hardware (or
208 emulated video hardware). You should probably add the swrast option
209 as a backup driver unless you don't need Vulkan at all.
210 </para>
211 </note>
212
213 <bridgehead renderas="sect4">Optional</bridgehead>
214 <para role="optional">
215 <xref linkend="libgcrypt"/>,
216 <xref linkend="libunwind"/>,
217 <xref linkend="lm_sensors"/> <!-- for libsensors according to Meson -->,
218 <xref linkend="nettle"/>,
219 <xref linkend="valgrind"/>,
220 <ulink url="https://archive.mesa3d.org/demos/">mesa-demos</ulink>
221 (provides more than 300 extra demos to test
222 <application>Mesa</application>; this includes the same programs added by
223 the patch above),
224 <ulink url="https://omxil.sourceforge.net/">Bellagio OpenMAX Integration
225 Layer</ulink> (for mobile platforms), and
226 <!--<ulink url="https://github.com/KhronosGroup/glslang">glslang</ulink>
227 (for vulkan drivers),-->
228 <ulink url="https://github.com/tizonia/tizonia-openmax-il/wiki/Tizonia-OpenMAX-IL/">
229 libtizonia</ulink>,
230 <!-- <ulink url="https://github.com/KhronosGroup/Vulkan-Loader">Vulkan-Loader</ulink> -->
231 </para>
232<!--
233 <note>
234 <para>
235 The instructions below assume that
236 <application>LLVM</application> with the r600/amdgpu and host backends
237 and run-time type information (RTTI - needed for nouveau) are installed.
238 You will need to modify the instructions if you
239 choose not to install all of these. For an explanation of Gallium3D see
240 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
241 </para>
242 </note>
243-->
244
245 &build-use-internet;
246
247 </sect2>
248
249 <sect2 role="kernel" id="mesa-kernel"
250 xreflabel='Mesa Kernel Configuration'>
251 <title>Kernel Configuration</title>
252
253 <para>
254 Enable the following options in the kernel configuration and
255 recompile the kernel if necessary:
256 </para>
257
258 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
259 href="mesa-kernel.xml"/>
260
261 <note>
262 <para>
263 The corresponding Mesa Gallium3D driver name is provided as the
264 comment for the configuration entries. If you don't know the name
265 of the Mesa Gallium3D driver for your GPU, see <xref
266 linkend="mesa-gallium-drivers"/> below.
267 </para>
268
269 <para>
270 <option>CONFIG_DRM_RADEON</option>,
271 <option>CONFIG_DRM_AMDGPU</option>,
272 <option>CONFIG_DRM_NOUVEAU</option>, and
273 <option>CONFIG_DRM_I915</option> may require firmware.
274 See <xref linkend='postlfs-firmware'/> for details.
275 </para>
276
277 <para>
278 Selecting <option>CONFIG_DRM_RADEON</option> or
279 <option>CONFIG_DRM_AMDGPU</option> as
280 <quote><literal>y</literal></quote> is not recommended. If it is, any
281 required firmware must be built as a part of the kernel image or the
282 initramfs for the driver to function correctly.
283 </para>
284
285 <para>
286 The sub-entries under <option>CONFIG_DRM_AMDGPU</option> are used
287 to ensure the AMDGPU kernel driver supports all GPUs using the
288 <literal>radeonsi</literal> driver. They are not needed if you
289 won't need <option>CONFIG_DRM_AMDGPU</option> itself. They
290 may be unneeded for some GPU models.
291 </para>
292
293 <para>
294 For <literal>swrast</literal>, <option>CONFIG_DRM_VGEM</option>
295 is not strictly needed but recommended as an optimization.
296 </para>
297 </note>
298 <indexterm zone="mesa mesa-kernel">
299 <primary sortas="d-mesa">mesa</primary>
300 </indexterm>
301 </sect2>
302
303 <sect2 role="installation">
304 <title>Installation of Mesa</title>
305 <para>
306 If you have downloaded the xdemos patch (needed if testing the Xorg
307 installation per BLFS instructions), apply it by running the following
308 command:
309 </para>
310
311<!--<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>-->
312<screen><userinput>patch -Np1 -i ../mesa-add_xdemos-3.patch</userinput></screen>
313
314 <!-- Note that freedreno, vc4, and virgl all need special support from
315 libdrm - renodr
316 For me, libdrm does not mention virgl, but mesa accepts it. AFAICS
317 freedreno is for qualcom hardware, libdrm will build for it on suitable
318 systems. VC4 is for the Broadcom VC4 used in the raspberry pi - ken -->
319<!--
320 <note>
321 <para>
322 The measurements above, and the Contents below, are for a full build.
323 Many people will not wish to install drivers they cannot use, so the
324 following paragraphs explain how to limit the drivers, and give an
325 example which can be be reduced or amended as necessary.
326 </para>
327 </note>
328
329-->
330<!--
331 <para>
332 The (non-gallium) DRI drivers available in X86 are auto, <emphasis>or
333 alternatively a choice from</emphasis> i915, i965, nouveau, r100, r200,
334 and swrast. Use 'auto' to build all available DRI drivers, or use an
335 empty string (DRI_DRIVERS="") if you wish to only build gallium drivers.
336 </para>
337
338 <para>
339 The platforms ("window systems") available for X86 linux are x11, wayland,
340 drm, and surfaceless. By not specifying anything, the meson
341 build-system will build for all these platforms if you have the
342 dependencies, identical to if you had specified '-Dplatforms=auto'.
343 </para>
344
345 <para>
346 Modify the commands below for your desired drivers. The drivers listed
347 below will cover most modern video cards and virtual machines. For help in
348 selecting drivers see <ulink url="https://docs.mesa3d.org/systems.html"/>.
349-->
350 <!-- these two don't seem to be mentioned in that mesa link -->
351<!--
352 For intel drivers, specify crocus for i965 gen 4 through to haswell, iris
353 for broadwell and later.
354 </para>
355
356 <note>
357 <para>
358 Although the nouveau drivers can be built for both gallium and dri, the
359 i915 driver can only be built for one or the other.
360 </para>
361 </note>
362
363<screen><userinput>GALLIUM_DRV="crocus,i915,iris,nouveau,r600,radeonsi,svga,swrast,virgl"
364DRI_DRIVERS="i965,nouveau"</userinput></screen>
365-->
366
367 <!-- https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22021 -->
368<!-- No longer needed
369 <para>
370 Remove two unneeded references to LLVM headers to avoid a build
371 failure with LLVM 17 or later:
372 </para>
373
374<screen><userinput>sed '/Scalar.h/d;/Utils.h/d' \
375 -i src/gallium/auxiliary/gallivm/lp_bld_init.c</userinput></screen>
376-->
377 <para>
378 Install <application>Mesa</application> by running the following
379 commands:
380 </para>
381
382<screen><userinput>mkdir build &amp;&amp;
383cd build &amp;&amp;
384
385meson setup .. \
386 --prefix=$XORG_PREFIX \
387 --buildtype=release \
388 -D platforms=x11,wayland \
389 -D gallium-drivers=auto \
390 -D vulkan-drivers=auto \
391 -D valgrind=disabled \
392 -D libunwind=disabled &amp;&amp;
393
394ninja</userinput></screen>
395
396 <para>
397 To test the results, issue:
398 <command>meson configure -D build-tests=true &amp;&amp; ninja test</command>.
399 </para>
400<!-- All 88 tests passed for me for 22.3.3 [pierre]
401 All 90 tests passed for me for 23.1.0 [bdubbs]
402 89 Tests passed for me, 1 timeout on 23.1.8 [rahul]
403 All 98 tests passed for me for 23.3.1 [bdubbs]
404-->
405
406 <para>
407 Now, as the <systemitem class="username">root</systemitem> user:
408 </para>
409
410<screen role="root"><userinput>ninja install</userinput></screen>
411
412 <para>
413 If desired, install the optional documentation by running
414 the following commands as the
415 <systemitem class="username">root</systemitem> user:
416 </para>
417
418<screen role="root"
419 remap="doc"><userinput>cp -rv ../docs -T /usr/share/doc/mesa-&mesa-version;</userinput></screen>
420
421 </sect2>
422
423 <sect2 role="commands">
424 <title>Command Explanations</title>
425
426 <para>
427 <parameter>--buildtype=release</parameter>: This switch ensures a
428 fully-optimized build, and disables debug assertions which will
429 severely slow down the libraries in certain use-cases. Without this
430 switch, build sizes can span into the 2 GB range.
431 </para>
432
433 <para>
434 <anchor id='mesa-gallium-drivers' xreflabel='Mesa Gallium3D Drivers'/>
435 <parameter>-D gallium-drivers=auto</parameter>: This parameter
436 controls which Gallium3D drivers should be built:
437
438 <itemizedlist spacing="compact">
439 <listitem>
440 <para>
441 <literal>auto</literal> selects all Gallium3D drivers available
442 for x86. With a comma-separated list, only a subset of these
443 drivers will be built. If you precisely know which drivers you
444 need, you can select them explicitly. For example,
445 <option>-D gallium-drivers=radeonsi,iris,swrast</option>.
446 </para>
447 </listitem>
448 <listitem>
449 <para>
450 <literal>r300</literal> (for ATI Radeon 9000 or Radeon X series)
451 </para>
452 </listitem>
453 <listitem>
454 <para>
455 <literal>r600</literal> (for AMD/ATI Radeon HD 2000-6000 series)
456 </para>
457 </listitem>
458 <listitem>
459 <para>
460 <literal>radeonsi</literal> (for AMD Radeon HD 7000 or newer AMD GPU models)
461 </para>
462 </listitem>
463 <listitem>
464 <para>
465 <literal>nouveau</literal> (for supported NVIDIA GPUs, they are
466 listed as all <quote>3D features</quote> either <quote>DONE</quote> or
467 <quote>N/A</quote> in
468 <ulink url='https://nouveau.freedesktop.org/FeatureMatrix.html'>the Nouveau
469 status page</ulink>)
470 </para>
471 </listitem>
472 <listitem>
473 <para>
474 <literal>virgl</literal> (for a QEMU virtual GPU
475 with <application>virglrender</application> support; note that BLFS
476 <xref linkend='qemu'/> is not built with
477 <application>virglrender</application>)
478 </para>
479 </listitem>
480 <listitem>
481 <para>
482 <literal>svga</literal> (for a VMWare virtual GPU)
483 </para>
484 </listitem>
485 <listitem>
486 <para>
487 <literal>swrast</literal> (using CPU for 3D
488 rasterization. Note that it's much slower than using a modern
489 3D-capable GPU, so it should be only used if the GPU is not supported
490 by other drivers),
491 </para>
492 </listitem>
493 <listitem>
494 <para>
495 <literal>iris</literal> (for Intel GPUs shipped with Broadwell
496 or newer CPUs, or as a dedicated PCIe card)
497 </para>
498 </listitem>
499 <listitem>
500 <para>
501 <literal>crocus</literal> (for Intel GMA 3000, X3000 series,
502 4000 series, or X4000 series GPUs shipped with chipsets,
503 or Intel HD GPUs shipped with pre-Broadwell CPUs)
504 </para>
505 </listitem>
506 <listitem>
507 <para>
508 <literal>i915</literal> (for Intel GMA 900, 950, 3100, or 3150 GPUs
509 shipped with chipsets or Atom D/N 4xx/5xx CPUs)
510 </para>
511 </listitem>
512 <listitem>
513 <para>
514 <literal>zink</literal> (using Vulkan to implement OpenGL,
515 it's not very useful on x86 as at now but it may replace other
516 drivers for modern GPU models in the future)
517 </para>
518 </listitem>
519 </itemizedlist>
520 </para>
521
522 <para>
523 <parameter>-D vulkan-drivers=auto</parameter>: This parameter
524 controls which Vulkan drivers should be built:
525
526 <itemizedlist spacing="compact">
527 <listitem>
528 <para>
529 <literal>auto</literal> selects all Vulkan drivers available
530 for x86. With a comma-separated list, only a subset of these
531 drivers will be built. If you precisely know which drivers you
532 need, you can select them explicitly. For example,
533 <option>-D vulkan-drivers=amd,nouveau,swrast</option>.
534 </para>
535 </listitem>
536
537 <listitem>
538 <para>
539 <literal>amd</literal> (for AMD Radeon HD 7730 or newer AMD GPUs)
540 </para>
541 </listitem>
542
543 <listitem>
544 <para>
545 <literal>intel</literal> (for Intel GPUs shipped with Skylake
546 or newer CPUs, or as a dedicated PCIe card)
547 </para>
548 </listitem>
549
550 <listitem>
551 <para>
552 <literal>intel_hasvk</literal> (for Intel GPUs shipped with
553 Ivy Bridge, Haswell, or Broadwell CPUs)
554 </para>
555 </listitem>
556
557 <listitem>
558 <para>
559 <literal>nouveau</literal> (for GTX 16XX, RTX 20XX, or
560 newer NVIDIA GPUs)
561 </para>
562 </listitem>
563
564 <listitem>
565 <para>
566 <literal>swrast</literal> (for using the CPU for 3D rasterization)
567 Note that it's much slower than using a modern 3D-capable GPU,
568 so it should be only used if the GPU is not supported by other
569 drivers.
570 </para>
571 </listitem>
572
573 <listitem>
574 <para>
575 <literal>""</literal> (empty list, use
576 <option>-D vulkan-drivers=""</option> if you've not installed and
577 you don't plan to install <xref linkend='vulkan-loader'/>)
578 </para>
579 </listitem>
580 </itemizedlist>
581 </para>
582
583 <para>
584 <parameter>-D platforms=...</parameter>: This parameter
585 controls which windowing systems will be supported. Available
586 linux platforms are x11 and wayland.
587 </para>
588
589 <para>
590 <parameter>-D valgrind=disabled</parameter>: This parameter disables
591 the usage of Valgrind during the build process. Remove this parameter
592 if you have Valgrind installed, and wish to check for memory leaks.
593 </para>
594
595 <para>
596 <parameter>-D libunwind=disabled</parameter>: This parameter disables
597 the usage of libunwind.
598 </para>
599
600 <para>
601 <command>meson configure -D build-tests=true</command>: This command will
602 reconfigure the build to set <option>-D build-tests=true</option>, but
603 keep the other options specified in the <command>meson setup</command>
604 command unchanged. It allows <command>ninja test</command> to build and
605 run unit tests.
606 </para>
607
608 <para>
609 <option>-D egl-native-platform="..."</option>: This parameter
610 controls which Embedded Graphics Library support will be built. Available
611 linux options are auto (default), x11, wayland, surfaceless, and drm.
612 </para>
613
614 </sect2>
615
616 <sect2 role="content">
617 <title>Contents</title>
618
619 <segmentedlist>
620 <segtitle>Installed Programs</segtitle>
621 <segtitle>Installed Libraries</segtitle><!-- in /usr/lib -->
622 <segtitle>Installed DRI Drivers</segtitle><!-- in /usr/lib/dri -->
623 <segtitle>Installed VDPAU Drivers</segtitle><!-- in /usr/lib/vdpau -->
624 <segtitle>Installed Vulkan Drivers</segtitle><!-- in /usr/lib -->
625 <segtitle>Installed Directories</segtitle>
626
627 <seglistitem>
628 <seg>
629 glxgears,
630 glxinfo,
631 mme_fermi_sim_hw_test, and
632 mme_tu104_sim_hw_test
633 </seg>
634 <seg>
635 libEGL.so,
636 libGL.so,
637 libGLESv1_CM.so,
638 libGLESv2.so,
639 libgbm.so,
640 libglapi.so, and
641 libxatracker.so
642 </seg>
643 <seg>
644 <!-- d3dadapter9.so (optional)
645 I guess this is useless today, Wine applications use Vulkan
646 through libvkd3d, and new games with native Linux support
647 likely uses Vulkan directly. -->
648 <!-- Begin gallium DRI drivers (*_dri.so) and VA-API drivers
649 (*_drv_video.so): this is the full set -->
650 crocus_dri.so,
651 i915_dri.so,
652 iris_dri.so,
653 kms_swrast_dri.so,
654 nouveau_dri.so,
655 nouveau_drv_video.so,
656 r300_dri.so,
657 r600_dri.so,
658 r600_drv_video.so,
659 radeonsi_dri.so,
660 radeonsi_drv_video.so,
661 swrast_dri.so,
662 virtio_gpu_dri.so,
663 virtio_gpu_drv_video.so,
664 vmwgfx_dri.so, and
665 zink_dri.so
666 <!-- End DRI Drivers -->
667 </seg>
668 <seg>
669 <!-- Begin VDPAU drivers -->
670 libvdpau_nouveau.so,
671 libvdpau_r600.so, and
672 libvdpau_radeonsi.so
673 libvdpau_virtio_gpu.so
674 <!-- End VDPAU drivers -->
675 (Many of these drivers are hard-linked).
676 </seg>
677 <seg>
678 libvulkan_intel_hasvk.so,
679 libvulkan_intel.so,
680 libvulkan_lvp.so,
681 libvulkan_nouveau.so, and
682 libvulkan_radeon.so
683 </seg>
684 <seg>
685 <!-- $XORG_PREFIX/include/GL is installed by xorg-protos -->
686 $XORG_PREFIX/{include/{EGL,GLES,GLES2,GLES3,KHR},
687 $XORG_PREFIX/lib/{dri,vdpau}},
688 $XORG_PREFIX/share/drirc.d (contains workarounds for various applications,
689 particularly browsers and games),
690 $XORG_PREFIX/share/vulkan,
691 and /usr/share/doc/mesa-&mesa-version;
692 </seg>
693 </seglistitem>
694 </segmentedlist>
695
696 <variablelist>
697 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
698 <?dbfo list-presentation="list"?>
699 <?dbhtml list-presentation="table"?>
700
701 <varlistentry id="glxgears">
702 <term><command>glxgears</command></term>
703 <listitem>
704 <para>
705 is a GL demo useful for troubleshooting graphics
706 problems
707 </para>
708 <indexterm zone="mesa glxgears">
709 <primary sortas="b-glxgears">glxgears</primary>
710 </indexterm>
711 </listitem>
712 </varlistentry>
713
714 <varlistentry id="glxinfo">
715 <term><command>glxinfo</command></term>
716 <listitem>
717 <para>
718 is a diagnostic program that displays information about the
719 graphics hardware and installed GL libraries
720 </para>
721 <indexterm zone="mesa glxinfo">
722 <primary sortas="b-glxinfo">glxinfo</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
727 <varlistentry id="libEGL">
728 <term><filename class="libraryfile">libEGL.so</filename></term>
729 <listitem>
730 <para>
731 provides a native platform graphics interface as
732 defined by the EGL-1.4 specification
733 </para>
734 <indexterm zone="mesa libEGL">
735 <primary sortas="c-libGL">libEGL.so</primary>
736 </indexterm>
737 </listitem>
738 </varlistentry>
739
740 <varlistentry id="libgbm">
741 <term><filename class="libraryfile">libgbm.so</filename></term>
742 <listitem>
743 <para>
744 is the <application>Mesa</application> Graphics Buffer
745 Manager library
746 </para>
747 <indexterm zone="mesa libgbm">
748 <primary sortas="c-libgbm">libgbm.so</primary>
749 </indexterm>
750 </listitem>
751 </varlistentry>
752
753 <varlistentry id="libGLESv1_CM">
754 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
755 <listitem>
756 <para>
757 is the <application>Mesa</application> OpenGL ES 1.1 library
758 </para>
759 <indexterm zone="mesa libGLESv1_CM">
760 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
761 </indexterm>
762 </listitem>
763 </varlistentry>
764
765 <varlistentry id="libGLES2">
766 <term><filename class="libraryfile">libGLES2.so</filename></term>
767 <listitem>
768 <para>
769 is the <application>Mesa</application> OpenGL ES 2.0 library
770 </para>
771 <indexterm zone="mesa libGLES2">
772 <primary sortas="c-libGLES2">libGLES2.so</primary>
773 </indexterm>
774 </listitem>
775 </varlistentry>
776
777 <varlistentry id="libGL">
778 <term><filename class="libraryfile">libGL.so</filename></term>
779 <listitem>
780 <para>
781 is the main <application>Mesa</application> OpenGL library
782 </para>
783 <indexterm zone="mesa libGL">
784 <primary sortas="c-libGL">libGL.so</primary>
785 </indexterm>
786 </listitem>
787 </varlistentry>
788
789 </variablelist>
790
791 </sect2>
792
793</sect1>
Note: See TracBrowser for help on using the repository browser.