blob: 2c8e271502d6ea384bba0932ae0bd44918cab28b [file] [log] [blame]
Andreas Bollecd5c7c2012-06-12 09:05:03 +02001<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html lang="en">
3<head>
4 <meta http-equiv="content-type" content="text/html; charset=utf-8">
5 <title>Getting Mesa</title>
6 <link rel="stylesheet" type="text/css" href="mesa.css">
7</head>
8<body>
Brian Paul0b27ace2003-03-08 17:38:57 +00009
Andreas Bollb5da52a2012-09-18 18:57:02 +020010<div class="header">
11 <h1>The Mesa 3D Graphics Library</h1>
12</div>
13
14<iframe src="contents.html"></iframe>
15<div class="content">
16
Andreas Bollecd5c7c2012-06-12 09:05:03 +020017<h1>Downloading</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +000018
19<p>
Brian Paul5d56e312009-09-03 15:44:49 -060020Primary Mesa download site:
Brian Paulbab07522016-03-29 12:54:10 -060021<a href="ftp://ftp.freedesktop.org/pub/mesa/">ftp.freedesktop.org</a> (FTP)
22or <a href="https://mesa.freedesktop.org/archive/">mesa.freedesktop.org</a>
23(HTTP).
Brian Paul0b27ace2003-03-08 17:38:57 +000024</p>
25
Brian Paul3491cbe2008-06-21 10:14:22 -060026<p>
Eric Engestrom5b10c362017-02-08 04:27:00 -070027Starting with the first release of 2017, Mesa's version scheme is
28year-based. Filenames are in the form <tt>mesa-Y.N.P.tar.gz</tt>, where
29<tt>Y</tt> is the year (two digits), <tt>N</tt> is an incremental number
30(starting at 0) and <tt>P</tt> is the patch number (0 for the first
31release, 1 for the first patch after that).
32</p>
33
34<p>
Brian Paul5d56e312009-09-03 15:44:49 -060035When a new release is coming, release candidates (betas) may be found
Eric Engestromd7e1a162017-02-08 04:27:00 -070036in the same directory, and are recognisable by the
37<tt>mesa-Y.N.P-<b>rc</b>X.tar.gz</tt> filename.
Brian Paul3491cbe2008-06-21 10:14:22 -060038</p>
39
Brian Paul7f8cb302005-09-10 16:57:22 +000040
Andreas Boll210a27d2012-06-12 09:05:36 +020041<h1>Unpacking</h1>
Brian Paul7f8cb302005-09-10 16:57:22 +000042
43<p>
Brian Paulf64bae22012-04-19 08:56:02 -060044Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
45</p>
46
47<p>
Brian Paul48f696c2011-04-04 11:16:51 -060048To unpack .tar.gz files:
Brian Paul7f8cb302005-09-10 16:57:22 +000049</p>
Brian Paul0b27ace2003-03-08 17:38:57 +000050<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060051 tar zxf MesaLib-x.y.z.tar.gz
Brian Paul0b27ace2003-03-08 17:38:57 +000052</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000053or
54<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060055 gzcat MesaLib-x.y.z.tar.gz | tar xf -
Brian Paul7f8cb302005-09-10 16:57:22 +000056</pre>
57or
58<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060059 gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
Brian Paul7f8cb302005-09-10 16:57:22 +000060</pre>
Brian Paul48f696c2011-04-04 11:16:51 -060061<p>
62To unpack .tar.bz2 files:
63</p>
Brian Paul7f8cb302005-09-10 16:57:22 +000064<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060065 bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
Brian Paul7f8cb302005-09-10 16:57:22 +000066</pre>
Brian Paul48f696c2011-04-04 11:16:51 -060067<p>
68To unpack .zip files:
69</p>
Brian Paul7f8cb302005-09-10 16:57:22 +000070<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060071 unzip MesaLib-x.y.z.zip
Brian Paul7f8cb302005-09-10 16:57:22 +000072</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000073
74
75<h1>Contents</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +000076
77<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +000078After unpacking you'll have these files and directories (among others):
Brian Paul0b27ace2003-03-08 17:38:57 +000079</p>
80<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000081Makefile - top-level Makefile for most systems
82configs/ - makefile parameter files for various systems
Brian Paul0b27ace2003-03-08 17:38:57 +000083include/ - GL header (include) files
Brian Paulafc04282003-09-03 23:04:31 +000084bin/ - shell scripts for making shared libraries, etc
Brian Paul0b27ace2003-03-08 17:38:57 +000085docs/ - documentation
Brian Paulafc04282003-09-03 23:04:31 +000086src/ - source code for libraries
87src/mesa - sources for the main Mesa library and device drivers
Brian Paul48f696c2011-04-04 11:16:51 -060088src/gallium - sources for Gallium and Gallium drivers
Brian Pauld9eff8b2006-07-12 20:14:43 +000089src/glx - sources for building libGL with full GLX and DRI support
Brian Paul7f8cb302005-09-10 16:57:22 +000090</pre>
Brian Paulafc04282003-09-03 23:04:31 +000091
Brian Paul0b27ace2003-03-08 17:38:57 +000092
93<p>
Brian Paul7f8cb302005-09-10 16:57:22 +000094Proceed to the <a href="install.html">compilation and installation
Brian Paul0b27ace2003-03-08 17:38:57 +000095instructions</a>.
96</p>
97
Brian Paul0b27ace2003-03-08 17:38:57 +000098
Matt Turnerb95d5982012-08-23 16:39:20 -070099<h1>Demos, GLUT, and GLU</h1>
100
101<p>
102A package of SGI's GLU library is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200103<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>
Matt Turnerb95d5982012-08-23 16:39:20 -0700104</p>
Brian Paulf64bae22012-04-19 08:56:02 -0600105
106<p>
107A package of Mark Kilgard's GLUT library is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200108<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
Brian Paulf64bae22012-04-19 08:56:02 -0600109</p>
110
111<p>
112The Mesa demos collection is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200113<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>
Brian Paulf64bae22012-04-19 08:56:02 -0600114</p>
115
116<p>
Matt Turnerb95d5982012-08-23 16:39:20 -0700117In the past, GLUT, GLU and the Mesa demos were released in conjunction with
118Mesa releases. But since GLUT, GLU and the demos change infrequently, they
119were split off into their own git repositories:
120
121<a href="http://cgit.freedesktop.org/mesa/glut/">GLUT</a>,
122<a href="http://cgit.freedesktop.org/mesa/glu/">GLU</a> and
123<a href="http://cgit.freedesktop.org/mesa/demos/">Demos</a>,
Brian Paulf64bae22012-04-19 08:56:02 -0600124</p>
125
Andreas Bollb5da52a2012-09-18 18:57:02 +0200126</div>
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200127</body>
128</html>