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 os
  34 import os.path
  35 import re
  36
  37 import SCons.Action
  38 import SCons.Builder
  39 import SCons.Scanner
  40
  41
  42 def quietCommandLines(env):
  43     # Quiet command lines
  44     # See also http://www.scons.org/wiki/HidingCommandLinesInOutput
  45     env['ASCOMSTR'] = "Assembling $SOURCE ..."
  46     env['CCCOMSTR'] = "Compiling $SOURCE ..."
  47     env['SHCCCOMSTR'] = "Compiling $SOURCE ..."
  48     env['CXXCOMSTR'] = "Compiling $SOURCE ..."
  49     env['SHCXXCOMSTR'] = "Compiling $SOURCE ..."
  50     env['ARCOMSTR'] = "Archiving $TARGET ..."
  51     env['RANLIBCOMSTR'] = "Indexing $TARGET ..."
  52     env['LINKCOMSTR'] = "Linking $TARGET ..."
  53     env['SHLINKCOMSTR'] = "Linking $TARGET ..."
  54     env['LDMODULECOMSTR'] = "Linking $TARGET ..."
  55     env['SWIGCOMSTR'] = "Generating $TARGET ..."
  56
  57
  58 def createConvenienceLibBuilder(env):
  59     """This is a utility function that creates the ConvenienceLibrary
  60     Builder in an Environment if it is not there already.
  61
  62     If it is already there, we return the existing one.
  63
  64     Based on the stock StaticLibrary and SharedLibrary builders.
  65     """
  66
  67     try:
  68         convenience_lib = env['BUILDERS']['ConvenienceLibrary']
  69     except KeyError:
  70         action_list = [ SCons.Action.Action("$ARCOM", "$ARCOMSTR") ]
  71         if env.Detect('ranlib'):
  72             ranlib_action = SCons.Action.Action("$RANLIBCOM", "$RANLIBCOMSTR")
  73             action_list.append(ranlib_action)
  74
  75         convenience_lib = SCons.Builder.Builder(action = action_list,
  76                                   emitter = '$LIBEMITTER',
  77                                   prefix = '$LIBPREFIX',
  78                                   suffix = '$LIBSUFFIX',
  79                                   src_suffix = '$SHOBJSUFFIX',
  80                                   src_builder = 'SharedObject')
  81         env['BUILDERS']['ConvenienceLibrary'] = convenience_lib
  82
  83     return convenience_lib
  84
  85
  86 # TODO: handle import statements with multiple modules
  87 # TODO: handle from import statements
  88 import_re = re.compile(r'^import\s+(\S+)$', re.M)
  89
  90 def python_scan(node, env, path):
  91     # http://www.scons.org/doc/0.98.5/HTML/scons-user/c2781.html#AEN2789
  92     contents = node.get_contents()
  93     source_dir = node.get_dir()
  94     imports = import_re.findall(contents)
  95     results = []
  96     for imp in imports:
  97         for dir in path:
  98             file = os.path.join(str(dir), imp.replace('.', os.sep) + '.py')
  99             if os.path.exists(file):
 100                 results.append(env.File(file))
 101                 break
 102             file = os.path.join(str(dir), imp.replace('.', os.sep), '__init__.py')
 103             if os.path.exists(file):
 104                 results.append(env.File(file))
 105                 break
 106     return results
 107
 108 python_scanner = SCons.Scanner.Scanner(function = python_scan, skeys = ['.py'])
 109
 110
 111 def code_generate(env, script, target, source, command):
 112     """Method to simplify code generation via python scripts.
 113
 114     http://www.scons.org/wiki/UsingCodeGenerators
 115     http://www.scons.org/doc/0.98.5/HTML/scons-user/c2768.html
 116     """
 117
 118     # We're generating code using Python scripts, so we have to be
 119     # careful with our scons elements.  This entry represents
 120     # the generator file *in the source directory*.
 121     script_src = env.File(script).srcnode()
 122
 123     # This command creates generated code *in the build directory*.
 124     command = command.replace('$SCRIPT', script_src.path)
 125     code = env.Command(target, source, command)
 126
 127     # Explicitly mark that the generated code depends on the generator,
 128     # and on implicitly imported python modules
 129     path = (script_src.get_dir(),)
 130     deps = [script_src]
 131     deps += script_src.get_implicit_deps(env, python_scanner, path)
 132     env.Depends(code, deps)
 133
 134     # Running the Python script causes .pyc files to be generated in the
 135     # source directory.  When we clean up, they should go too. So add side
 136     # effects for .pyc files
 137     for dep in deps:
 138         pyc = env.File(str(dep) + 'c')
 139         env.SideEffect(pyc, code)
 140
 141     return code
 142
 143
 144 def createCodeGenerateMethod(env):
 145     env.Append(SCANNERS = python_scanner)
 146     env.AddMethod(code_generate, 'CodeGenerate')
 147
 148
 149 def symlink(target, source, env):
 150     target = str(target[0])
 151     source = str(source[0])
 152     if os.path.islink(target) or os.path.exists(target):
 153         os.remove(target)
 154     os.symlink(os.path.basename(source), target)
 155
 156 def install_shared_library(env, source, version = ()):
 157     source = str(source[0])
 158     version = tuple(map(str, version))
 159     target_dir =  os.path.join(env.Dir('#.').srcnode().abspath, env['build'], 'lib')
 160     target_name = '.'.join((str(source),) + version)
 161     last = env.InstallAs(os.path.join(target_dir, target_name), source)
 162     while len(version):
 163         version = version[:-1]
 164         target_name = '.'.join((str(source),) + version)
 165         action = SCons.Action.Action(symlink, "$TARGET -> $SOURCE")
 166         last = env.Command(os.path.join(target_dir, target_name), last, action)
 167
 168 def createInstallMethods(env):
 169     env.AddMethod(install_shared_library, 'InstallSharedLibrary')
 170
 171
 172 def num_jobs():
 173     try:
 174         return int(os.environ['NUMBER_OF_PROCESSORS'])
 175     except (ValueError, KeyError):
 176         pass
 177
 178     try:
 179         return os.sysconf('SC_NPROCESSORS_ONLN')
 180     except (ValueError, OSError, AttributeError):
 181         pass
 182
 183     try:
 184         return int(os.popen2("sysctl -n hw.ncpu")[1].read())
 185     except ValueError:
 186         pass
 187
 188     return 1
 189
 190
 191 def generate(env):
 192     """Common environment generation code"""
 193
 194     if env.get('quiet', True):
 195         quietCommandLines(env)
 196
 197     # Toolchain
 198     platform = env['platform']
 199     if env['toolchain'] == 'default':
 200         if platform == 'winddk':
 201             env['toolchain'] = 'winddk'
 202         elif platform == 'wince':
 203             env['toolchain'] = 'wcesdk'
 204     env.Tool(env['toolchain'])
 205
 206     env['gcc'] = 'gcc' in os.path.basename(env['CC']).split('-')
 207     env['msvc'] = env['CC'] == 'cl'
 208
 209     # shortcuts
 210     debug = env['debug']
 211     machine = env['machine']
 212     platform = env['platform']
 213     x86 = env['machine'] == 'x86'
 214     ppc = env['machine'] == 'ppc'
 215     gcc = env['gcc']
 216     msvc = env['msvc']
 217
 218     # Put build output in a separate dir, which depends on the current
 219     # configuration. See also http://www.scons.org/wiki/AdvancedBuildExample
 220     build_topdir = 'build'
 221     build_subdir = env['platform']
 222     if env['llvm']:
 223         build_subdir += "-llvm"
 224     if env['machine'] != 'generic':
 225         build_subdir += '-' + env['machine']
 226     if env['debug']:
 227         build_subdir += "-debug"
 228     if env['profile']:
 229         build_subdir += "-profile"
 230     build_dir = os.path.join(build_topdir, build_subdir)
 231     # Place the .sconsign file in the build dir too, to avoid issues with
 232     # different scons versions building the same source file
 233     env['build'] = build_dir
 234     env.SConsignFile(os.path.join(build_dir, '.sconsign'))
 235     env.CacheDir('build/cache')
 236
 237     # Parallel build
 238     if env.GetOption('num_jobs') <= 1:
 239         env.SetOption('num_jobs', num_jobs())
 240
 241     # C preprocessor options
 242     cppdefines = []
 243     if debug:
 244         cppdefines += ['DEBUG']
 245     else:
 246         cppdefines += ['NDEBUG']
 247     if env['profile']:
 248         cppdefines += ['PROFILE']
 249     if platform == 'windows':
 250         cppdefines += [
 251             'WIN32',
 252             '_WINDOWS',
 253             #'_UNICODE',
 254             #'UNICODE',
 255             ('_WIN32_WINNT', '0x0501'), # minimum required OS version
 256             ('WINVER', '0x0501'),
 257             # http://msdn2.microsoft.com/en-us/library/6dwk3a1z.aspx,
 258             'WIN32_LEAN_AND_MEAN',
 259         ]
 260         if msvc and env['toolchain'] != 'winddk':
 261             cppdefines += [
 262                 'VC_EXTRALEAN',
 263                 '_CRT_SECURE_NO_DEPRECATE',
 264             ]
 265         if debug:
 266             cppdefines += ['_DEBUG']
 267     if env['toolchain'] == 'winddk':
 268         # Mimic WINDDK's builtin flags. See also:
 269         # - WINDDK's bin/makefile.new i386mk.inc for more info.
 270         # - buildchk_wxp_x86.log files, generated by the WINDDK's build
 271         # - http://alter.org.ua/docs/nt_kernel/vc8_proj/
 272         if machine == 'x86':
 273             cppdefines += ['_X86_', 'i386']
 274         if machine == 'x86_64':
 275             cppdefines += ['_AMD64_', 'AMD64']
 276     if platform == 'winddk':
 277         cppdefines += [
 278             'STD_CALL',
 279             ('CONDITION_HANDLING', '1'),
 280             ('NT_INST', '0'),
 281             ('WIN32', '100'),
 282             ('_NT1X_', '100'),
 283             ('WINNT', '1'),
 284             ('_WIN32_WINNT', '0x0501'), # minimum required OS version
 285             ('WINVER', '0x0501'),
 286             ('_WIN32_IE', '0x0603'),
 287             ('WIN32_LEAN_AND_MEAN', '1'),
 288             ('DEVL', '1'),
 289             ('__BUILDMACHINE__', 'WinDDK'),
 290             ('FPO', '0'),
 291         ]
 292         if debug:
 293             cppdefines += [('DBG', 1)]
 294     if platform == 'wince':
 295         cppdefines += [
 296             '_CRT_SECURE_NO_DEPRECATE',
 297             '_USE_32BIT_TIME_T',
 298             'UNICODE',
 299             '_UNICODE',
 300             ('UNDER_CE', '600'),
 301             ('_WIN32_WCE', '0x600'),
 302             'WINCEOEM',
 303             'WINCEINTERNAL',
 304             'WIN32',
 305             'STRICT',
 306             'x86',
 307             '_X86_',
 308             'INTERNATIONAL',
 309             ('INTLMSG_CODEPAGE', '1252'),
 310         ]
 311     if platform == 'windows':
 312         cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_USER']
 313     if platform == 'winddk':
 314         cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_DISPLAY']
 315     if platform == 'wince':
 316         cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE']
 317         cppdefines += ['PIPE_SUBSYSTEM_WINDOWS_CE_OGL']
 318     env.Append(CPPDEFINES = cppdefines)
 319
 320     # C compiler options
 321     cflags = [] # C
 322     cxxflags = [] # C++
 323     ccflags = [] # C & C++
 324     if gcc:
 325         if debug:
 326             ccflags += ['-O0', '-g3']
 327         elif env['toolchain'] == 'crossmingw':
 328             ccflags += ['-O0', '-g3'] # mingw 4.2.1 optimizer is broken
 329         else:
 330             ccflags += ['-O3', '-g3']
 331         if env['profile']:
 332             ccflags += ['-pg']
 333         if env['machine'] == 'x86':
 334             ccflags += [
 335                 '-m32',
 336                 #'-march=pentium4',
 337                 '-mmmx', '-msse', '-msse2', # enable SIMD intrinsics
 338                 #'-mfpmath=sse',
 339             ]
 340         if env['machine'] == 'x86_64':
 341             ccflags += ['-m64']
 342         # See also:
 343         # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
 344         ccflags += [
 345             '-Wall',
 346             '-Wmissing-field-initializers',
 347             '-Wpointer-arith',
 348             '-Wno-long-long',
 349             '-ffast-math',
 350             '-fmessage-length=0', # be nice to Eclipse
 351         ]
 352         cflags += [
 353             '-Werror=declaration-after-statement',
 354             '-Wmissing-prototypes',
 355             '-std=gnu99',
 356         ]
 357     if msvc:
 358         # See also:
 359         # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
 360         # - cl /?
 361         if debug:
 362             ccflags += [
 363               '/Od', # disable optimizations
 364               '/Oi', # enable intrinsic functions
 365               '/Oy-', # disable frame pointer omission
 366               '/GL-', # disable whole program optimization
 367             ]
 368         else:
 369             ccflags += [
 370                 '/O2', # optimize for speed
 371                 #'/fp:fast', # fast floating point
 372             ]
 373         if env['profile']:
 374             ccflags += [
 375                 '/Gh', # enable _penter hook function
 376                 '/GH', # enable _pexit hook function
 377             ]
 378         ccflags += [
 379             '/W3', # warning level
 380             #'/Wp64', # enable 64 bit porting warnings
 381         ]
 382         if env['machine'] == 'x86':
 383             ccflags += [
 384                 #'/QIfist', # Suppress _ftol
 385                 #'/arch:SSE2', # use the SSE2 instructions
 386             ]
 387         if platform == 'windows':
 388             ccflags += [
 389                 # TODO
 390             ]
 391         if platform == 'winddk':
 392             ccflags += [
 393                 '/Zl', # omit default library name in .OBJ
 394                 '/Zp8', # 8bytes struct member alignment
 395                 '/Gy', # separate functions for linker
 396                 '/Gm-', # disable minimal rebuild
 397                 '/WX', # treat warnings as errors
 398                 '/Gz', # __stdcall Calling convention
 399                 '/GX-', # disable C++ EH
 400                 '/GR-', # disable C++ RTTI
 401                 '/GF', # enable read-only string pooling
 402                 '/G6', # optimize for PPro, P-II, P-III
 403                 '/Ze', # enable extensions
 404                 '/Gi-', # disable incremental compilation
 405                 '/QIfdiv-', # disable Pentium FDIV fix
 406                 '/hotpatch', # prepares an image for hotpatching.
 407                 #'/Z7', #enable old-style debug info
 408             ]
 409         if platform == 'wince':
 410             # See also C:\WINCE600\public\common\oak\misc\makefile.def
 411             ccflags += [
 412                 '/Zl', # omit default library name in .OBJ
 413                 '/GF', # enable read-only string pooling
 414                 '/GR-', # disable C++ RTTI
 415                 '/GS', # enable security checks
 416                 # Allow disabling language conformance to maintain backward compat
 417                 #'/Zc:wchar_t-', # don't force wchar_t as native type, instead of typedef
 418                 #'/Zc:forScope-', # don't enforce Standard C++ for scoping rules
 419                 #'/wd4867',
 420                 #'/wd4430',
 421                 #'/MT',
 422                 #'/U_MT',
 423             ]
 424         # Automatic pdb generation
 425         # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
 426         env.EnsureSConsVersion(0, 98, 0)
 427         env['PDB'] = '${TARGET.base}.pdb'
 428     env.Append(CCFLAGS = ccflags)
 429     env.Append(CFLAGS = cflags)
 430     env.Append(CXXFLAGS = cxxflags)
 431
 432     if env['platform'] == 'windows' and msvc:
 433         # Choose the appropriate MSVC CRT
 434         # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
 435         if env['debug']:
 436             env.Append(CCFLAGS = ['/MTd'])
 437             env.Append(SHCCFLAGS = ['/LDd'])
 438         else:
 439             env.Append(CCFLAGS = ['/MT'])
 440             env.Append(SHCCFLAGS = ['/LD'])
 441
 442     # Assembler options
 443     if gcc:
 444         if env['machine'] == 'x86':
 445             env.Append(ASFLAGS = ['-m32'])
 446         if env['machine'] == 'x86_64':
 447             env.Append(ASFLAGS = ['-m64'])
 448
 449     # Linker options
 450     linkflags = []
 451     if gcc:
 452         if env['machine'] == 'x86':
 453             linkflags += ['-m32']
 454         if env['machine'] == 'x86_64':
 455             linkflags += ['-m64']
 456     if platform == 'windows' and msvc:
 457         # See also:
 458         # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
 459         linkflags += [
 460             '/fixed:no',
 461             '/incremental:no',
 462         ]
 463     if platform == 'winddk':
 464         linkflags += [
 465             '/merge:_PAGE=PAGE',
 466             '/merge:_TEXT=.text',
 467             '/section:INIT,d',
 468             '/opt:ref',
 469             '/opt:icf',
 470             '/ignore:4198,4010,4037,4039,4065,4070,4078,4087,4089,4221',
 471             '/incremental:no',
 472             '/fullbuild',
 473             '/release',
 474             '/nodefaultlib',
 475             '/wx',
 476             '/debug',
 477             '/debugtype:cv',
 478             '/version:5.1',
 479             '/osversion:5.1',
 480             '/functionpadmin:5',
 481             '/safeseh',
 482             '/pdbcompress',
 483             '/stack:0x40000,0x1000',
 484             '/driver',
 485             '/align:0x80',
 486             '/subsystem:native,5.01',
 487             '/base:0x10000',
 488
 489             '/entry:DrvEnableDriver',
 490         ]
 491         if env['debug'] or env['profile']:
 492             linkflags += [
 493                 '/MAP', # http://msdn.microsoft.com/en-us/library/k7xkk3e2.aspx
 494             ]
 495     if platform == 'wince':
 496         linkflags += [
 497             '/nodefaultlib',
 498             #'/incremental:no',
 499             #'/fullbuild',
 500             '/entry:_DllMainCRTStartup',
 501         ]
 502     env.Append(LINKFLAGS = linkflags)
 503
 504     # Default libs
 505     env.Append(LIBS = [])
 506
 507     # Custom builders and methods
 508     createConvenienceLibBuilder(env)
 509     createCodeGenerateMethod(env)
 510     createInstallMethods(env)
 511
 512     # for debugging
 513     #print env.Dump()
 514
 515
 516 def exists(env):
 517     return 1