osmith has submitted this change. ( 
https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/43420?usp=email )

Change subject: testenv/README: automatic backtraces for coredumps
......................................................................

testenv/README: automatic backtraces for coredumps

Add documentation for this feature.

Change-Id: I9b65bfb14853edb03ddb571867bb795bde9d495c
---
M _testenv/README.md
1 file changed, 13 insertions(+), 0 deletions(-)

Approvals:
  pespin: Looks good to me, but someone else must approve
  fixeria: Looks good to me, approved
  Jenkins Builder: Verified




diff --git a/_testenv/README.md b/_testenv/README.md
index 710c021..047abc0 100644
--- a/_testenv/README.md
+++ b/_testenv/README.md
@@ -309,6 +309,19 @@
 Switching between the versions is done either by setting a `titan_min` version
 in `testsrcdir.cfg`, or by using `-T` / `--titan-version`.

+## Automatic backtraces for coredumps
+
+When your SUT crashes with a coredump, testenv automatically runs `gdb` to get
+a backtrace, displays it in the output and writes it next to other logs into a
+`.backtrace` file.
+
+For this to work, you either need to have `systemd-coredump` set up, or
+alternatively have a core pattern in `/proc/sys/kernel/core_pattern` starting
+with `core`.
+
+Executables that do not start with a relevant prefix (`osmo-` or `open5gs-`)
+get ignored, see `testenv.coredump.executable_is_relevant()`.
+
 ## Troubleshooting

 ### Timeout waiting for RESET-ACK after sending RESET

--
To view, visit https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/43420?usp=email
To unsubscribe, or for help writing mail filters, visit 
https://gerrit.osmocom.org/settings?usp=email

Gerrit-MessageType: merged
Gerrit-Project: osmo-ttcn3-hacks
Gerrit-Branch: master
Gerrit-Change-Id: I9b65bfb14853edb03ddb571867bb795bde9d495c
Gerrit-Change-Number: 43420
Gerrit-PatchSet: 2
Gerrit-Owner: osmith <[email protected]>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: fixeria <[email protected]>
Gerrit-Reviewer: osmith <[email protected]>
Gerrit-Reviewer: pespin <[email protected]>

Reply via email to