3 Frontend-tool for Gallium3D architecture.
8 # Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas.
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 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.
33 import distutils
.version
38 import platform
as _platform
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
):
50 os
.symlink(os
.path
.basename(source
), target
)
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
)
56 def install_program(env
, source
):
57 return install(env
, source
, 'bin')
59 def install_shared_library(env
, sources
, version
= ()):
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')
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
)
75 version
= version
[:-1]
76 target_name
= '.'.join((str(source
),) + version
)
77 action
= SCons
.Action
.Action(symlink
, " Symlinking $TARGET ...")
78 last
= env
.Command(os
.path
.join(target_dir
, target_name
), last
, action
)
83 def createInstallMethods(env
):
84 env
.AddMethod(install_program
, 'InstallProgram')
85 env
.AddMethod(install_shared_library
, 'InstallSharedLibrary')
90 return int(os
.environ
['NUMBER_OF_PROCESSORS'])
91 except (ValueError, KeyError):
95 return os
.sysconf('SC_NPROCESSORS_ONLN')
96 except (ValueError, OSError, AttributeError):
100 return int(os
.popen2("sysctl -n hw.ncpu")[1].read())
107 def pkg_config_modules(env
, name
, modules
):
108 '''Simple wrapper for pkg-config.'''
112 if env
['platform'] == 'windows':
115 if not env
.Detect('pkg-config'):
118 if subprocess
.call(["pkg-config", "--exists", ' '.join(modules
)]) != 0:
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
124 env
.ParseConfig('pkg-config --cflags-only-I --libs-only-L ' + ' '.join(modules
))
128 # Other flags may affect the compilation of unrelated targets, so store
129 # them with a prefix, (e.g., XXX_CFLAGS, XXX_LIBS, etc)
131 flags
= env
.ParseFlags('!pkg-config --cflags-only-other --libs-only-l --libs-only-other ' + ' '.join(modules
))
134 prefix
= name
.upper() + '_'
135 for flag_name
, flag_value
in flags
.iteritems():
136 env
[prefix
+ flag_name
] = flag_value
143 """Common environment generation code"""
145 # Tell tools which machine to compile for
146 env
['TARGET_ARCH'] = env
['machine']
147 env
['MSVS_ARCH'] = env
['machine']
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'])
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'],
165 stdout
= subprocess
.PIPE
)
167 line
= pipe
.stdout
.readline()
168 match
= re
.search(r
'[0-9]+(\.[0-9]+)+', line
)
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'])
180 env
['gcc'] = 'gcc' in os
.path
.basename(env
['CC']).split('-')
181 env
['msvc'] = env
['CC'] == 'cl'
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)
188 machine
= env
['machine']
189 platform
= env
['platform']
190 x86
= env
['machine'] == 'x86'
191 ppc
= env
['machine'] == 'ppc'
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 if host_platform
.startswith('cygwin'):
199 host_platform
= 'cygwin'
200 host_machine
= os
.environ
.get('PROCESSOR_ARCHITEW6432', os
.environ
.get('PROCESSOR_ARCHITECTURE', _platform
.machine()))
210 }.get(host_machine
, 'generic')
211 env
['crosscompile'] = platform
!= host_platform
212 if machine
== 'x86_64' and host_machine
!= 'x86_64':
213 env
['crosscompile'] = True
214 env
['hostonly'] = False
216 # Backwards compatability with the debug= profile= options
217 if env
['build'] == 'debug':
219 print 'scons: warning: debug option is deprecated and will be removed eventually; use instead'
221 print ' scons build=release'
223 env
['build'] = 'release'
225 print 'scons: warning: profile option is deprecated and will be removed eventually; use instead'
227 print ' scons build=profile'
229 env
['build'] = 'profile'
231 # Enforce SConscripts to use the new build variable
233 env
.popitem('profile')
235 # Backwards portability with older sconscripts
236 if env
['build'] in ('debug', 'checked'):
238 env
['profile'] = False
239 if env
['build'] == 'profile':
241 env
['profile'] = True
242 if env
['build'] == 'release':
244 env
['profile'] = False
246 # Put build output in a separate dir, which depends on the current
247 # configuration. See also http://www.scons.org/wiki/AdvancedBuildExample
248 build_topdir
= 'build'
249 build_subdir
= env
['platform']
251 build_subdir
= 'embedded-' + build_subdir
252 if env
['machine'] != 'generic':
253 build_subdir
+= '-' + env
['machine']
254 if env
['build'] != 'release':
255 build_subdir
+= '-' + env
['build']
256 build_dir
= os
.path
.join(build_topdir
, build_subdir
)
257 # Place the .sconsign file in the build dir too, to avoid issues with
258 # different scons versions building the same source file
259 env
['build_dir'] = build_dir
260 env
.SConsignFile(os
.path
.join(build_dir
, '.sconsign'))
261 if 'SCONS_CACHE_DIR' in os
.environ
:
262 print 'scons: Using build cache in %s.' % (os
.environ
['SCONS_CACHE_DIR'],)
263 env
.CacheDir(os
.environ
['SCONS_CACHE_DIR'])
264 env
['CONFIGUREDIR'] = os
.path
.join(build_dir
, 'conf')
265 env
['CONFIGURELOG'] = os
.path
.join(os
.path
.abspath(build_dir
), 'config.log')
268 if env
.GetOption('num_jobs') <= 1:
269 env
.SetOption('num_jobs', num_jobs())
271 env
.Decider('MD5-timestamp')
272 env
.SetOption('max_drift', 60)
274 # C preprocessor options
276 if env
['build'] in ('debug', 'checked'):
277 cppdefines
+= ['DEBUG']
279 cppdefines
+= ['NDEBUG']
280 if env
['build'] == 'profile':
281 cppdefines
+= ['PROFILE']
282 if env
['platform'] in ('posix', 'linux', 'freebsd', 'darwin'):
285 ('_POSIX_C_SOURCE', '199309L'),
290 'HAVE_POSIX_MEMALIGN',
292 if env
['platform'] == 'darwin':
296 'GLX_DIRECT_RENDERING',
300 'GLX_DIRECT_RENDERING',
301 'GLX_INDIRECT_RENDERING',
303 if env
['platform'] in ('linux', 'freebsd'):
304 cppdefines
+= ['HAVE_ALIAS']
306 cppdefines
+= ['GLX_ALIAS_UNSUPPORTED']
307 if platform
== 'windows':
313 # http://msdn.microsoft.com/en-us/library/aa383745.aspx
314 ('_WIN32_WINNT', '0x0601'),
315 ('WINVER', '0x0601'),
317 if msvc
and env
['toolchain'] != 'winddk':
321 '_CRT_SECURE_NO_WARNINGS',
322 '_CRT_SECURE_NO_DEPRECATE',
323 '_SCL_SECURE_NO_WARNINGS',
324 '_SCL_SECURE_NO_DEPRECATE',
326 if env
['build'] in ('debug', 'checked'):
327 cppdefines
+= ['_DEBUG']
328 if env
['toolchain'] == 'winddk':
329 # Mimic WINDDK's builtin flags. See also:
330 # - WINDDK's bin/makefile.new i386mk.inc for more info.
331 # - buildchk_wxp_x86.log files, generated by the WINDDK's build
332 # - http://alter.org.ua/docs/nt_kernel/vc8_proj/
334 cppdefines
+= ['_X86_', 'i386']
335 if machine
== 'x86_64':
336 cppdefines
+= ['_AMD64_', 'AMD64']
337 if platform
== 'winddk':
340 ('CONDITION_HANDLING', '1'),
345 ('_WIN32_WINNT', '0x0501'), # minimum required OS version
346 ('WINVER', '0x0501'),
347 ('_WIN32_IE', '0x0603'),
348 ('WIN32_LEAN_AND_MEAN', '1'),
350 ('__BUILDMACHINE__', 'WinDDK'),
353 if env
['build'] in ('debug', 'checked'):
354 cppdefines
+= [('DBG', 1)]
355 if platform
== 'wince':
357 '_CRT_SECURE_NO_DEPRECATE',
362 ('_WIN32_WCE', '0x600'),
370 ('INTLMSG_CODEPAGE', '1252'),
372 if platform
== 'windows':
373 cppdefines
+= ['PIPE_SUBSYSTEM_WINDOWS_USER']
374 if platform
== 'winddk':
375 cppdefines
+= ['PIPE_SUBSYSTEM_WINDOWS_DISPLAY']
376 if platform
== 'wince':
377 cppdefines
+= ['PIPE_SUBSYSTEM_WINDOWS_CE']
378 cppdefines
+= ['PIPE_SUBSYSTEM_WINDOWS_CE_OGL']
380 cppdefines
+= ['PIPE_SUBSYSTEM_EMBEDDED']
381 env
.Append(CPPDEFINES
= cppdefines
)
386 ccflags
= [] # C & C++
388 ccversion
= env
['CCVERSION']
389 if env
['build'] == 'debug':
391 elif ccversion
.startswith('4.2.'):
392 # gcc 4.2.x optimizer is broken
393 print "warning: gcc 4.2.x optimizer is broken -- disabling optimizations"
397 # Work around aliasing bugs - developers should comment this out
398 ccflags
+= ['-fno-strict-aliasing']
400 if env
['build'] in ('checked', 'profile'):
401 # See http://code.google.com/p/jrfonseca/wiki/Gprof2Dot#Which_options_should_I_pass_to_gcc_when_compiling_for_profiling?
403 '-fno-omit-frame-pointer',
404 '-fno-optimize-sibling-calls',
406 if env
['machine'] == 'x86':
411 if distutils
.version
.LooseVersion(ccversion
) >= distutils
.version
.LooseVersion('4.2') \
412 and (platform
!= 'windows' or env
['build'] == 'debug' or True):
413 # NOTE: We need to ensure stack is realigned given that we
414 # produce shared objects, and have no control over the stack
415 # alignment policy of the application. Therefore we need
416 # -mstackrealign ore -mincoming-stack-boundary=2.
418 # XXX: -O and -mstackrealign causes stack corruption on MinGW
420 # XXX: We could have SSE without -mstackrealign if we always used
421 # __attribute__((force_align_arg_pointer)), but that's not
424 '-mstackrealign', # ensure stack is aligned
425 '-mmmx', '-msse', '-msse2', # enable SIMD intrinsics
428 if platform
in ['windows', 'darwin']:
429 # Workaround http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37216
430 ccflags
+= ['-fno-common']
431 if env
['machine'] == 'x86_64':
433 if platform
== 'darwin':
434 ccflags
+= ['-fno-common']
435 if env
['platform'] != 'windows':
436 ccflags
+= ['-fvisibility=hidden']
438 # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
443 '-fmessage-length=0', # be nice to Eclipse
446 '-Wmissing-prototypes',
449 if distutils
.version
.LooseVersion(ccversion
) >= distutils
.version
.LooseVersion('4.0'):
451 '-Wmissing-field-initializers',
453 if distutils
.version
.LooseVersion(ccversion
) >= distutils
.version
.LooseVersion('4.2'):
458 '-Wdeclaration-after-statement',
462 # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
464 if env
['build'] == 'debug':
466 '/Od', # disable optimizations
467 '/Oi', # enable intrinsic functions
468 '/Oy-', # disable frame pointer omission
472 '/O2', # optimize for speed
474 if env
['build'] == 'release':
476 '/GL', # enable whole program optimization
480 '/GL-', # disable whole program optimization
483 '/fp:fast', # fast floating point
484 '/W3', # warning level
485 #'/Wp64', # enable 64 bit porting warnings
487 if env
['machine'] == 'x86':
489 #'/arch:SSE2', # use the SSE2 instructions
491 if platform
== 'windows':
495 if platform
== 'winddk':
497 '/Zl', # omit default library name in .OBJ
498 '/Zp8', # 8bytes struct member alignment
499 '/Gy', # separate functions for linker
500 '/Gm-', # disable minimal rebuild
501 '/WX', # treat warnings as errors
502 '/Gz', # __stdcall Calling convention
503 '/GX-', # disable C++ EH
504 '/GR-', # disable C++ RTTI
505 '/GF', # enable read-only string pooling
506 '/G6', # optimize for PPro, P-II, P-III
507 '/Ze', # enable extensions
508 '/Gi-', # disable incremental compilation
509 '/QIfdiv-', # disable Pentium FDIV fix
510 '/hotpatch', # prepares an image for hotpatching.
511 #'/Z7', #enable old-style debug info
513 if platform
== 'wince':
514 # See also C:\WINCE600\public\common\oak\misc\makefile.def
516 '/Zl', # omit default library name in .OBJ
517 '/GF', # enable read-only string pooling
518 '/GR-', # disable C++ RTTI
519 '/GS', # enable security checks
520 # Allow disabling language conformance to maintain backward compat
521 #'/Zc:wchar_t-', # don't force wchar_t as native type, instead of typedef
522 #'/Zc:forScope-', # don't enforce Standard C++ for scoping rules
528 # Automatic pdb generation
529 # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
530 env
.EnsureSConsVersion(0, 98, 0)
531 env
['PDB'] = '${TARGET.base}.pdb'
532 env
.Append(CCFLAGS
= ccflags
)
533 env
.Append(CFLAGS
= cflags
)
534 env
.Append(CXXFLAGS
= cxxflags
)
536 if env
['platform'] == 'windows' and msvc
:
537 # Choose the appropriate MSVC CRT
538 # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
539 if env
['build'] in ('debug', 'checked'):
540 env
.Append(CCFLAGS
= ['/MTd'])
541 env
.Append(SHCCFLAGS
= ['/LDd'])
543 env
.Append(CCFLAGS
= ['/MT'])
544 env
.Append(SHCCFLAGS
= ['/LD'])
548 if env
['machine'] == 'x86':
549 env
.Append(ASFLAGS
= ['-m32'])
550 if env
['machine'] == 'x86_64':
551 env
.Append(ASFLAGS
= ['-m64'])
557 if env
['machine'] == 'x86':
558 linkflags
+= ['-m32']
559 if env
['machine'] == 'x86_64':
560 linkflags
+= ['-m64']
561 if env
['platform'] not in ('darwin'):
565 # Handle circular dependencies in the libraries
566 if env
['platform'] in ('darwin'):
569 env
['_LIBFLAGS'] = '-Wl,--start-group ' + env
['_LIBFLAGS'] + ' -Wl,--end-group'
571 if env
['build'] == 'release':
572 # enable Link-time Code Generation
573 linkflags
+= ['/LTCG']
574 env
.Append(ARFLAGS
= ['/LTCG'])
575 if platform
== 'windows' and msvc
:
577 # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
582 if platform
== 'winddk':
585 '/merge:_TEXT=.text',
589 '/ignore:4198,4010,4037,4039,4065,4070,4078,4087,4089,4221',
602 '/stack:0x40000,0x1000',
605 '/subsystem:native,5.01',
608 '/entry:DrvEnableDriver',
610 if env
['build'] != 'release':
612 '/MAP', # http://msdn.microsoft.com/en-us/library/k7xkk3e2.aspx
614 if platform
== 'wince':
619 '/entry:_DllMainCRTStartup',
621 env
.Append(LINKFLAGS
= linkflags
)
622 env
.Append(SHLINKFLAGS
= shlinkflags
)
624 # We have C++ in several libraries, so always link with the C++ compiler
626 env
['LINK'] = env
['CXX']
630 if env
['platform'] in ('posix', 'linux', 'freebsd', 'darwin'):
631 libs
+= ['m', 'pthread', 'dl']
632 env
.Append(LIBS
= libs
)
640 pkg_config_modules(env
, 'x11', ['x11', 'xext'])
641 pkg_config_modules(env
, 'drm', ['libdrm'])
642 pkg_config_modules(env
, 'drm_intel', ['libdrm_intel'])
643 pkg_config_modules(env
, 'drm_radeon', ['libdrm_radeon'])
644 pkg_config_modules(env
, 'xorg', ['xorg-server'])
645 pkg_config_modules(env
, 'kms', ['libkms'])
647 env
['dri'] = env
['x11'] and env
['drm']
649 # Custom builders and methods
651 createInstallMethods(env
)