diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/guide/types/debuginfo.md | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/guide/types/debuginfo.md b/docs/guide/types/debuginfo.md index 1a23d240..6f6ed085 100644 --- a/docs/guide/types/debuginfo.md +++ b/docs/guide/types/debuginfo.md @@ -14,7 +14,7 @@ DWARF supports information compiled in to ELF binaries, information from externa ## Applying Debug Info -Debug Info is automatically applied by default if applicable. +Debug Info is automatically applied by default if applicable. { width="300" } @@ -44,6 +44,10 @@ Our [DWARF Export plugin](https://github.com/Vector35/binaryninja-api/tree/dev/r #### Special Note for `.dSYM` Files -`.dSYM` packages are often provided as application bundles. Binary Ninja currently does not support extracting the actual `.dSYM` file out of the package for parsing, so you may need to provide a full path for Binary Ninja to correctly parse. +Binary Ninja will automatically load `.dSYM` files given the following: +- The `.dSYM` file is adjacent on the filesystem to the binary being analyzed +- The `.dSYM` file is named `X.dSYM`, where `X` is the name of the binary being analyzed +- `analysis.debugInfo.loadSiblingDebugFiles` is enabled +When a `.dSYM` file is not automatically loaded, you will need to manually import the debug info contained in the `.dSYM`. For example, you could have the file `hello.macho` that you would like to import debug info for. Thankfully, you also have `hello.dSYM`. So you open `hello.macho` with options, find the "External Debug Info File" and provide the `hello.dSYM` file. When the file opens, you notice that no information was imported and the log reads "No available/valid parsers for file." This is because `hello.dSYM` is a bundle. The actual path you needed to provide for the "External Debug Info File" setting would look something like `hello.dSYM/Contents/Resources/DWARF/hello`. |