christoph/wamr
1
Fork 0
Code Releases Activity

addr2line.py: Support sourceMappingURL section produced by emcc (#3302)

Browse Source 
And update the debug-tools sample.
This commit is contained in:
liang.he
2024-04-12 11:43:40 +08:00
committed by GitHub
parent 1a043b6eb5
commit fef26ead3e
10 changed files with 324 additions and 110 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
samples/debug-tools/README.md
View File

@ -80,6 +80,39 @@ $ python3 ../../../test-tools/addr2line/addr2line.py \
call_stack.txt --no-addr
```
#### sourcemap
This script also supports _sourcemap_ which is produced by [_emscripten_](https://emscripten.org/docs/tools_reference/emcc.html). The _sourcemap_ is used to map the wasm function to the original source file. To use it, add `-gsource-map` option to _emcc_ command line. The output should be a section named "sourceMappingURL" and a separated file named "_.map_.
If the wasm file is with _sourcemap_, the script will use it to get the source file and line info. It needs an extra command line option `--emsdk` to specify the path of _emsdk_. The script will use _emsymbolizer_ to query the source file and line info.
````bash
$ python3 ../../../test-tools/addr2line/addr2line.py \
--wasi-sdk /opt/wasi-sdk \
--wabt /opt/wabt \
--wasm-file emscripten/wasm-apps/trap.wasm \
--emsdk /opt/emsdk \
call_stack.from_wasm_w_sourcemap.txt
The output should be something like:
```text
1: c
at ../../../../../wasm-apps/trap.c:5:1
2: b
at ../../../../../wasm-apps/trap.c:11:12
3: a
at ../../../../../wasm-apps/trap.c:17:12
4: main
at ../../../../../wasm-apps/trap.c:24:5
5: __main_void
at ../../../../../../../../../emsdk/emscripten/system/lib/standalone/__main_void.c:53:10
6: _start
at ../../../../../../../../../emsdk/emscripten/system/lib/libc/crt1.c:27:3
````
> The script assume the separated map file _.map_ is in the same directory as the wasm file.
### Another approach
If the wasm file is with "name" section, it is able to output function name in the stack trace. To achieve that, need to enable `WAMR_BUILD_LOAD_CUSTOM_SECTION` and `WAMR_BUILD_CUSTOM_NAME_SECTION`. If using .aot file, need to add `--emit-custom-sections=name` into wamrc command line options.
@ -97,4 +130,4 @@ Then the output should be something like
Exception: unreachable
```
Also, it is able to use *addr2line.py* to add file and line info to the stack trace.
Also, it is able to use _addr2line.py_ to add file and line info to the stack trace.