aboutsummaryrefslogtreecommitdiff
path: root/emcc.py
diff options
context:
space:
mode:
Diffstat (limited to 'emcc.py')
-rwxr-xr-xemcc.py231
1 files changed, 0 insertions, 231 deletions
diff --git a/emcc.py b/emcc.py
deleted file mode 100755
index 2499e5d9..00000000
--- a/emcc.py
+++ /dev/null
@@ -1,231 +0,0 @@
-#!/usr/bin/env python
-
-'''
-emcc - compiler helper script
-=============================
-
-emcc is a drop-in replacement for a compiler like gcc or clang.
-
-Tell your build system to use this instead of the compiler, linker, ar and
-ranlib. All the normal build commands will be sent to this script, which
-will proxy them to the appropriate LLVM build commands, in order to
-generate proper code for Emscripten to later process.
-
-For example, compilation will be translated into calls to clang
-with -emit-llvm, and linking will be translated into calls to llvm-link,
-and so forth.
-
-emcc is only meant to *COMPILE* source code into LLVM bitcode. It does
-not do optimizations (in fact, it will disable -Ox flags and warn you
-about that). The reason is that doing such optimizations early can lead
-to bitcode that Emscripten cannot process properly, or can process but
-not fully optimize. You can (and probably should) still run LLVM
-optimizations though, by telling emscripten.py to do so (or run LLVM
-opt yourself, but be careful with the parameters you pass).
-
-Example uses:
-
- * For configure, instead of ./configure, cmake, etc., run emconfiguren.py
- with that command as an argument, for example
-
- emconfiguren.py ./configure [options]
-
- emconfiguren.py is a tiny script that just sets some environment vars
- as a convenience. The command just shown is equivalent to
-
- EMMAKEN_JUST_CONFIGURE=1 RANLIB=PATH/emcc.py AR=PATH/emcc.py CXX=PATH/em++.py CC=PATH/emcc.py ./configure [options]
-
- where PATH is the path to this file.
-
- EMMAKEN_JUST_CONFIGURE tells emcc that it is being run in ./configure,
- so it should relay everything to gcc/g++. You should not define that when
- running make, of course.
-
- * With CMake, the same command will work (with cmake instead of ./configure). You may also be
- able to do the following in your CMakeLists.txt:
-
- SET(CMAKE_C_COMPILER "PATH/emcc.py")
- SET(CMAKE_CXX_COMPILER "PATH/em++.py")
- SET(CMAKE_LINKER "PATH/emcc.py")
- SET(CMAKE_CXX_LINKER "PATH/emcc.py")
- SET(CMAKE_C_LINK_EXECUTABLE "PATH/emcc.py")
- SET(CMAKE_CXX_LINK_EXECUTABLE "PATH/emcc.py")
- SET(CMAKE_AR "PATH/emcc.py")
- SET(CMAKE_RANLIB "PATH/emcc.py")
-
- * For SCons the shared.py can be imported like so:
- __file__ = str(Dir('#/project_path_to_emscripten/dummy/dummy'))
- __rootpath__ = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
- def path_from_root(*pathelems):
- return os.path.join(__rootpath__, *pathelems)
- exec(open(path_from_root('tools', 'shared.py'), 'r').read())
-
- For using the Emscripten compilers/linkers/etc. you can do:
- env = Environment()
- ...
- env.Append(CCFLAGS = COMPILER_OPTS)
- env.Replace(LINK = LLVM_LD)
- env.Replace(LD = LLVM_LD)
- TODO: Document all relevant setup changes
-
-After setting that up, run your build system normally. It should generate
-LLVM instead of the normal output, and end up with .ll files that you can
-give to Emscripten. Note that this tool doesn't run Emscripten itself. Note
-also that you may need to do some manual fiddling later, for example to
-link files that weren't linked, and them llvm-dis them.
-
-Note the appearance of em++.py instead of emcc.py
-for the C++ compiler. This is needed for cases where we get
-a C++ file with a C extension, in which case CMake can be told
-to run g++ on it despite the .c extension, see
-
- https://github.com/kripken/emscripten/issues/6
-
-(If a similar situation occurs with ./configure, you can do the same there too.)
-
-emcc can be influenced by a few environment variables:
-
- EMMAKEN_NO_SDK - Will tell emcc *not* to use the emscripten headers. Instead
- your system headers will be used.
-
- EMMAKEN_COMPILER - The compiler to be used, if you don't want the default clang.
-
-'''
-
-import sys
-import os
-import subprocess
-
-################### XXX
-print >> sys.stderr, '***This is a WORK IN PROGRESS***'
-################### XXX
-
-print >> sys.stderr, 'emcc.py: ', ' '.join(sys.argv)
-
-__rootpath__ = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
-def path_from_root(*pathelems):
- return os.path.join(__rootpath__, *pathelems)
-exec(open(path_from_root('tools', 'shared.py'), 'r').read())
-
-# If this is a configure-type thing, just do that
-CONFIGURE_CONFIG = os.environ.get('EMMAKEN_JUST_CONFIGURE')
-CMAKE_CONFIG = 'CMakeFiles/cmTryCompileExec.dir' in ' '.join(sys.argv)# or 'CMakeCCompilerId' in ' '.join(sys.argv)
-if CONFIGURE_CONFIG or CMAKE_CONFIG:
- compiler = 'g++' if 'CXXCompiler' in ' '.join(sys.argv) or os.environ.get('EMMAKEN_CXX') else 'gcc'
- cmd = [compiler] + EMSDK_OPTS + sys.argv[1:]
- print >> sys.stderr, 'emcc.py, just configuring: ', cmd
- exit(os.execvp(compiler, cmd))
-
-try:
- #f=open('/dev/shm/tmp/waka.txt', 'a')
- #f.write('Args: ' + ' '.join(sys.argv) + '\nCMake? ' + str(CMAKE_CONFIG) + '\n')
- #f.close()
-
- if os.environ.get('EMMAKEN_COMPILER'):
- CXX = os.environ['EMMAKEN_COMPILER']
- else:
- CXX = CLANG
-
- CC = to_cc(CXX)
-
- # If we got here from a redirection through emmakenxx.py, then force a C++ compiler here
- if os.environ.get('EMMAKEN_CXX'):
- CC = CXX
-
- CC_ADDITIONAL_ARGS = COMPILER_OPTS # + ['-g']?
- ALLOWED_LINK_ARGS = ['-f', '-help', '-o', '-print-after', '-print-after-all', '-print-before',
- '-print-before-all', '-time-passes', '-v', '-verify-dom-info', '-version' ]
- TWO_PART_DISALLOWED_LINK_ARGS = ['-L'] # Ignore thingsl like |-L .|
-
- EMMAKEN_CFLAGS = os.environ.get('EMMAKEN_CFLAGS')
- if EMMAKEN_CFLAGS: CC_ADDITIONAL_ARGS += EMMAKEN_CFLAGS.split(' ')
-
- # ---------------- End configs -------------
-
- if len(sys.argv) == 2 and 'conftest' not in ' '.join(sys.argv): # Avoid messing with configure, see below too
- # ranlib
- sys.exit(0)
- if len(sys.argv) == 1 or sys.argv[1] in ['x', 't']:
- # noop ar
- sys.exit(0)
-
- use_cxx = True
- use_linker = True
- header = False # pre-compiled headers. We fake that by just copying the file
-
- opts = []
- files = []
- for i in range(1, len(sys.argv)):
- arg = sys.argv[i]
- if arg.startswith('-'):
- opts.append(arg)
- else:
- files.append(arg)
- if arg.endswith('.c'):
- use_cxx = False
- if arg.endswith(('.c', '.cc', '.cpp', '.dT')):
- use_linker = False
- if arg.endswith('.h') and sys.argv[i-1] != '-include':
- header = True
- use_linker = False
-
- if '--version' in opts:
- use_linker = False
-
- if set(sys.argv[1]).issubset(set('-cruqs')): # ar
- sys.argv = sys.argv[:1] + sys.argv[3:] + ['-o='+sys.argv[2]]
- assert use_linker, 'Linker should be used in this case'
-
- if use_linker:
- call = LLVM_LD
- newargs = ['-disable-opt']
- found_o = False
- i = 0
- while i < len(sys.argv)-1:
- i += 1
- arg = sys.argv[i]
- if found_o:
- newargs.append('-o=%s' % arg)
- found_o = False
- continue
- if arg.startswith('-'):
- if arg == '-o':
- found_o = True
- continue
- prefix = arg.split('=')[0]
- if prefix in ALLOWED_LINK_ARGS:
- newargs.append(arg)
- if arg in TWO_PART_DISALLOWED_LINK_ARGS:
- i += 1
- elif arg.endswith('.so'):
- continue # .so's do not exist yet, in many cases
- else:
- # not option, so just append
- newargs.append(arg)
- elif not header:
- call = CXX if use_cxx else CC
- newargs = sys.argv[1:]
- for i in range(len(newargs)):
- if newargs[i].startswith('-O'):
- print >> sys.stderr, 'emcc.py: WARNING: Optimization flags (-Ox) are ignored in emcc. Tell emscripten.py to do that, or run LLVM opt.'
- newargs[i] = ''
- newargs = [ arg for arg in newargs if arg is not '' ] + CC_ADDITIONAL_ARGS
- newargs.append('-emit-llvm')
- if not use_linker:
- newargs.append('-c')
- else:
- print >> sys.stderr, 'Just copy.'
- shutil.copy(sys.argv[-1], sys.argv[-2])
- exit(0)
-
- #f=open('/dev/shm/tmp/waka.txt', 'a')
- #f.write('Calling: ' + ' '.join(newargs) + '\n\n')
- #f.close()
-
- print >> sys.stderr, "Running:", call, ' '.join(newargs)
-
- os.execvp(call, [call] + newargs)
-except Exception, e:
- print 'Error in emcc.py. (Is the config file ~/.emscripten set up properly?) Error:', e
- raise
-