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 = []
 322     if gcc:
 323         if debug:
 324             cflags += ['-O0', '-g3']
 325         elif env['toolchain'] == 'crossmingw':
 326             cflags += ['-O0', '-g3'] # mingw 4.2.1 optimizer is broken
 327         else:
 328             cflags += ['-O3', '-g3']
 329         if env['profile']:
 330             cflags += ['-pg']
 331         if env['machine'] == 'x86':
 332             cflags += [
 333                 '-m32',
 334                 #'-march=pentium4',
 335                 '-mmmx', '-msse', '-msse2', # enable SIMD intrinsics
 336                 #'-mfpmath=sse',
 337             ]
 338         if env['machine'] == 'x86_64':
 339             cflags += ['-m64']
 340         # See also:
 341         # - http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html
 342         cflags += [
 343             '-Werror=declaration-after-statement',
 344             '-Wall',
 345             '-Wmissing-prototypes',
 346             '-Wmissing-field-initializers',
 347             '-Wpointer-arith',
 348             '-Wno-long-long',
 349             '-ffast-math',
 350             '-std=gnu99',
 351             '-fmessage-length=0', # be nice to Eclipse
 352         ]
 353     if msvc:
 354         # See also:
 355         # - http://msdn.microsoft.com/en-us/library/19z1t1wy.aspx
 356         # - cl /?
 357         if debug:
 358             cflags += [
 359               '/Od', # disable optimizations
 360               '/Oi', # enable intrinsic functions
 361               '/Oy-', # disable frame pointer omission
 362               '/GL-', # disable whole program optimization
 363             ]
 364         else:
 365             cflags += [
 366                 '/O2', # optimize for speed
 367                 #'/fp:fast', # fast floating point
 368             ]
 369         if env['profile']:
 370             cflags += [
 371                 '/Gh', # enable _penter hook function
 372                 '/GH', # enable _pexit hook function
 373             ]
 374         cflags += [
 375             '/W3', # warning level
 376             #'/Wp64', # enable 64 bit porting warnings
 377         ]
 378         if env['machine'] == 'x86':
 379             cflags += [
 380                 #'/QIfist', # Suppress _ftol
 381                 #'/arch:SSE2', # use the SSE2 instructions
 382             ]
 383         if platform == 'windows':
 384             cflags += [
 385                 # TODO
 386             ]
 387         if platform == 'winddk':
 388             cflags += [
 389                 '/Zl', # omit default library name in .OBJ
 390                 '/Zp8', # 8bytes struct member alignment
 391                 '/Gy', # separate functions for linker
 392                 '/Gm-', # disable minimal rebuild
 393                 '/WX', # treat warnings as errors
 394                 '/Gz', # __stdcall Calling convention
 395                 '/GX-', # disable C++ EH
 396                 '/GR-', # disable C++ RTTI
 397                 '/GF', # enable read-only string pooling
 398                 '/G6', # optimize for PPro, P-II, P-III
 399                 '/Ze', # enable extensions
 400                 '/Gi-', # disable incremental compilation
 401                 '/QIfdiv-', # disable Pentium FDIV fix
 402                 '/hotpatch', # prepares an image for hotpatching.
 403                 #'/Z7', #enable old-style debug info
 404             ]
 405         if platform == 'wince':
 406             # See also C:\WINCE600\public\common\oak\misc\makefile.def
 407             cflags += [
 408                 '/Zl', # omit default library name in .OBJ
 409                 '/GF', # enable read-only string pooling
 410                 '/GR-', # disable C++ RTTI
 411                 '/GS', # enable security checks
 412                 # Allow disabling language conformance to maintain backward compat
 413                 #'/Zc:wchar_t-', # don't force wchar_t as native type, instead of typedef
 414                 #'/Zc:forScope-', # don't enforce Standard C++ for scoping rules
 415                 #'/wd4867',
 416                 #'/wd4430',
 417                 #'/MT',
 418                 #'/U_MT',
 419             ]
 420         # Automatic pdb generation
 421         # See http://scons.tigris.org/issues/show_bug.cgi?id=1656
 422         env.EnsureSConsVersion(0, 98, 0)
 423         env['PDB'] = '${TARGET.base}.pdb'
 424     env.Append(CFLAGS = cflags)
 425     env.Append(CXXFLAGS = cflags)
 426
 427     if env['platform'] == 'windows' and msvc:
 428         # Choose the appropriate MSVC CRT
 429         # http://msdn.microsoft.com/en-us/library/2kzt1wy3.aspx
 430         if env['debug']:
 431             env.Append(CCFLAGS = ['/MTd'])
 432             env.Append(SHCCFLAGS = ['/LDd'])
 433         else:
 434             env.Append(CCFLAGS = ['/MT'])
 435             env.Append(SHCCFLAGS = ['/LD'])
 436
 437     # Assembler options
 438     if gcc:
 439         if env['machine'] == 'x86':
 440             env.Append(ASFLAGS = ['-m32'])
 441         if env['machine'] == 'x86_64':
 442             env.Append(ASFLAGS = ['-m64'])
 443
 444     # Linker options
 445     linkflags = []
 446     if gcc:
 447         if env['machine'] == 'x86':
 448             linkflags += ['-m32']
 449         if env['machine'] == 'x86_64':
 450             linkflags += ['-m64']
 451     if platform == 'windows' and msvc:
 452         # See also:
 453         # - http://msdn2.microsoft.com/en-us/library/y0zzbyt4.aspx
 454         linkflags += [
 455             '/fixed:no',
 456             '/incremental:no',
 457         ]
 458     if platform == 'winddk':
 459         linkflags += [
 460             '/merge:_PAGE=PAGE',
 461             '/merge:_TEXT=.text',
 462             '/section:INIT,d',
 463             '/opt:ref',
 464             '/opt:icf',
 465             '/ignore:4198,4010,4037,4039,4065,4070,4078,4087,4089,4221',
 466             '/incremental:no',
 467             '/fullbuild',
 468             '/release',
 469             '/nodefaultlib',
 470             '/wx',
 471             '/debug',
 472             '/debugtype:cv',
 473             '/version:5.1',
 474             '/osversion:5.1',
 475             '/functionpadmin:5',
 476             '/safeseh',
 477             '/pdbcompress',
 478             '/stack:0x40000,0x1000',
 479             '/driver',
 480             '/align:0x80',
 481             '/subsystem:native,5.01',
 482             '/base:0x10000',
 483
 484             '/entry:DrvEnableDriver',
 485         ]
 486         if env['debug'] or env['profile']:
 487             linkflags += [
 488                 '/MAP', # http://msdn.microsoft.com/en-us/library/k7xkk3e2.aspx
 489             ]
 490     if platform == 'wince':
 491         linkflags += [
 492             '/nodefaultlib',
 493             #'/incremental:no',
 494             #'/fullbuild',
 495             '/entry:_DllMainCRTStartup',
 496         ]
 497     env.Append(LINKFLAGS = linkflags)
 498
 499     # Default libs
 500     env.Append(LIBS = [])
 501
 502     # Custom builders and methods
 503     createConvenienceLibBuilder(env)
 504     createCodeGenerateMethod(env)
 505     createInstallMethods(env)
 506
 507     # for debugging
 508     #print env.Dump()
 509
 510
 511 def exists(env):
 512     return 1