source: x/installing/mesa.xml@ 6749017

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 6749017 was 6749017, checked in by Xi Ruoyao <xry111@…>, 2 months ago

mesa: Clarify the use of vulkan-loader

We don't need vulkan-loader to build a vulkan driver. Building vulkan
driver only needs vulkan-header, and a shipped copy in Mesa source tree
is always used, thus even a system vulkan-header install isn't needed.

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