| # fx debug |
| |
| run the debug agent on target and connect to it with zxdb |
| |
| ```none |
| Starts the debug agent on the proposed target and automatically connect zxdb |
| to it. Will close the debug agent on exit. |
| |
| TROUBLESHOOTING TIPS: |
| |
| - Remember to use "fx set-device" when working with multiple devices. |
| - This scripts by default will mute the SSH connection stdout/stderr, so any |
| errors triggered by it won't appear. Use the --verbose-agent flag to see |
| the output. |
| - This scripts uses the tool "nc" for testing TCP connections. Check that it |
| is in $PATH and that it works. |
| |
| Usage: fx debug [(--core|-c) <CORE>] [--no-agent] [(--port|-p) <PORT>] |
| [--unwind=(aosp|ng|fuchsia)] [(--verbose-agent|-va)] [--gdb] |
| |
| --core Load a minidump file into zxdb. |
| --no-agent Don't start a Debug Agent. |
| --port Port the debug agent will be listening on. |
| Will use 2345 by default. |
| --target-core Look on the target for a minidump file taken by |
| crashpad, download it and load it into zxdb. |
| --unwind Choose the unwinder to use. Options are |
| - "aosp" (Android's unwinder) |
| - "ng" for "ngunwind" (Fuchsia's fork of libunwind) |
| - "fuchsia" (an experimental homemade unwinder) |
| Defaults to "aosp". |
| --verbose-agent Whether the debug agent's stdout/stderr should be shown. |
| Useful for debugging the debugger. Yo' dawg. |
| --gdb Launch zxdb using gdb. This is only useful to be able to debug zxdb. This |
| option only works if you have the unstripped version of zxdb. |
| |
| Flags after -- are parsed by zxdb. See zxdb's documentation for more |
| details. |
| ``` |
| |
| [debug source code](https://cs.opensource.google/fuchsia/fuchsia/+/main:tools/devshell/contrib/debug) |
