3 Frontend-tool for Gallium3D architecture.
8 # Copyright 2008 VMware, Inc.
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:
19 # The above copyright notice and this permission notice (including the
20 # next paragraph) shall be included in all copies or substantial portions
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 VMWARE 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.
33 import distutils
.version
38 import platform
as host_platform
47 def symlink(target
, source
, env
):
48 target
= str(target
[0])
49 source
= str(source
[0])
50 if os
.path
.islink(target
) or os
.path
.exists(target
):
52 os
.symlink(os
.path
.basename(source
), target
)
54 def install(env
, source
, subdir
):
55 target_dir
= os
.path
.join(env
.Dir('#.').srcnode().abspath
, env
['build_dir'], subdir
)
56 return env
.Install(target_dir
, source
)
58 def install_program(env
, source
):
59 return install(env
, source
, 'bin')
61 def install_shared_library(env
, sources
, version
= ()):
63 install_dir
= os
.path
.join(env
.Dir('#.').srcnode().abspath
, env
['build_dir'])
64 version
= tuple(map(str, version
))
65 if env
['SHLIBSUFFIX'] == '.dll':
66 dlls
= env
.FindIxes(sources
, 'SHLIBPREFIX', 'SHLIBSUFFIX')
67 targets
+= install(env
, dlls
, 'bin')
68 libs
= env
.FindIxes(sources
, 'LIBPREFIX', 'LIBSUFFIX')
69 targets
+= install(env
, libs
, 'lib')
71 for source
in sources
:
72 target_dir
= os
.path
.join(install_dir
, 'lib')
73 target_name
= '.'.join((str(source
),) + version
)
74 last
= env
.InstallAs(os
.path
.join(target_dir
, target_name
), source
)
77 version
= version
[:-1]
78 target_name
= '.'.join((str(source
),) + version
)
79 action
= SCons
.Action
.Action(symlink
, " Symlinking $TARGET ...")
80 last
= env
.Command(os
.path
.join(target_dir
, target_name
), last
, action
)
85 def msvc2013_compat(env
):
87 env
.Append(CCFLAGS
= [
89 '-Werror=pointer-arith',
93 def unit_test(env
, test_name
, program_target
, args
=None):
94 env
.InstallProgram(program_target
)
96 cmd
= [program_target
[0].abspath
]
101 # http://www.scons.org/wiki/UnitTests
102 action
= SCons
.Action
.Action(cmd
, " Running $SOURCE ...")
103 alias
= env
.Alias(test_name
, program_target
, action
)
104 env
.AlwaysBuild(alias
)
105 env
.Depends('check', alias
)
110 return int(os
.environ
['NUMBER_OF_PROCESSORS'])
111 except (ValueError, KeyError):
115 return os
.sysconf('SC_NPROCESSORS_ONLN')
116 except (ValueError, OSError, AttributeError):
120 return int(os
.popen2("sysctl -n hw.ncpu")[1].read())
127 def check_cc(env
, cc
, expr
, cpp_opt
= '-E'):
128 # Invoke C-preprocessor to determine whether the specified expression is
131 sys
.stdout
.write('Checking for %s ... ' % cc
)
133 source
= tempfile
.NamedTemporaryFile(suffix
='.c', delete
=False)
134 source
.write('#if !(%s)\n#error\n#endif\n' % expr
)
137 pipe
= SCons
.Action
._subproc
(env
, [env
['CC'], cpp_opt
, source
.name
],
141 result
= pipe
.wait() == 0
143 os
.unlink(source
.name
)
145 sys
.stdout
.write(' %s\n' % ['no', 'yes'][int(bool(result
))])
149 def check_prog(env
, prog
):
150 """Check whether this program exists."""
152 sys
.stdout
.write('Checking for %s ... ' % prog
)
154 result
= env
.Detect(prog
)
156 sys
.stdout
.write(' %s\n' % ['no', 'yes'][int(bool(result
))])
161 """Common environment generation code"""
163 # Tell tools which machine to compile for
164 env
['TARGET_ARCH'] = env
['machine']
165 env
['MSVS_ARCH'] = env
['machine']
168 platform
= env
['platform']
169 env
.Tool(env
['toolchain'])
171 # Allow override compiler and specify additional flags from environment
172 if os
.environ
.has_key('CC'):
173 env
['CC'] = os
.environ
['CC']
174 # Update CCVERSION to match
175 pipe
= SCons
.Action
._subproc
(env
, [env
['CC'], '--version'],
178 stdout
= subprocess
.PIPE
)
180 line
= pipe
.stdout
.readline()
181 match
= re
.search(r
'[0-9]+(\.[0-9]+)+', line
)
183 env
['CCVERSION'] = match
.group(0)
184 if os
.environ
.has_key('CFLAGS'):
185 env
['CCFLAGS'] += SCons
.Util
.CLVar(os
.environ
['CFLAGS'])
186 if os
.environ
.has_key('CXX'):
187 env
['CXX'] = os
.environ
['CXX']
188 if os
.environ
.has_key('CXXFLAGS'):
189 env
['CXXFLAGS'] += SCons
.Util
.CLVar(os
.environ
['CXXFLAGS'])
190 if os
.environ
.has_key('LDFLAGS'):
191 env
['LINKFLAGS'] += SCons
.Util
.CLVar(os
.environ
['LDFLAGS'])
193 # Detect gcc/clang not by executable name, but through pre-defined macros
194 # as autoconf does, to avoid drawing wrong conclusions when using tools
195 # that overrice CC/CXX like scan-build.
199 if host_platform
.system() == 'Windows':
200 env
['msvc'] = check_cc(env
, 'MSVC', 'defined(_MSC_VER)', '/E')
202 env
['gcc'] = check_cc(env
, 'GCC', 'defined(__GNUC__) && !defined(__clang__)')
203 env
['clang'] = check_cc(env
, 'Clang', '__clang__')
204 env
['suncc'] = env
['platform'] == 'sunos' and os
.path
.basename(env
['CC']) == 'cc'
205 env
['icc'] = 'icc' == os
.path
.basename(env
['CC'])
207 if env
['msvc'] and env
['toolchain'] == 'default' and env
['machine'] == 'x86_64':
208 # MSVC x64 support is broken in earlier versions of scons
209 env
.EnsurePythonVersion(2, 0)
212 machine
= env
['machine']
213 platform
= env
['platform']
214 x86
= env
['machine'] == 'x86'
215 ppc
= env
['machine'] == 'ppc'
216 gcc_compat
= env
['gcc'] or env
['clang']
221 # Determine whether we are cross compiling; in particular, whether we need
222 # to compile code generators with a different compiler as the target code.
223 hosthost_platform
= host_platform
.system().lower()
224 if hosthost_platform
.startswith('cygwin'):
225 hosthost_platform
= 'cygwin'
226 host_machine
= os
.environ
.get('PROCESSOR_ARCHITEW6432', os
.environ
.get('PROCESSOR_ARCHITECTURE', host_platform
.machine()))
236 }.get(host_machine
, 'generic')
237 env
['crosscompile'] = platform
!= hosthost_platform
238 if machine
== 'x86_64' and host_machine
!= 'x86_64':
239 env
['crosscompile'] = True
240 env
['hostonly'] = False
242 # Backwards compatability with the debug= profile= options
243 if env
['build'] == 'debug':
245 print 'scons: warning: debug option is deprecated and will be removed eventually; use instead'
247 print ' scons build=release'
249 env
['build'] = 'release'
251 print 'scons: warning: profile option is deprecated and will be removed eventually; use instead'
253 print ' scons build=profile'
255 env
['build'] = 'profile'
257 # Enforce SConscripts to use the new build variable
259 env
.popitem('profile')
261 # Backwards portability with older sconscripts
262 if env
['build'] in ('debug', 'checked'):
264 env
['profile'] = False
265 if env
['build'] == 'profile':
267 env
['profile'] = True
268 if env
['build'] == 'release':
270 env
['profile'] = False
272 # Put build output in a separate dir, which depends on the current
273 # configuration. See also http://www.scons.org/wiki/AdvancedBuildExample
274 build_topdir
= 'build'
275 build_subdir
= env
['platform']
277 build_subdir
= 'embedded-' + build_subdir
278 if env
['machine'] != 'generic':
279 build_subdir
+= '-' + env
['machine']
280 if env
['build'] != 'release':
281 build_subdir
+= '-' + env
['build']
282 build_dir
= os
.path
.join(build_topdir
, build_subdir
)
283 # Place the .sconsign file in the build dir too, to avoid issues with
284 # different scons versions building the same source file
285 env
['build_dir'] = build_dir
286 env
.SConsignFile(os
.path
.join(build_dir
, '.sconsign'))
287 if 'SCONS_CACHE_DIR' in os
.environ
:
288 print 'scons: Using build cache in %s.' % (os
.environ
['SCONS_CACHE_DIR'],)
289 env
.CacheDir(os
.environ
['SCONS_CACHE_DIR'])
290 env
['CONFIGUREDIR'] = os
.path
.join(build_dir
, 'conf')
291 env
['CONFIGURELOG'] = os
.path
.join(os
.path
.abspath(build_dir
), 'config.log')
294 if env
.GetOption('num_jobs') <= 1:
295 env
.SetOption('num_jobs', num_jobs())
297 env
.Decider('MD5-timestamp')
298 env
.SetOption('max_drift', 60)
300 # C preprocessor options
302 cppdefines
+= ['__STDC_LIMIT_MACROS', '__STDC_CONSTANT_MACROS']
303 if env
['build'] in ('debug', 'checked'):
304 cppdefines
+= ['DEBUG']
306 cppdefines
+= ['NDEBUG']
307 if env
['build'] == 'profile':
308 cppdefines
+= ['PROFILE']
309 if env
['platform'] in ('posix', 'linux', 'freebsd', 'darwin'):
312 ('_POSIX_C_SOURCE', '199309L'),
318 'HAVE_POSIX_MEMALIGN',
320 if env
['platform'] == 'darwin':
324 'GLX_DIRECT_RENDERING',
328 'GLX_DIRECT_RENDERING',
329 'GLX_INDIRECT_RENDERING',
331 if env
['platform'] in ('linux', 'freebsd'):
332 cppdefines
+= ['HAVE_ALIAS']
334 cppdefines
+= ['GLX_ALIAS_UNSUPPORTED']
336 if env
['platform'] in ('linux', 'darwin'):
337 cppdefines
+= ['HAVE_XLOCALE_H']
339 if env
['platform'] == 'haiku':
342 'HAVE_POSIX_MEMALIGN'
344 if platform
== 'windows':
350 # http://msdn.microsoft.com/en-us/library/aa383745.aspx
351 ('_WIN32_WINNT', '0x0601'),
352 ('WINVER', '0x0601'),
355 cppdefines
+= [('__MSVCRT_VERSION__', '0x0700')]
360 '_CRT_SECURE_NO_WARNINGS',
361 '_CRT_SECURE_NO_DEPRECATE',
362 '_SCL_SECURE_NO_WARNINGS',
363 '_SCL_SECURE_NO_DEPRECATE',
364 '_ALLOW_KEYWORD_MACROS',
365 '_HAS_EXCEPTIONS=0', # Tell C++ STL to not use exceptions
367 if env
['build'] in ('debug', 'checked'):
368 cppdefines
+= ['_DEBUG']
369 if platform
== 'windows':
370 cppdefines
+= ['PIPE_SUBSYSTEM_WINDOWS_USER']
372 cppdefines
+= ['PIPE_SUBSYSTEM_EMBEDDED']
373 if env
['texture_float']:
374 print 'warning: Floating-point textures enabled.'
375 print 'warning: Please consult docs/patents.txt with your lawyer before building Mesa.'
376 cppdefines
+= ['TEXTURE_FLOAT_ENABLED']
378 ccversion
= env
['CCVERSION']
380 'HAVE___BUILTIN_EXPECT',
381 'HAVE___BUILTIN_FFS',
382 'HAVE___BUILTIN_FFSLL',
383 'HAVE_FUNC_ATTRIBUTE_FLATTEN',
384 'HAVE_FUNC_ATTRIBUTE_UNUSED',
386 'HAVE_FUNC_ATTRIBUTE_FORMAT',
387 'HAVE_FUNC_ATTRIBUTE_PACKED',
389 'HAVE___BUILTIN_CTZ',
390 'HAVE___BUILTIN_POPCOUNT',
391 'HAVE___BUILTIN_POPCOUNTLL',
392 'HAVE___BUILTIN_CLZ',
393 'HAVE___BUILTIN_CLZLL',
395 if distutils
.version
.LooseVersion(ccversion
) >= distutils
.version
.LooseVersion('4.5'):
396 cppdefines
+= ['HAVE___BUILTIN_UNREACHABLE']
397 env
.Append(CPPDEFINES
= cppdefines
)
402 ccflags
= [] # C & C++
404 ccversion
= env
['CCVERSION']
405 if env
['build'] == 'debug':
407 elif env
['gcc'] and ccversion
.startswith('4.2.'):
408 # gcc 4.2.x optimizer is broken
409 print "warning: gcc 4.2.x optimizer is broken -- disabling optimizations"
414 # gcc's builtin memcmp is slower than glibc's
415 # http://gcc.gnu.org/bugzilla/show_bug.cgi?id=43052
416 ccflags
+= ['-fno-builtin-memcmp']
417 # Work around aliasing bugs - developers should comment this out
418 ccflags
+= ['-fno-strict-aliasing']
420 if env
['build'] in ('checked', 'profile') or env
['asan']:
421 # See http://code.google.com/p/jrfonseca/wiki/Gprof2Dot#Which_options_should_I_pass_to_gcc_when_compiling_for_profiling?
423 '-fno-omit-frame-pointer',
426 ccflags
+= ['-fno-optimize-sibling-calls']
427 if env
['machine'] == 'x86':
432 if platform
!= 'haiku':
433 # NOTE: We need to ensure stack is realigned given that we
434 # produce shared objects, and have no control over the stack
435 # alignment policy of the application. Therefore we need
436 # -mstackrealign ore -mincoming-stack-boundary=2.
438 # XXX: We could have SSE without -mstackrealign if we always used
439 # __attribute__((force_align_arg_pointer)), but that's not
442 '-mstackrealign', # ensure stack is aligned
443 '-msse', '-msse2', # enable SIMD intrinsics
444 '-mfpmath=sse', # generate SSE floating-point arithmetic
446 if platform
in ['windows', 'darwin']:
447 # Workaround http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37216
448 ccflags
+= ['-fno-common']
449 if platform
in ['haiku']:
450 # Make optimizations compatible with Pentium or higher on Haiku
452 '-mstackrealign', # ensure stack is aligned
453 '-march=i586', # Haiku target is Pentium
454 '-mtune=i686' # use i686 where we can
456 if env
['machine'] == 'x86_64':
458 if platform
== 'darwin':
459 ccflags
+= ['-fno-common']
460 if env
['platform'] not in ('cygwin', 'haiku', 'windows'):
461 ccflags
+= ['-fvisibility=hidden']
463 # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
467 '-fmessage-length=0', # be nice to Eclipse
470 '-Wmissing-prototypes',
479 # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
481 if env
['build'] == 'debug':
483 '/Od', # disable optimizations
484 '/Oi', # enable intrinsic functions
488 '/O2', # optimize for speed
490 if env
['build'] == 'release':
492 '/GL', # enable whole program optimization
496 '/Oy-', # disable frame pointer omission
497 '/GL-', # disable whole program optimization
500 '/W3', # warning level
501 '/wd4018', # signed/unsigned mismatch
502 '/wd4056', # overflow in floating-point constant arithmetic
503 '/wd4244', # conversion from 'type1' to 'type2', possible loss of data
504 '/wd4267', # 'var' : conversion from 'size_t' to 'type', possible loss of data
505 '/wd4305', # truncation from 'type1' to 'type2'
506 '/wd4351', # new behavior: elements of array 'array' will be default initialized
507 '/wd4756', # overflow in constant arithmetic
508 '/wd4800', # forcing value to bool 'true' or 'false' (performance warning)
509 '/wd4996', # disable deprecated POSIX name warnings
511 if env
['machine'] == 'x86':
513 '/arch:SSE2', # use the SSE2 instructions (default since MSVC 2012)
515 if platform
== 'windows':
519 # Automatic pdb generation
520 # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
521 env
.EnsureSConsVersion(0, 98, 0)
522 env
['PDB'] = '${TARGET.base}.pdb'
523 env
.Append(CCFLAGS
= ccflags
)
524 env
.Append(CFLAGS
= cflags
)
525 env
.Append(CXXFLAGS
= cxxflags
)
527 if env
['platform'] == 'windows' and msvc
:
528 # Choose the appropriate MSVC CRT
529 # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
530 if env
['build'] in ('debug', 'checked'):
531 env
.Append(CCFLAGS
= ['/MTd'])
532 env
.Append(SHCCFLAGS
= ['/LDd'])
534 env
.Append(CCFLAGS
= ['/MT'])
535 env
.Append(SHCCFLAGS
= ['/LD'])
537 # Static code analysis
540 # http://msdn.microsoft.com/en-us/library/ms173498.aspx
541 env
.Append(CCFLAGS
= [
543 #'/analyze:log', '${TARGET.base}.xml',
544 '/wd28251', # Inconsistent annotation for function
547 # scan-build will produce more comprehensive output
548 env
.Append(CCFLAGS
= ['--analyze'])
550 # https://github.com/google/sanitizers/wiki/AddressSanitizer
553 env
.Append(CCFLAGS
= [
554 '-fsanitize=address',
556 env
.Append(LINKFLAGS
= [
557 '-fsanitize=address',
562 if env
['machine'] == 'x86':
563 env
.Append(ASFLAGS
= ['-m32'])
564 if env
['machine'] == 'x86_64':
565 env
.Append(ASFLAGS
= ['-m64'])
571 if env
['machine'] == 'x86':
572 linkflags
+= ['-m32']
573 if env
['machine'] == 'x86_64':
574 linkflags
+= ['-m64']
575 if env
['platform'] not in ('darwin'):
579 # Handle circular dependencies in the libraries
580 if env
['platform'] in ('darwin'):
583 env
['_LIBFLAGS'] = '-Wl,--start-group ' + env
['_LIBFLAGS'] + ' -Wl,--end-group'
584 if env
['platform'] == 'windows':
586 '-Wl,--nxcompat', # DEP
587 '-Wl,--dynamicbase', # ASLR
589 # Avoid depending on gcc runtime DLLs
590 linkflags
+= ['-static-libgcc']
591 if 'w64' in env
['CC'].split('-'):
592 linkflags
+= ['-static-libstdc++']
593 # Handle the @xx symbol munging of DLL exports
594 shlinkflags
+= ['-Wl,--enable-stdcall-fixup']
595 #shlinkflags += ['-Wl,--kill-at']
597 if env
['build'] == 'release':
598 # enable Link-time Code Generation
599 linkflags
+= ['/LTCG']
600 env
.Append(ARFLAGS
= ['/LTCG'])
601 if platform
== 'windows' and msvc
:
603 # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
607 '/dynamicbase', # ASLR
610 env
.Append(LINKFLAGS
= linkflags
)
611 env
.Append(SHLINKFLAGS
= shlinkflags
)
613 # We have C++ in several libraries, so always link with the C++ compiler
615 env
['LINK'] = env
['CXX']
619 if env
['platform'] in ('darwin', 'freebsd', 'linux', 'posix', 'sunos'):
620 libs
+= ['m', 'pthread', 'dl']
621 if env
['platform'] in ('linux',):
623 if env
['platform'] in ('haiku'):
624 libs
+= ['root', 'be', 'network', 'translation']
625 env
.Append(LIBS
= libs
)
630 env
.Append(CCFLAGS
= ['/openmp'])
631 # When building openmp release VS2008 link.exe crashes with LNK1103 error.
632 # Workaround: overwrite PDB flags with empty value as it isn't required anyways
633 if env
['build'] == 'release':
636 env
.Append(CCFLAGS
= ['-fopenmp'])
637 env
.Append(LIBS
= ['gomp'])
642 env
.Append(LEXFLAGS
= [
643 # Force flex to use const keyword in prototypes, as relies on
644 # __cplusplus or __STDC__ macro to determine whether it's safe to
645 # use const keyword, but MSVC never defines __STDC__ unless we
646 # disable all MSVC extensions.
649 # Flex relies on __STDC_VERSION__>=199901L to decide when to include
650 # C99 inttypes.h. We always have inttypes.h available with MSVC
651 # (either the one bundled with MSVC 2013, or the one we bundle
652 # ourselves), but we can't just define __STDC_VERSION__ without
653 # breaking stuff, as MSVC doesn't fully support C99. There's also no
654 # way to premptively include stdint.
655 env
.Append(CCFLAGS
= ['-FIinttypes.h'])
656 if host_platform
.system() == 'Windows':
657 # Prefer winflexbison binaries, as not only they are easier to install
658 # (no additional dependencies), but also better Windows support.
659 if check_prog(env
, 'win_flex'):
660 env
["LEX"] = 'win_flex'
661 env
.Append(LEXFLAGS
= [
662 # windows compatibility (uses <io.h> instead of <unistd.h> and
663 # _isatty, _fileno functions)
668 if host_platform
.system() == 'Windows':
669 if check_prog(env
, 'win_bison'):
670 env
["YACC"] = 'win_bison'
675 # Custom builders and methods
677 env
.AddMethod(install_program
, 'InstallProgram')
678 env
.AddMethod(install_shared_library
, 'InstallSharedLibrary')
679 env
.AddMethod(msvc2013_compat
, 'MSVC2013Compat')
680 env
.AddMethod(unit_test
, 'UnitTest')
682 env
.PkgCheckModules('X11', ['x11', 'xext', 'xdamage', 'xfixes', 'glproto >= 1.4.13'])
683 env
.PkgCheckModules('XCB', ['x11-xcb', 'xcb-glx >= 1.8.1', 'xcb-dri2 >= 1.8'])
684 env
.PkgCheckModules('XF86VIDMODE', ['xxf86vm'])
685 env
.PkgCheckModules('DRM', ['libdrm >= 2.4.38'])
686 env
.PkgCheckModules('UDEV', ['libudev >= 151'])
689 env
.Append(CPPPATH
= env
['X11_CPPPATH'])
691 env
['dri'] = env
['x11'] and env
['drm']