Merge remote branch 'origin/master' into pipe-video
[mesa.git] / scons / gallium.py
1 """gallium
2
3 Frontend-tool for Gallium3D architecture.
4
5 """
6
7 #
8 # Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas.
9 # All Rights Reserved.
10 #
11 # Permission is hereby granted, free of charge, to any person obtaining a
12 # copy of this software and associated documentation files (the
13 # "Software"), to deal in the Software without restriction, including
14 # without limitation the rights to use, copy, modify, merge, publish,
15 # distribute, sub license, and/or sell copies of the Software, and to
16 # permit persons to whom the Software is furnished to do so, subject to
17 # the following conditions:
18 #
19 # The above copyright notice and this permission notice (including the
20 # next paragraph) shall be included in all copies or substantial portions
21 # of the Software.
22 #
23 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24 # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
25 # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
26 # IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
27 # ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
28 # TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
29 # SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 #
31
32
33 import distutils.version
34 import os
35 import os.path
36 import re
37 import subprocess
38 import platform as _platform
39
40 import SCons.Action
41 import SCons.Builder
42 import SCons.Scanner
43
44
45 def symlink(target, source, env):
46 target = str(target[0])
47 source = str(source[0])
48 if os.path.islink(target) or os.path.exists(target):
49 os.remove(target)
50 os.symlink(os.path.basename(source), target)
51
52 def install(env, source, subdir):
53 target_dir = os.path.join(env.Dir('#.').srcnode().abspath, env['build_dir'], subdir)
54 return env.Install(target_dir, source)
55
56 def install_program(env, source):
57 return install(env, source, 'bin')
58
59 def install_shared_library(env, sources, version = ()):
60 targets = []
61 install_dir = os.path.join(env.Dir('#.').srcnode().abspath, env['build_dir'])
62 version = tuple(map(str, version))
63 if env['SHLIBSUFFIX'] == '.dll':
64 dlls = env.FindIxes(sources, 'SHLIBPREFIX', 'SHLIBSUFFIX')
65 targets += install(env, dlls, 'bin')
66 libs = env.FindIxes(sources, 'LIBPREFIX', 'LIBSUFFIX')
67 targets += install(env, libs, 'lib')
68 else:
69 for source in sources:
70 target_dir = os.path.join(install_dir, 'lib')
71 target_name = '.'.join((str(source),) + version)
72 last = env.InstallAs(os.path.join(target_dir, target_name), source)
73 targets += last
74 while len(version):
75 version = version[:-1]
76 target_name = '.'.join((str(source),) + version)
77 action = SCons.Action.Action(symlink, "$TARGET -> $SOURCE")
78 last = env.Command(os.path.join(target_dir, target_name), last, action)
79 targets += last
80 return targets
81
82
83 def createInstallMethods(env):
84 env.AddMethod(install_program, 'InstallProgram')
85 env.AddMethod(install_shared_library, 'InstallSharedLibrary')
86
87
88 def num_jobs():
89 try:
90 return int(os.environ['NUMBER_OF_PROCESSORS'])
91 except (ValueError, KeyError):
92 pass
93
94 try:
95 return os.sysconf('SC_NPROCESSORS_ONLN')
96 except (ValueError, OSError, AttributeError):
97 pass
98
99 try:
100 return int(os.popen2("sysctl -n hw.ncpu")[1].read())
101 except ValueError:
102 pass
103
104 return 1
105
106
107 def pkg_config_modules(env, name, modules):
108 '''Simple wrapper for pkg-config.'''
109
110 env[name] = False
111
112 if env['platform'] == 'windows':
113 return
114
115 if not env.Detect('pkg-config'):
116 return
117
118 if subprocess.call(["pkg-config", "--exists", ' '.join(modules)]) != 0:
119 return
120
121 # Put -I and -L flags directly into the environment, as these don't affect
122 # the compilation of targets that do not use them
123 try:
124 env.ParseConfig('pkg-config --cflags-only-I --libs-only-L ' + ' '.join(modules))
125 except OSError:
126 return
127
128 # Other flags may affect the compilation of unrelated targets, so store
129 # them with a prefix, (e.g., XXX_CFLAGS, XXX_LIBS, etc)
130 try:
131 flags = env.ParseFlags('!pkg-config --cflags-only-other --libs-only-l --libs-only-other ' + ' '.join(modules))
132 except OSError:
133 return
134 prefix = name.upper() + '_'
135 for flag_name, flag_value in flags.iteritems():
136 env[prefix + flag_name] = flag_value
137
138 env[name] = True
139
140
141
142 def generate(env):
143 """Common environment generation code"""
144
145 # Tell tools which machine to compile for
146 env['TARGET_ARCH'] = env['machine']
147 env['MSVS_ARCH'] = env['machine']
148
149 # Toolchain
150 platform = env['platform']
151 if env['toolchain'] == 'default':
152 if platform == 'winddk':
153 env['toolchain'] = 'winddk'
154 elif platform == 'wince':
155 env['toolchain'] = 'wcesdk'
156 env.Tool(env['toolchain'])
157
158 # Allow override compiler and specify additional flags from environment
159 if os.environ.has_key('CC'):
160 env['CC'] = os.environ['CC']
161 # Update CCVERSION to match
162 pipe = SCons.Action._subproc(env, [env['CC'], '--version'],
163 stdin = 'devnull',
164 stderr = 'devnull',
165 stdout = subprocess.PIPE)
166 if pipe.wait() == 0:
167 line = pipe.stdout.readline()
168 match = re.search(r'[0-9]+(\.[0-9]+)+', line)
169 if match:
170 env['CCVERSION'] = match.group(0)
171 if os.environ.has_key('CFLAGS'):
172 env['CCFLAGS'] += SCons.Util.CLVar(os.environ['CFLAGS'])
173 if os.environ.has_key('CXX'):
174 env['CXX'] = os.environ['CXX']
175 if os.environ.has_key('CXXFLAGS'):
176 env['CXXFLAGS'] += SCons.Util.CLVar(os.environ['CXXFLAGS'])
177 if os.environ.has_key('LDFLAGS'):
178 env['LINKFLAGS'] += SCons.Util.CLVar(os.environ['LDFLAGS'])
179
180 env['gcc'] = 'gcc' in os.path.basename(env['CC']).split('-')
181 env['msvc'] = env['CC'] == 'cl'
182
183 if env['msvc'] and env['toolchain'] == 'default' and env['machine'] == 'x86_64':
184 # MSVC x64 support is broken in earlier versions of scons
185 env.EnsurePythonVersion(2, 0)
186
187 # shortcuts
188 machine = env['machine']
189 platform = env['platform']
190 x86 = env['machine'] == 'x86'
191 ppc = env['machine'] == 'ppc'
192 gcc = env['gcc']
193 msvc = env['msvc']
194
195 # Determine whether we are cross compiling; in particular, whether we need
196 # to compile code generators with a different compiler as the target code.
197 host_platform = _platform.system().lower()
198 host_machine = os.environ.get('PROCESSOR_ARCHITEW6432', os.environ.get('PROCESSOR_ARCHITECTURE', _platform.machine()))
199 host_machine = {
200 'x86': 'x86',
201 'i386': 'x86',
202 'i486': 'x86',
203 'i586': 'x86',
204 'i686': 'x86',
205 'ppc' : 'ppc',
206 'AMD64': 'x86_64',
207 'x86_64': 'x86_64',
208 }.get(host_machine, 'generic')
209 env['crosscompile'] = platform != host_platform
210 if machine == 'x86_64' and host_machine != 'x86_64':
211 env['crosscompile'] = True
212 env['hostonly'] = False
213
214 # Backwards compatability with the debug= profile= options
215 if env['build'] == 'debug':
216 if not env['debug']:
217 print 'scons: warning: debug option is deprecated and will be removed eventually; use instead'
218 print
219 print ' scons build=release'
220 print
221 env['build'] = 'release'
222 if env['profile']:
223 print 'scons: warning: profile option is deprecated and will be removed eventually; use instead'
224 print
225 print ' scons build=profile'
226 print
227 env['build'] = 'profile'
228 if False:
229 # Enforce SConscripts to use the new build variable
230 env.popitem('debug')
231 env.popitem('profile')
232 else:
233 # Backwards portability with older sconscripts
234 if env['build'] in ('debug', 'checked'):
235 env['debug'] = True
236 env['profile'] = False
237 if env['build'] == 'profile':
238 env['debug'] = False
239 env['profile'] = True
240 if env['build'] == 'release':
241 env['debug'] = False
242 env['profile'] = False
243
244 # Put build output in a separate dir, which depends on the current
245 # configuration. See also http://www.scons.org/wiki/AdvancedBuildExample
246 build_topdir = 'build'
247 build_subdir = env['platform']
248 if env['machine'] != 'generic':
249 build_subdir += '-' + env['machine']
250 if env['build'] != 'release':
251 build_subdir += '-' + env['build']
252 build_dir = os.path.join(build_topdir, build_subdir)
253 # Place the .sconsign file in the build dir too, to avoid issues with
254 # different scons versions building the same source file
255 env['build_dir'] = build_dir
256 env.SConsignFile(os.path.join(build_dir, '.sconsign'))
257 if 'SCONS_CACHE_DIR' in os.environ:
258 print 'scons: Using build cache in %s.' % (os.environ['SCONS_CACHE_DIR'],)
259 env.CacheDir(os.environ['SCONS_CACHE_DIR'])
260 env['CONFIGUREDIR'] = os.path.join(build_dir, 'conf')
261 env['CONFIGURELOG'] = os.path.join(os.path.abspath(build_dir), 'config.log')
262
263 # Parallel build
264 if env.GetOption('num_jobs') <= 1:
265 env.SetOption('num_jobs', num_jobs())
266
267 env.Decider('MD5-timestamp')
268 env.SetOption('max_drift', 60)
269
270 # C preprocessor options
271 cppdefines = []
272 if env['build'] in ('debug', 'checked'):
273 cppdefines += ['DEBUG']
274 else:
275 cppdefines += ['NDEBUG']
276 if env['build'] == 'profile':
277 cppdefines += ['PROFILE']
278 if platform == 'windows':
279 cppdefines += [
280 'WIN32',
281 '_WINDOWS',
282 #'_UNICODE',
283 #'UNICODE',
284 # http://msdn.microsoft.com/en-us/library/aa383745.aspx
285 ('_WIN32_WINNT', '0x0601'),
286 ('WINVER', '0x0601'),
287 ]
288 if msvc and env['toolchain'] != 'winddk':
289 cppdefines += [
290 'VC_EXTRALEAN',
291 '_USE_MATH_DEFINES',
292 '_CRT_SECURE_NO_WARNINGS',
293 '_CRT_SECURE_NO_DEPRECATE',
294 '_SCL_SECURE_NO_WARNINGS',
295 '_SCL_SECURE_NO_DEPRECATE',
296 ]
297 if env['build'] in ('debug', 'checked'):
298 cppdefines += ['_DEBUG']
299 if env['toolchain'] == 'winddk':
300 # Mimic WINDDK's builtin flags. See also:
301 # - WINDDK's bin/makefile.new i386mk.inc for more info.
302 # - buildchk_wxp_x86.log files, generated by the WINDDK's build
303 # - http://alter.org.ua/docs/nt_kernel/vc8_proj/
304 if machine == 'x86':
305 cppdefines += ['_X86_', 'i386']
306 if machine == 'x86_64':
307 cppdefines += ['_AMD64_', 'AMD64']
308 if platform == 'winddk':
309 cppdefines += [
310 'STD_CALL',
311 ('CONDITION_HANDLING', '1'),
312 ('NT_INST', '0'),
313 ('WIN32', '100'),
314 ('_NT1X_', '100'),
315 ('WINNT', '1'),
316 ('_WIN32_WINNT', '0x0501'), # minimum required OS version
317 ('WINVER', '0x0501'),
318 ('_WIN32_IE', '0x0603'),
319 ('WIN32_LEAN_AND_MEAN', '1'),
320 ('DEVL', '1'),
321 ('__BUILDMACHINE__', 'WinDDK'),
322 ('FPO', '0'),
323 ]
324 if env['build'] in ('debug', 'checked'):
325 cppdefines += [('DBG', 1)]
326 if platform == 'wince':
327 cppdefines += [
328 '_CRT_SECURE_NO_DEPRECATE',
329 '_USE_32BIT_TIME_T',
330 'UNICODE',
331 '_UNICODE',
332 ('UNDER_CE', '600'),
333 ('_WIN32_WCE', '0x600'),
334 'WINCEOEM',
335 'WINCEINTERNAL',
336 'WIN32',
337 'STRICT',
338 'x86',
339 '_X86_',
340 'INTERNATIONAL',
341 ('INTLMSG_CODEPAGE', '1252'),
342 ]
343 if platform == 'windows':
344 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_USER']
345 if platform == 'winddk':
346 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_DISPLAY']
347 if platform == 'wince':
348 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE']
349 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE_OGL']
350 if platform == 'embedded':
351 cppdefines += ['PIPE_OS_EMBEDDED']
352 env.Append(CPPDEFINES = cppdefines)
353
354 # C compiler options
355 cflags = [] # C
356 cxxflags = [] # C++
357 ccflags = [] # C & C++
358 if gcc:
359 ccversion = env['CCVERSION']
360 if env['build'] == 'debug':
361 ccflags += ['-O0']
362 elif ccversion.startswith('4.2.'):
363 # gcc 4.2.x optimizer is broken
364 print "warning: gcc 4.2.x optimizer is broken -- disabling optimizations"
365 ccflags += ['-O0']
366 else:
367 ccflags += ['-O3']
368 ccflags += ['-g3']
369 if env['build'] in ('checked', 'profile'):
370 # See http://code.google.com/p/jrfonseca/wiki/Gprof2Dot#Which_options_should_I_pass_to_gcc_when_compiling_for_profiling?
371 ccflags += [
372 '-fno-omit-frame-pointer',
373 '-fno-optimize-sibling-calls',
374 ]
375 if env['machine'] == 'x86':
376 ccflags += [
377 '-m32',
378 #'-march=pentium4',
379 ]
380 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.2') \
381 and (platform != 'windows' or env['build'] == 'debug' or True):
382 # NOTE: We need to ensure stack is realigned given that we
383 # produce shared objects, and have no control over the stack
384 # alignment policy of the application. Therefore we need
385 # -mstackrealign ore -mincoming-stack-boundary=2.
386 #
387 # XXX: -O and -mstackrealign causes stack corruption on MinGW
388 #
389 # XXX: We could have SSE without -mstackrealign if we always used
390 # __attribute__((force_align_arg_pointer)), but that's not
391 # always the case.
392 ccflags += [
393 '-mstackrealign', # ensure stack is aligned
394 '-mmmx', '-msse', '-msse2', # enable SIMD intrinsics
395 #'-mfpmath=sse',
396 ]
397 if platform in ['windows', 'darwin']:
398 # Workaround http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37216
399 ccflags += ['-fno-common']
400 if env['machine'] == 'x86_64':
401 ccflags += ['-m64']
402 if platform == 'darwin':
403 ccflags += ['-fno-common']
404 # See also:
405 # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
406 ccflags += [
407 '-Wall',
408 '-Wno-long-long',
409 '-ffast-math',
410 '-fmessage-length=0', # be nice to Eclipse
411 ]
412 cflags += [
413 '-Wmissing-prototypes',
414 '-std=gnu99',
415 ]
416 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.0'):
417 ccflags += [
418 '-Wmissing-field-initializers',
419 ]
420 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.2'):
421 ccflags += [
422 '-Werror=pointer-arith',
423 ]
424 cflags += [
425 '-Werror=declaration-after-statement',
426 ]
427 if msvc:
428 # See also:
429 # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
430 # - cl /?
431 if env['build'] == 'debug':
432 ccflags += [
433 '/Od', # disable optimizations
434 '/Oi', # enable intrinsic functions
435 '/Oy-', # disable frame pointer omission
436 ]
437 else:
438 ccflags += [
439 '/O2', # optimize for speed
440 ]
441 if env['build'] == 'release':
442 ccflags += [
443 '/GL', # enable whole program optimization
444 ]
445 else:
446 ccflags += [
447 '/GL-', # disable whole program optimization
448 ]
449 ccflags += [
450 '/fp:fast', # fast floating point
451 '/W3', # warning level
452 #'/Wp64', # enable 64 bit porting warnings
453 ]
454 if env['machine'] == 'x86':
455 ccflags += [
456 #'/arch:SSE2', # use the SSE2 instructions
457 ]
458 if platform == 'windows':
459 ccflags += [
460 # TODO
461 ]
462 if platform == 'winddk':
463 ccflags += [
464 '/Zl', # omit default library name in .OBJ
465 '/Zp8', # 8bytes struct member alignment
466 '/Gy', # separate functions for linker
467 '/Gm-', # disable minimal rebuild
468 '/WX', # treat warnings as errors
469 '/Gz', # __stdcall Calling convention
470 '/GX-', # disable C++ EH
471 '/GR-', # disable C++ RTTI
472 '/GF', # enable read-only string pooling
473 '/G6', # optimize for PPro, P-II, P-III
474 '/Ze', # enable extensions
475 '/Gi-', # disable incremental compilation
476 '/QIfdiv-', # disable Pentium FDIV fix
477 '/hotpatch', # prepares an image for hotpatching.
478 #'/Z7', #enable old-style debug info
479 ]
480 if platform == 'wince':
481 # See also C:\WINCE600\public\common\oak\misc\makefile.def
482 ccflags += [
483 '/Zl', # omit default library name in .OBJ
484 '/GF', # enable read-only string pooling
485 '/GR-', # disable C++ RTTI
486 '/GS', # enable security checks
487 # Allow disabling language conformance to maintain backward compat
488 #'/Zc:wchar_t-', # don't force wchar_t as native type, instead of typedef
489 #'/Zc:forScope-', # don't enforce Standard C++ for scoping rules
490 #'/wd4867',
491 #'/wd4430',
492 #'/MT',
493 #'/U_MT',
494 ]
495 # Automatic pdb generation
496 # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
497 env.EnsureSConsVersion(0, 98, 0)
498 env['PDB'] = '${TARGET.base}.pdb'
499 env.Append(CCFLAGS = ccflags)
500 env.Append(CFLAGS = cflags)
501 env.Append(CXXFLAGS = cxxflags)
502
503 if env['platform'] == 'windows' and msvc:
504 # Choose the appropriate MSVC CRT
505 # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
506 if env['build'] in ('debug', 'checked'):
507 env.Append(CCFLAGS = ['/MTd'])
508 env.Append(SHCCFLAGS = ['/LDd'])
509 else:
510 env.Append(CCFLAGS = ['/MT'])
511 env.Append(SHCCFLAGS = ['/LD'])
512
513 # Assembler options
514 if gcc:
515 if env['machine'] == 'x86':
516 env.Append(ASFLAGS = ['-m32'])
517 if env['machine'] == 'x86_64':
518 env.Append(ASFLAGS = ['-m64'])
519
520 # Linker options
521 linkflags = []
522 shlinkflags = []
523 if gcc:
524 if env['machine'] == 'x86':
525 linkflags += ['-m32']
526 if env['machine'] == 'x86_64':
527 linkflags += ['-m64']
528 if env['platform'] not in ('darwin'):
529 shlinkflags += [
530 '-Wl,-Bsymbolic',
531 ]
532 # Handle circular dependencies in the libraries
533 if env['platform'] in ('darwin'):
534 pass
535 else:
536 env['_LIBFLAGS'] = '-Wl,--start-group ' + env['_LIBFLAGS'] + ' -Wl,--end-group'
537 if msvc:
538 if env['build'] == 'release':
539 # enable Link-time Code Generation
540 linkflags += ['/LTCG']
541 env.Append(ARFLAGS = ['/LTCG'])
542 if platform == 'windows' and msvc:
543 # See also:
544 # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
545 linkflags += [
546 '/fixed:no',
547 '/incremental:no',
548 ]
549 if platform == 'winddk':
550 linkflags += [
551 '/merge:_PAGE=PAGE',
552 '/merge:_TEXT=.text',
553 '/section:INIT,d',
554 '/opt:ref',
555 '/opt:icf',
556 '/ignore:4198,4010,4037,4039,4065,4070,4078,4087,4089,4221',
557 '/incremental:no',
558 '/fullbuild',
559 '/release',
560 '/nodefaultlib',
561 '/wx',
562 '/debug',
563 '/debugtype:cv',
564 '/version:5.1',
565 '/osversion:5.1',
566 '/functionpadmin:5',
567 '/safeseh',
568 '/pdbcompress',
569 '/stack:0x40000,0x1000',
570 '/driver',
571 '/align:0x80',
572 '/subsystem:native,5.01',
573 '/base:0x10000',
574
575 '/entry:DrvEnableDriver',
576 ]
577 if env['build'] != 'release':
578 linkflags += [
579 '/MAP', # http://msdn.microsoft.com/en-us/library/k7xkk3e2.aspx
580 ]
581 if platform == 'wince':
582 linkflags += [
583 '/nodefaultlib',
584 #'/incremental:no',
585 #'/fullbuild',
586 '/entry:_DllMainCRTStartup',
587 ]
588 env.Append(LINKFLAGS = linkflags)
589 env.Append(SHLINKFLAGS = shlinkflags)
590
591 # We have C++ in several libraries, so always link with the C++ compiler
592 if env['gcc']:
593 env['LINK'] = env['CXX']
594
595 # Default libs
596 env.Append(LIBS = [])
597
598 # Load tools
599 if env['llvm']:
600 env.Tool('llvm')
601 env.Tool('udis86')
602
603 pkg_config_modules(env, 'x11', ['x11', 'xext'])
604 pkg_config_modules(env, 'drm', ['libdrm'])
605 pkg_config_modules(env, 'drm_intel', ['libdrm_intel'])
606 pkg_config_modules(env, 'drm_radeon', ['libdrm_radeon'])
607 pkg_config_modules(env, 'xorg', ['xorg-server'])
608 pkg_config_modules(env, 'kms', ['libkms'])
609
610 env['dri'] = env['x11'] and env['drm']
611
612 # Custom builders and methods
613 env.Tool('custom')
614 createInstallMethods(env)
615
616 # for debugging
617 #print env.Dump()
618
619
620 def exists(env):
621 return 1