summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
author Colin Cross <ccross@android.com> 2019-06-19 13:33:24 -0700
committer Colin Cross <ccross@android.com> 2019-07-03 16:33:31 -0700
commitaa812d122cb1a6419df00aa876bd0a98b7b85340 (patch)
tree81bce5efc29a354c2e9dca328d3e1881b7dac550 /README.md
parent7b97ecd1f5a7501112659fa354ff1ce213e42aef (diff)
Allow debugging with SOONG_DELVE=<listen addr>
Allow running Soong in a headless delve debugger by passing SOONG_DELVE=<listen addr> in the environment. Bug: 80165685 Test: SOONG_DELVE=:1234 m nothing Change-Id: Icfc893c8a8354a9bbc99112d9c83259cb41906d1
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index ebbe8bc50..531ef4c6a 100644
--- a/README.md
+++ b/README.md
@@ -337,6 +337,19 @@ build/soong/scripts/setup_go_workspace_for_soong.sh
This will bind mount the Soong source directories into the directory in the layout expected by
the IDE.
+### Running Soong in a debugger
+
+To run the soong_build process in a debugger, install `dlv` and then start the build with
+`SOONG_DELVE=<listen addr>` in the environment.
+For examle:
+```bash
+SOONG_DELVE=:1234 m nothing
+```
+and then in another terminal:
+```
+dlv connect :1234
+```
+
## Contact
Email android-building@googlegroups.com (external) for any questions, or see