Bug Reporting

All bugs should be filed in the GitHubmain Emscripten repositoryIssueTracker.

Please supply as much relevant information as possible, including:

  • Original source code.

  • Generated bitcode (.bc,.o or.ll)

  • Environment information — includingemcc andclang versions (as reported byemcc-v).

  • Error symptoms.

  • Proposed solutions, ideally with a pull request.

Tip

Compile withEMCC_DEBUG=1 and grab the/tmp/emscripten_temp/emcc-* files (these include the bitcode andJavaScript in several stages). Note that theemscripten_temp directoryshould be emptied manually first, so it only contains new content!

LLVM, wasm-ld, clang, Binaryen bugs

If uncertain, bugs can always be posted to themain repository. But if you are sure a bug isin an upstream project, you can file it there:

  • LLVM bug tracker . For most issues use the“libraries” product and the “Backend: WebAssembly” component. For wasm-ldissues, use “lld” and “wasm”.

  • Binaryen bug tracker

Pull requests must (of course) go to the proper repository.

Site and documentation bugs

Documentation (site) bugs should be filed in the sameIssue Tracker.

Include relevant information including:

  • The URL and title of the affected page(s).

  • A description of the problem.

  • Suggestions for a possible solution.

Tip

ThePage bug link on the bottom-right of every page opens the Issue Tracker pre-seeded with the current page URL and title.