Skip to content

Commit

Permalink
Add usage and building
Browse files Browse the repository at this point in the history
  • Loading branch information
CalebFenton committed Feb 7, 2020
1 parent 366279b commit 6271435
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions sdbg/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,40 @@ Right now, it's only an experiment, so if you have feature suggestions, feel fre

Since sdbg is powered by SmaliVM, it has all of its strengths and weaknesses. It can handle unknown values and parameters by taking every execution path, which is cool. But it's also possible to get stuck in infinite loops and debugging multiple execution paths is tricky.

## Building

From the root of this repository:

```bash
./gradlew :sdbg:fatjar
```

The full jar will be in `sdbg/build/libs/`.

## Usage

```plaintext
Usage: <main class> [-hVv] input-path method-signature
Smali DeBuGger (SDBG)
input-path Input directory containing Smali
method-signature Method signature to execute
-h, --help Show this help message and exit.
-v, --verbose Specify multiple -v options to increase verbosity.
For example, `-v -v -v` or `-vvv`
-V, --version Print version information and exit.
```

```plaintext
Commands:
help Displays help information about the specified command
cls, clear Clears the screen
list, l List source code
where, w Shows current instruction index and which function you are in
step, s Step to next line of code including stepping into methods
next, n Execute next line of code without entering methods
info, i List information about target
print, p Print value stored in variable or field
break, b Suspend program at specified function, instruction index, or
index offset
continue, c Continue executing until next break point
```

0 comments on commit 6271435

Please sign in to comment.