aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorterminaldweller <devi@terminaldweller.com>2025-04-14 21:45:09 +0000
committerterminaldweller <devi@terminaldweller.com>2025-04-14 21:45:09 +0000
commit3d04a2fe80a49c0e918faa76c032bc8c5657c3ce (patch)
treea723fe3b3aa96ebc40c86315b180b247e59f957a /README.md
parentupdate (diff)
downloaddocker-bitlbee-libpurple-3d04a2fe80a49c0e918faa76c032bc8c5657c3ce.tar.gz
docker-bitlbee-libpurple-3d04a2fe80a49c0e918faa76c032bc8c5657c3ce.zip
added some notes to the readmeHEADmain
Diffstat (limited to 'README.md')
-rw-r--r--README.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/README.md b/README.md
index 8fc4c35..64210a8 100644
--- a/README.md
+++ b/README.md
@@ -83,3 +83,39 @@ You can use [grype](https://github.com/anchore/grype) to check for CVEs affectin
```sh
grype bitlbee-purple --scope all-layers
```
+
+## Debugging
+
+For debugging, you can use the docker compose file provided in the repo. Enable the plugin you want, and run.
+
+This command will run until we crash, after which it will print the backtrace and exit:
+
+```yaml
+command:
+ [
+ "gdb",
+ "-ex",
+ "'handle SIGPIPE nostop noprint pass'",
+ "-ex",
+ "run",
+ "-ex",
+ "bt",
+ "--args",
+ "/usr/sbin/bitlbee",
+ "-Dnv",
+ "-d",
+ "/var/lib/bitlbee",
+ ]
+```
+
+This command prints debug information for bitlbee:
+
+```yaml
+command:
+ [
+ "/usr/sbin/bitlbee",
+ "-Dnv",
+ "-d",
+ "/var/lib/bitlbee",
+ ]
+```