Integrate pytest-faulthandler into the core

* Add pytest-faulthandler files unchanged
* Adapt imports and tests
* Add code to skip registration of the external `pytest_faulthandler`
  to avoid conflicts

Fix #5440

1 files changed, 18 insertions, 1 deletions

diff --git a/doc/en/usage.rst b/doc/en/usage.rst
index acf736f21..c1332706f 100644
--- a/doc/en/usage.rst
+++ b/doc/en/usage.rst
@@ -408,7 +408,6 @@ Pytest supports the use of ``breakpoint()`` with the following behaviours:
 Profiling test execution duration
 -------------------------------------
 
-.. versionadded: 2.2
 
 To get a list of the slowest 10 test durations:
 
@@ -418,6 +417,24 @@ To get a list of the slowest 10 test durations:
 
 By default, pytest will not show test durations that are too small (<0.01s) unless ``-vv`` is passed on the command-line.
 
+
+.. _faulthandler:
+
+Fault Handler
+-------------
+
+.. versionadded:: 5.0
+
+The `faulthandler <https://docs.python.org/3/library/faulthandler.html>`__ standard module
+can be used to dump Python tracebacks on a segfault or after a timeout.
+
+The module is automatically enabled for pytest runs, unless the ``--no-faulthandler`` is given
+on the command-line.
+
+Also the ``--faulthandler-timeout=X`` can be used to dump the traceback of all threads if a test
+takes longer than ``X`` seconds to finish (not available on Windows).
+
+
 Creating JUnitXML format files
 ----------------------------------------------------