f9a2e592db8746063ad3ba82f8c3f191eb78d04a
[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_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 'x86_64': 'x86_64',
207 }.get(host_machine, 'generic')
208 env['crosscompile'] = platform != host_platform
209 if machine == 'x86_64' and host_machine != 'x86_64':
210 env['crosscompile'] = True
211
212 # Backwards compatability with the debug= profile= options
213 if env['build'] == 'debug':
214 if not env['debug']:
215 print 'scons: warning: debug option is deprecated and will be removed eventually; use instead'
216 print
217 print ' scons build=release'
218 print
219 env['build'] = 'release'
220 if env['profile']:
221 print 'scons: warning: profile option is deprecated and will be removed eventually; use instead'
222 print
223 print ' scons build=profile'
224 print
225 env['build'] = 'profile'
226 if False:
227 # Enforce SConscripts to use the new build variable
228 env.popitem('debug')
229 env.popitem('profile')
230 else:
231 # Backwards portability with older sconscripts
232 if env['build'] in ('debug', 'checked'):
233 env['debug'] = True
234 env['profile'] = False
235 if env['build'] == 'profile':
236 env['debug'] = False
237 env['profile'] = True
238 if env['build'] == 'release':
239 env['debug'] = False
240 env['profile'] = False
241
242 # Put build output in a separate dir, which depends on the current
243 # configuration. See also http://www.scons.org/wiki/AdvancedBuildExample
244 build_topdir = 'build'
245 build_subdir = env['platform']
246 if env['machine'] != 'generic':
247 build_subdir += '-' + env['machine']
248 if env['build'] != 'release':
249 build_subdir += '-' + env['build']
250 build_dir = os.path.join(build_topdir, build_subdir)
251 # Place the .sconsign file in the build dir too, to avoid issues with
252 # different scons versions building the same source file
253 env['build_dir'] = build_dir
254 env.SConsignFile(os.path.join(build_dir, '.sconsign'))
255 if 'SCONS_CACHE_DIR' in os.environ:
256 print 'scons: Using build cache in %s.' % (os.environ['SCONS_CACHE_DIR'],)
257 env.CacheDir(os.environ['SCONS_CACHE_DIR'])
258 env['CONFIGUREDIR'] = os.path.join(build_dir, 'conf')
259 env['CONFIGURELOG'] = os.path.join(os.path.abspath(build_dir), 'config.log')
260
261 # Parallel build
262 if env.GetOption('num_jobs') <= 1:
263 env.SetOption('num_jobs', num_jobs())
264
265 env.Decider('MD5-timestamp')
266 env.SetOption('max_drift', 60)
267
268 # C preprocessor options
269 cppdefines = []
270 if env['build'] in ('debug', 'checked'):
271 cppdefines += ['DEBUG']
272 else:
273 cppdefines += ['NDEBUG']
274 if env['build'] == 'profile':
275 cppdefines += ['PROFILE']
276 if platform == 'windows':
277 cppdefines += [
278 'WIN32',
279 '_WINDOWS',
280 #'_UNICODE',
281 #'UNICODE',
282 # http://msdn.microsoft.com/en-us/library/aa383745.aspx
283 ('_WIN32_WINNT', '0x0601'),
284 ('WINVER', '0x0601'),
285 ]
286 if msvc and env['toolchain'] != 'winddk':
287 cppdefines += [
288 'VC_EXTRALEAN',
289 '_USE_MATH_DEFINES',
290 '_CRT_SECURE_NO_WARNINGS',
291 '_CRT_SECURE_NO_DEPRECATE',
292 '_SCL_SECURE_NO_WARNINGS',
293 '_SCL_SECURE_NO_DEPRECATE',
294 ]
295 if env['build'] in ('debug', 'checked'):
296 cppdefines += ['_DEBUG']
297 if env['toolchain'] == 'winddk':
298 # Mimic WINDDK's builtin flags. See also:
299 # - WINDDK's bin/makefile.new i386mk.inc for more info.
300 # - buildchk_wxp_x86.log files, generated by the WINDDK's build
301 # - http://alter.org.ua/docs/nt_kernel/vc8_proj/
302 if machine == 'x86':
303 cppdefines += ['_X86_', 'i386']
304 if machine == 'x86_64':
305 cppdefines += ['_AMD64_', 'AMD64']
306 if platform == 'winddk':
307 cppdefines += [
308 'STD_CALL',
309 ('CONDITION_HANDLING', '1'),
310 ('NT_INST', '0'),
311 ('WIN32', '100'),
312 ('_NT1X_', '100'),
313 ('WINNT', '1'),
314 ('_WIN32_WINNT', '0x0501'), # minimum required OS version
315 ('WINVER', '0x0501'),
316 ('_WIN32_IE', '0x0603'),
317 ('WIN32_LEAN_AND_MEAN', '1'),
318 ('DEVL', '1'),
319 ('__BUILDMACHINE__', 'WinDDK'),
320 ('FPO', '0'),
321 ]
322 if env['build'] in ('debug', 'checked'):
323 cppdefines += [('DBG', 1)]
324 if platform == 'wince':
325 cppdefines += [
326 '_CRT_SECURE_NO_DEPRECATE',
327 '_USE_32BIT_TIME_T',
328 'UNICODE',
329 '_UNICODE',
330 ('UNDER_CE', '600'),
331 ('_WIN32_WCE', '0x600'),
332 'WINCEOEM',
333 'WINCEINTERNAL',
334 'WIN32',
335 'STRICT',
336 'x86',
337 '_X86_',
338 'INTERNATIONAL',
339 ('INTLMSG_CODEPAGE', '1252'),
340 ]
341 if platform == 'windows':
342 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_USER']
343 if platform == 'winddk':
344 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_DISPLAY']
345 if platform == 'wince':
346 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE']
347 cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE_OGL']
348 if platform == 'embedded':
349 cppdefines += ['PIPE_OS_EMBEDDED']
350 env.Append(CPPDEFINES = cppdefines)
351
352 # C compiler options
353 cflags = [] # C
354 cxxflags = [] # C++
355 ccflags = [] # C & C++
356 if gcc:
357 ccversion = env['CCVERSION']
358 if env['build'] == 'debug':
359 ccflags += ['-O0']
360 elif ccversion.startswith('4.2.'):
361 # gcc 4.2.x optimizer is broken
362 print "warning: gcc 4.2.x optimizer is broken -- disabling optimizations"
363 ccflags += ['-O0']
364 else:
365 ccflags += ['-O3']
366 ccflags += ['-g3']
367 if env['build'] in ('checked', 'profile'):
368 # See http://code.google.com/p/jrfonseca/wiki/Gprof2Dot#Which_options_should_I_pass_to_gcc_when_compiling_for_profiling?
369 ccflags += [
370 '-fno-omit-frame-pointer',
371 '-fno-optimize-sibling-calls',
372 ]
373 if env['machine'] == 'x86':
374 ccflags += [
375 '-m32',
376 #'-march=pentium4',
377 ]
378 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.2') \
379 and (platform != 'windows' or env['build'] == 'debug' or True):
380 # NOTE: We need to ensure stack is realigned given that we
381 # produce shared objects, and have no control over the stack
382 # alignment policy of the application. Therefore we need
383 # -mstackrealign ore -mincoming-stack-boundary=2.
384 #
385 # XXX: -O and -mstackrealign causes stack corruption on MinGW
386 #
387 # XXX: We could have SSE without -mstackrealign if we always used
388 # __attribute__((force_align_arg_pointer)), but that's not
389 # always the case.
390 ccflags += [
391 '-mstackrealign', # ensure stack is aligned
392 '-mmmx', '-msse', '-msse2', # enable SIMD intrinsics
393 #'-mfpmath=sse',
394 ]
395 if platform in ['windows', 'darwin']:
396 # Workaround http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37216
397 ccflags += ['-fno-common']
398 if env['machine'] == 'x86_64':
399 ccflags += ['-m64']
400 if platform == 'darwin':
401 ccflags += ['-fno-common']
402 # See also:
403 # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
404 ccflags += [
405 '-Wall',
406 '-Wno-long-long',
407 '-ffast-math',
408 '-fmessage-length=0', # be nice to Eclipse
409 ]
410 cflags += [
411 '-Wmissing-prototypes',
412 '-std=gnu99',
413 ]
414 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.0'):
415 ccflags += [
416 '-Wmissing-field-initializers',
417 ]
418 if distutils.version.LooseVersion(ccversion) >= distutils.version.LooseVersion('4.2'):
419 ccflags += [
420 '-Werror=pointer-arith',
421 ]
422 cflags += [
423 '-Werror=declaration-after-statement',
424 ]
425 if msvc:
426 # See also:
427 # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
428 # - cl /?
429 if env['build'] == 'debug':
430 ccflags += [
431 '/Od', # disable optimizations
432 '/Oi', # enable intrinsic functions
433 '/Oy-', # disable frame pointer omission
434 ]
435 else:
436 ccflags += [
437 '/O2', # optimize for speed
438 ]
439 if env['build'] == 'release':
440 ccflags += [
441 '/GL', # enable whole program optimization
442 ]
443 else:
444 ccflags += [
445 '/GL-', # disable whole program optimization
446 ]
447 ccflags += [
448 '/fp:fast', # fast floating point
449 '/W3', # warning level
450 #'/Wp64', # enable 64 bit porting warnings
451 ]
452 if env['machine'] == 'x86':
453 ccflags += [
454 #'/arch:SSE2', # use the SSE2 instructions
455 ]
456 if platform == 'windows':
457 ccflags += [
458 # TODO
459 ]
460 if platform == 'winddk':
461 ccflags += [
462 '/Zl', # omit default library name in .OBJ
463 '/Zp8', # 8bytes struct member alignment
464 '/Gy', # separate functions for linker
465 '/Gm-', # disable minimal rebuild
466 '/WX', # treat warnings as errors
467 '/Gz', # __stdcall Calling convention
468 '/GX-', # disable C++ EH
469 '/GR-', # disable C++ RTTI
470 '/GF', # enable read-only string pooling
471 '/G6', # optimize for PPro, P-II, P-III
472 '/Ze', # enable extensions
473 '/Gi-', # disable incremental compilation
474 '/QIfdiv-', # disable Pentium FDIV fix
475 '/hotpatch', # prepares an image for hotpatching.
476 #'/Z7', #enable old-style debug info
477 ]
478 if platform == 'wince':
479 # See also C:\WINCE600\public\common\oak\misc\makefile.def
480 ccflags += [
481 '/Zl', # omit default library name in .OBJ
482 '/GF', # enable read-only string pooling
483 '/GR-', # disable C++ RTTI
484 '/GS', # enable security checks
485 # Allow disabling language conformance to maintain backward compat
486 #'/Zc:wchar_t-', # don't force wchar_t as native type, instead of typedef
487 #'/Zc:forScope-', # don't enforce Standard C++ for scoping rules
488 #'/wd4867',
489 #'/wd4430',
490 #'/MT',
491 #'/U_MT',
492 ]
493 # Automatic pdb generation
494 # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
495 env.EnsureSConsVersion(0, 98, 0)
496 env['PDB'] = '${TARGET.base}.pdb'
497 env.Append(CCFLAGS = ccflags)
498 env.Append(CFLAGS = cflags)
499 env.Append(CXXFLAGS = cxxflags)
500
501 if env['platform'] == 'windows' and msvc:
502 # Choose the appropriate MSVC CRT
503 # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
504 if env['build'] in ('debug', 'checked'):
505 env.Append(CCFLAGS = ['/MTd'])
506 env.Append(SHCCFLAGS = ['/LDd'])
507 else:
508 env.Append(CCFLAGS = ['/MT'])
509 env.Append(SHCCFLAGS = ['/LD'])
510
511 # Assembler options
512 if gcc:
513 if env['machine'] == 'x86':
514 env.Append(ASFLAGS = ['-m32'])
515 if env['machine'] == 'x86_64':
516 env.Append(ASFLAGS = ['-m64'])
517
518 # Linker options
519 linkflags = []
520 shlinkflags = []
521 if gcc:
522 if env['machine'] == 'x86':
523 linkflags += ['-m32']
524 if env['machine'] == 'x86_64':
525 linkflags += ['-m64']
526 if env['platform'] not in ('darwin'):
527 shlinkflags += [
528 '-Wl,-Bsymbolic',
529 ]
530 # Handle circular dependencies in the libraries
531 if env['platform'] in ('darwin'):
532 pass
533 else:
534 env['_LIBFLAGS'] = '-Wl,--start-group ' + env['_LIBFLAGS'] + ' -Wl,--end-group'
535 if msvc:
536 if env['build'] == 'release':
537 # enable Link-time Code Generation
538 linkflags += ['/LTCG']
539 env.Append(ARFLAGS = ['/LTCG'])
540 if platform == 'windows' and msvc:
541 # See also:
542 # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
543 linkflags += [
544 '/fixed:no',
545 '/incremental:no',
546 ]
547 if platform == 'winddk':
548 linkflags += [
549 '/merge:_PAGE=PAGE',
550 '/merge:_TEXT=.text',
551 '/section:INIT,d',
552 '/opt:ref',
553 '/opt:icf',
554 '/ignore:4198,4010,4037,4039,4065,4070,4078,4087,4089,4221',
555 '/incremental:no',
556 '/fullbuild',
557 '/release',
558 '/nodefaultlib',
559 '/wx',
560 '/debug',
561 '/debugtype:cv',
562 '/version:5.1',
563 '/osversion:5.1',
564 '/functionpadmin:5',
565 '/safeseh',
566 '/pdbcompress',
567 '/stack:0x40000,0x1000',
568 '/driver',
569 '/align:0x80',
570 '/subsystem:native,5.01',
571 '/base:0x10000',
572
573 '/entry:DrvEnableDriver',
574 ]
575 if env['build'] != 'release':
576 linkflags += [
577 '/MAP', # http://msdn.microsoft.com/en-us/library/k7xkk3e2.aspx
578 ]
579 if platform == 'wince':
580 linkflags += [
581 '/nodefaultlib',
582 #'/incremental:no',
583 #'/fullbuild',
584 '/entry:_DllMainCRTStartup',
585 ]
586 env.Append(LINKFLAGS = linkflags)
587 env.Append(SHLINKFLAGS = shlinkflags)
588
589 # We have C++ in several libraries, so always link with the C++ compiler
590 if env['gcc']:
591 env['LINK'] = env['CXX']
592
593 # Default libs
594 env.Append(LIBS = [])
595
596 # Load tools
597 if env['llvm']:
598 env.Tool('llvm')
599 env.Tool('udis86')
600
601 pkg_config_modules(env, 'x11', ['x11', 'xext'])
602 pkg_config_modules(env, 'drm', ['libdrm'])
603 pkg_config_modules(env, 'drm_intel', ['libdrm_intel'])
604 pkg_config_modules(env, 'drm_radeon', ['libdrm_radeon'])
605 pkg_config_modules(env, 'xorg', ['xorg-server'])
606 pkg_config_modules(env, 'kms', ['libkms'])
607
608 env['dri'] = env['x11'] and env['drm']
609
610 # Custom builders and methods
611 env.Tool('custom')
612 createInstallMethods(env)
613
614 # for debugging
615 #print env.Dump()
616
617
618 def exists(env):
619 return 1