xref: /aosp_15_r20/external/mesa3d/docs/download.rst (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard WorkerDownloading and Unpacking
2*61046927SAndroid Build Coastguard Worker=========================
3*61046927SAndroid Build Coastguard Worker
4*61046927SAndroid Build Coastguard WorkerDownloading
5*61046927SAndroid Build Coastguard Worker-----------
6*61046927SAndroid Build Coastguard Worker
7*61046927SAndroid Build Coastguard WorkerYou can download the released versions of Mesa via
8*61046927SAndroid Build Coastguard Worker`HTTPS <https://archive.mesa3d.org/>`__ or
9*61046927SAndroid Build Coastguard Worker`FTP <ftp://ftp.freedesktop.org/pub/mesa/>`__.
10*61046927SAndroid Build Coastguard Worker
11*61046927SAndroid Build Coastguard WorkerOur release tarballs are GPG-signed, and the public keys are available
12*61046927SAndroid Build Coastguard Workerhere: `release-maintainers-keys.asc <release-maintainers-keys.asc>`__.
13*61046927SAndroid Build Coastguard Worker
14*61046927SAndroid Build Coastguard WorkerStarting with the first release of 2017, Mesa's version scheme is
15*61046927SAndroid Build Coastguard Workeryear-based. Filenames are in the form ``mesa-Y.N.P.tar.gz``, where ``Y``
16*61046927SAndroid Build Coastguard Workeris the year (two digits), ``N`` is an incremental number (starting at 0)
17*61046927SAndroid Build Coastguard Workerand ``P`` is the patch number (0 for the first release, 1 for the first
18*61046927SAndroid Build Coastguard Workerpatch after that).
19*61046927SAndroid Build Coastguard Worker
20*61046927SAndroid Build Coastguard WorkerWhen a new release is coming, release candidates (betas) may be found in
21*61046927SAndroid Build Coastguard Workerthe same directory, and are recognizable by the
22*61046927SAndroid Build Coastguard Worker``mesa-Y.N.P-rcX.tar.gz`` filename.
23*61046927SAndroid Build Coastguard Worker
24*61046927SAndroid Build Coastguard WorkerUnpacking
25*61046927SAndroid Build Coastguard Worker---------
26*61046927SAndroid Build Coastguard Worker
27*61046927SAndroid Build Coastguard WorkerMesa releases are available in two formats: ``.tar.xz`` and ``.tar.gz``.
28*61046927SAndroid Build Coastguard Worker
29*61046927SAndroid Build Coastguard WorkerTo unpack the tarball:
30*61046927SAndroid Build Coastguard Worker
31*61046927SAndroid Build Coastguard Worker.. code-block:: sh
32*61046927SAndroid Build Coastguard Worker
33*61046927SAndroid Build Coastguard Worker      tar xf mesa-Y.N.P.tar.xz
34*61046927SAndroid Build Coastguard Worker
35*61046927SAndroid Build Coastguard Workeror
36*61046927SAndroid Build Coastguard Worker
37*61046927SAndroid Build Coastguard Worker.. code-block:: sh
38*61046927SAndroid Build Coastguard Worker
39*61046927SAndroid Build Coastguard Worker      tar xf mesa-Y.N.P.tar.gz
40*61046927SAndroid Build Coastguard Worker
41*61046927SAndroid Build Coastguard WorkerContents
42*61046927SAndroid Build Coastguard Worker--------
43*61046927SAndroid Build Coastguard Worker
44*61046927SAndroid Build Coastguard WorkerProceed to the :doc:`compilation and installation
45*61046927SAndroid Build Coastguard Workerinstructions <install>`.
46*61046927SAndroid Build Coastguard Worker
47*61046927SAndroid Build Coastguard WorkerDemos, GLUT, and GLU
48*61046927SAndroid Build Coastguard Worker--------------------
49*61046927SAndroid Build Coastguard Worker
50*61046927SAndroid Build Coastguard WorkerA package of SGI's GLU library is available
51*61046927SAndroid Build Coastguard Worker`here <https://archive.mesa3d.org/glu/>`__
52*61046927SAndroid Build Coastguard Worker
53*61046927SAndroid Build Coastguard WorkerA package of Mark Kilgard's GLUT library is available
54*61046927SAndroid Build Coastguard Worker`here <https://archive.mesa3d.org/glut/>`__
55*61046927SAndroid Build Coastguard Worker
56*61046927SAndroid Build Coastguard WorkerThe Mesa demos collection is available
57*61046927SAndroid Build Coastguard Worker`here <https://archive.mesa3d.org/demos/>`__
58*61046927SAndroid Build Coastguard Worker
59*61046927SAndroid Build Coastguard WorkerIn the past, GLUT, GLU and the Mesa demos were released in conjunction
60*61046927SAndroid Build Coastguard Workerwith Mesa releases. But since GLUT, GLU and the demos change
61*61046927SAndroid Build Coastguard Workerinfrequently, they were split off into their own Git repositories:
62*61046927SAndroid Build Coastguard Worker`GLUT <https://gitlab.freedesktop.org/mesa/glut>`__,
63*61046927SAndroid Build Coastguard Worker`GLU <https://gitlab.freedesktop.org/mesa/glu>`__ and
64*61046927SAndroid Build Coastguard Worker`Demos <https://gitlab.freedesktop.org/mesa/demos>`__,
65