From 1bd75d5a8f7bb5abba0698fc51ec7315c677bc03 Mon Sep 17 00:00:00 2001 From: Kefu Chai Date: Wed, 2 Dec 2020 13:10:33 +0800 Subject: [PATCH] docs/detailed_test_config: document "archive-on-error" option Signed-off-by: Kefu Chai --- docs/detailed_test_config.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/detailed_test_config.rst b/docs/detailed_test_config.rst index 50ae910a91..42b17f1f35 100644 --- a/docs/detailed_test_config.rst +++ b/docs/detailed_test_config.rst @@ -227,6 +227,21 @@ global option can be set to true to make the unlocking happen unconditionally. Troubleshooting =============== +Postmortem Debugging +-------------------- + +After completion of a test, the ``archive`` subdirectory is archived under +the corresponding ``remote`` subdirectory. We can disable this behavior +using the top-level configuration, like:: + + archive-on-error: true + +If ``archive-on-error`` is ``true``, the ``archive`` subdirectory is +archived only for failed tests. + + +Situ Debugging +-------------- Sometimes when a bug triggers, instead of automatic cleanup, you want to explore the system as is. Adding a top-level:: -- 2.39.5