silentsignal / android-param-annotate

Android parameter annotator for Dalvik/Smali disassembly

Android parameter annotator for Dalvik/Smali disassembly

Debugging applications without access to the source code always has its problems, especially with debuggers that were built with developers in mind, who obviously doesn't have this restriction.

The Dalvik implementation of JDWP refuses to give any information about parameters at all if the DEX file was built without local variable information, making debugging with JDB difficult.

This simple Python script reads each Smali file and populates this metadata that can be extracted from the mangled function name found in the Dalvik bytecode.

Read more in our blog post about this script

Usage

python3 annotate.py <root directory of smali files>

Dependencies

• Python 3.x (tested on 3.5.1)

License

The whole project is available under MIT license, see LICENSE.txt.

android-param-annotate's Issues

Support for wide parameters

Current state:

smali/net/sqlcipher/CursorWindow.smali[935,4] Register p2 is the second half of a wide parameter.
smali/net/sqlcipher/CursorWindow.smali[970,4] Register p2 is the second half of a wide parameter.
Exception in thread "main" brut.androlib.AndrolibException: Could not smali file: net/sqlcipher/CursorWindow.smali
        at brut.androlib.src.SmaliBuilder.buildFile(SmaliBuilder.java:75)
        at brut.androlib.src.SmaliBuilder.build(SmaliBuilder.java:59)
        at brut.androlib.src.SmaliBuilder.build(SmaliBuilder.java:36)
        at brut.androlib.Androlib.buildSourcesSmali(Androlib.java:404)
        at brut.androlib.Androlib.buildSources(Androlib.java:335)
        at brut.androlib.Androlib.build(Androlib.java:291)
        at brut.androlib.Androlib.build(Androlib.java:263)
        at brut.apktool.Main.cmdBuild(Main.java:227)
        at brut.apktool.Main.main(Main.java:84)

J and D are affected: https://github.com/JesusFreke/smali/wiki/Registers#longdouble-values

Annotation of local variable

Is this script only limited to annotating the parameters and not local variables in which we could not display the value of the local variables when debugging using jdb? Thanks.