Bug Reporting

All bugs should be filed in the GitHub main Emscripten repository Issue Tracker.

Please supply as much relevant information as possible, including:

  • Original source code.

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

  • Environment information — including emcc and clang versions (as reported by emcc -v).

  • Error symptoms.

  • Proposed solutions, ideally with a pull request.

Tip

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

LLVM, wasm-ld, clang, Binaryen bugs

If uncertain, bugs can always be posted to the main repository. But if you are sure a bug is in 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-ld issues, 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 same Issue 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

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