#playdate #elf #bin #utility #addr2line #stdin #parser

nightly bin+lib playdate-symbolize

Tools for symbolise addresses from bin (pdex.elf) and Playdate's trace or crashlog

5 releases

0.2.0 Jun 25, 2024
0.1.3 Jun 10, 2024
0.1.2 Jun 10, 2024
0.1.1 Jun 5, 2024
0.1.0 Apr 24, 2024

#1309 in Development tools

Download history 12/week @ 2024-09-13 16/week @ 2024-09-20 5/week @ 2024-09-27

326 downloads per month

MIT/Apache

120KB
3K SLoC

Symbolizer for Playdate

Three tools:

  • pd-addr2line - takes address, returns symbol with span
  • pd-symbolize-crashlog - takes crashlog.txt, returns symbolized crashlog
  • pd-symbolize-trace - takes trace-dump and symbolizing it

All of them have almost same interface.

Usage

The pd-addr2line can operate with stdin or file.

pd-addr2line --exe pdex.elf -Cfri 0xc0a 0x8053C75 10 0x6000027a 0x080bf518
echo "0x8053c75\n0x80bf518" | pd-addr2line --exe pdex.elf -Cfri

The pd-symbolize-trace can operate with stdin or file. Parameter --exe is optional and usually not needed for traces, but 🤷🏻‍♂️.

export RUST_LOG="info" # prevent unnecessary logs from appearing in the output
pd-symbolize-trace -Cfri trace-dump.txt # parse file, without elf
pd-symbolize-trace --exe pdex.elf -Cfri trace-dump.txt # with elf
cat trace-dump.txt | pd-symbolize-trace --exe pdex.elf -Cfri # pipe

The pd-symbolize-crashlog can process crashlog file, currently stdin not supported.

pd-symbolize-crashlog --exe pdex.elf -Cfr /Volumes/PLAYDATE/crashlog.txt

All tools have --help parameter.

Dependencies

~29–40MB
~659K SLoC