File: INSTALL

package info (click to toggle)
mesa 3.1-17
  • links: PTS
  • area: main
  • in suites: potato
  • size: 10,908 kB
  • ctags: 19,599
  • sloc: ansic: 132,736; asm: 10,554; sh: 9,193; cpp: 3,540; makefile: 1,377
file content (219 lines) | stat: -rw-r--r-- 6,271 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219

             Mesa compilation and installation instructions


Mesa 3.1 now uses GNU autoconfig for compilation and installation.
Previously, traditional Makefiles were used to compile Mesa.

You now have the choice of how you want to build Mesa:

  NEW-STYLE:  Basically, type "./configure" followed by "make"
              This should work on most Unix-like operating systems.
              For more details, see the NEW-STYLE section below.

  OLD-STYLE:  Simply type "make" and you'll see a list of supported
              system configurations.  Pick one and type "make <config>"
              For more details, see the OLD-STYLE section below.



===============================================================================
NEW-STYLE Mesa compilation and installation instructions begin here
-------------------------------------------------------------------------------

0) If you've downloaded Mesa via CVS there will not be a "configure"
   script.  You'll have to run the "bootstrap" script first.  This script
   may not work on any OS other than Linux.

1) Run the configure script

	./configure [options]

Possible options are:

--prefix=DIR
	The toplevel directory of the hierachy in which Mesa
	will be installed (DIR/include,DIR/lib etc.).
	The default is "/usr/local".

--sysconfdir=DIR
	The directory where Mesa configuration files
	will be stored.	The default is "$prefix/etc".
	You may want to overwrite the default with --sysconfdir=/etc.

--enable-static
	Enable building of static libraries.
	Static libraries are NOT built by default.
	
--disable-shared
	Disable building of shared libraries.
	Shared libraries are built by default.

--enable-debug
	Enable debugging messages (disabled by default).
	
--enable-profile
	Enable profiling (disabled by default).
	
--disable-optimize
	Disable extra optimizations (enabled by default,
	i.e., optimize for maximum performance).
	
--enable-warn
	Enable extended compiler warnings (disabled by default).
	
--enable-x86[=ARG]
--disable-x86
	Enable/disable x86 assembler support to speed up Mesa
	(autodetected by default). You may set `on' or `off'.
	
--enable-3dnow[=ARG]
--disable-3dnow
	Enable/disable 3Dnow support to speed up Mesa
	(autodetected by default). You may set `on' or `off'.
	
--enable-mmx[=ARG]
--disable-mmx
	Enable/disable MMX support to speed up Mesa
	(autodetected by default). You may set `on' or `off'.
	
--with-glide[=DIR]
--without-glide
	Enable/disable support for Glide (autodetected by default).
	DIR is the installation directory of Glide.
	If Glide cannot be found, the driver won't be built.
	
--with-glut[=DIR]
--without-glut
	Don't/use already-installed GLUT (autodetected by default).
	DIR is the installation directory of Glut.
	If GLUT cannot be found, the version shipped with Mesa will be built.
	
--with-ggi[=DIR]
--without-ggi
	Enable/disable support for GGI (autodetected by default).
	DIR is the installation directory of GGI.
	If GGI cannot be found, the driver won't be built.

--disable-ggi-fbdev
	Don't build the GGI fbdev target (autodetected by default).
	
--disable-ggi-genkgi
	Don't build the GGI generic KGI driver (autodetected by default).
	
--disable-ggi-savage4
	Don't build the GGI Savage4 KGI driver (autodetected by default).
	
--disable-osmesa
	Disable OSmesa (offscreen rendering) support (enabled by default).

--with-svga[=DIR]
--without-svga
	Enable/disable support for SVGALib (autodetected by default).
	DIR is the installation directory of SVGALib.
	If SVGALib cannot be found, the driver won't be built.

--x-includes=DIR
	Search for the X include files in DIR.
	
--x-libraries=DIR
	Search for the X library files in DIR.

User specific compiler options can be set using the shell variable
CFLAGS. For instance,
	CFLAGS="-g -O2" ./configure
(on some systems: env CFLAGS="-g -O2" ./configure)
sets the compiler flags to "-g -O2".

For more options run "./configure --help" and read INSTALL.GNU.


2) To build the Mesa libraries run:

	make

Optionally, you can strip the libraries using

	make strip
	
Now make sure that you have the permissions to install Mesa in the 
specified directories, for example, by becoming super user ("su")
Then run:

	make install

Mesa is now installed.
Please don't move the installed files but rerun all installation
steps if you want to use other directories.


3) To test whether Mesa works properly you might want to run the Mesa demos:

	make check
	
Builds all demos.

	make exec

Builds and executes all demos.	






===============================================================================
OLD-STYLE Mesa compilation and installation instructions begin here
-------------------------------------------------------------------------------

To build Mesa on most Unix-like operations systems, start by typing
"make" alone.  You'll see a list of supported system configurations.
Choose one, call it <config>, type "make <config>".

For system-specific information check out these files in the docs/
directory:

	System				README file
	-----------------		------------
	Unix/X11			README.X11
	Windows 95/N%			README.WIN32
	DOS				README.DOS
	Linux/Windows w/ 3Dfx hardware	README.3DFX
	Linux with GGI			README.GGI
	Linux with threading		README.MITS
	Amigas with Amiwin		README.AMIWIN
	BeOS				README.BEOS
	LynxOS				README.LYNXOS
	SciTech MGL			README.MGL
	IBM OS/2			README.OS2
	Windows w/ S3 Virge hardware	README.VIRGE
	VMS				README.VMS
	Allegro DJGPP			README.DJA
	Direct3D driver			README.D3D


Header and library files:
   After you've compiled Mesa and tried the demos I recommend the following
   procedure for "installing" Mesa on Unix systems.

   Copy the Mesa include/GL directory to /usr/local/include:
	cp -r include/GL /usr/local/include

   Copy the Mesa library files to /usr/local/lib:
	cp lib/* /usr/local/lib

	(actually, use "cp -d" on Linux to preserve symbolic links)

   Create a few symbolic links so that compiling OpenGL applications is easy:
	cd /usr/local/lib
	IF USING STATIC (lib*.a) FILES THEN
		ln -s libMesaGL.a libGL.a
		ln -s libMesaGLU.a libGLU.a
	ELSE
		ln -s libMesaGL.so libGL.so
		ln -s libMesaGLU.so libGLU.so
	ENDIF


===============================================================================
$Id: INSTALL,v 1.5 1999/10/20 18:53:46 brianp Exp $