From 7d01629580949a18960f79603fca1d0edb337aa1 Mon Sep 17 00:00:00 2001 From: Gerion Entrup Date: Wed, 2 Oct 2019 14:51:02 +0200 Subject: mtest: add gdb_path option When using the '--gdb' argument of meson test the executed binary can now be specified with '--gdb-path'. Closing: #4373 --- docs/markdown/Unit-tests.md | 6 ++++++ docs/markdown/snippets/add_gdb_path.md | 9 +++++++++ 2 files changed, 15 insertions(+) create mode 100644 docs/markdown/snippets/add_gdb_path.md (limited to 'docs/markdown') diff --git a/docs/markdown/Unit-tests.md b/docs/markdown/Unit-tests.md index 9c2e3d5..c89d7b0 100644 --- a/docs/markdown/Unit-tests.md +++ b/docs/markdown/Unit-tests.md @@ -157,6 +157,12 @@ $ meson test --gdb --repeat=10000 testname This runs the test up to 10 000 times under GDB automatically. If the program crashes, GDB will halt and the user can debug the application. Note that testing timeouts are disabled in this case so `meson test` will not kill `gdb` while the developer is still debugging it. The downside is that if the test binary freezes, the test runner will wait forever. +Sometimes, the GDB binary is not in the PATH variable or the user wants to use a GDB replacement. Therefore, the invoked GDB program can be specified *(added 0.52.0)*: + +```console +$ meson test --gdb --gdb-path /path/to/gdb testname +``` + ```console $ meson test --print-errorlogs ``` diff --git a/docs/markdown/snippets/add_gdb_path.md b/docs/markdown/snippets/add_gdb_path.md new file mode 100644 index 0000000..873c3fc --- /dev/null +++ b/docs/markdown/snippets/add_gdb_path.md @@ -0,0 +1,9 @@ +## The meson test program now accepts an additional "--gdb-path" argument to specify the GDB binary + +`meson test --gdb testname` invokes GDB with the specific test case. However, sometimes GDB is not in the path or a GDB replacement is wanted. +Therefore, a `--gdb-path` argument was added to specify which binary is executed (per default `gdb`): + +```console +$ meson test --gdb --gdb-path /my/special/location/for/gdb testname +$ meson test --gdb --gdb-path cgdb testname +``` -- cgit v1.1