Message ID | 20240320-new_website-v1-6-79b603c8aea1@suse.com |
---|---|
State | Superseded |
Headers | show
Return-Path: <ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it> X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=q+jH0BWu; dkim=fail reason="signature verification failed" header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=Iui2xXO0; dkim=fail reason="signature verification failed" (1024-bit key) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=q+jH0BWu; dkim=neutral header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=Iui2xXO0; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.linux.it (client-ip=213.254.12.146; helo=picard.linux.it; envelope-from=ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it; receiver=patchwork.ozlabs.org) Received: from picard.linux.it (picard.linux.it [213.254.12.146]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1)) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4V0DNm0Qn6z23sN for <incoming@patchwork.ozlabs.org>; Thu, 21 Mar 2024 03:21:12 +1100 (AEDT) Received: from picard.linux.it (localhost [IPv6:::1]) by picard.linux.it (Postfix) with ESMTP id 522673D003D for <incoming@patchwork.ozlabs.org>; Wed, 20 Mar 2024 17:21:08 +0100 (CET) X-Original-To: ltp@lists.linux.it Delivered-To: ltp@picard.linux.it Received: from in-3.smtp.seeweb.it (in-3.smtp.seeweb.it [IPv6:2001:4b78:1:20::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1)) (No client certificate requested) by picard.linux.it (Postfix) with ESMTPS id F377A3CFBF2 for <ltp@lists.linux.it>; Wed, 20 Mar 2024 17:20:47 +0100 (CET) Authentication-Results: in-3.smtp.seeweb.it; spf=pass (sender SPF authorized) smtp.mailfrom=suse.de (client-ip=195.135.223.131; helo=smtp-out2.suse.de; envelope-from=andrea.cervesato@suse.de; receiver=lists.linux.it) Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.223.131]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by in-3.smtp.seeweb.it (Postfix) with ESMTPS id 314871A0123D for <ltp@lists.linux.it>; Wed, 20 Mar 2024 17:20:47 +0100 (CET) Received: from imap1.dmz-prg2.suse.org (imap1.dmz-prg2.suse.org [10.150.64.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id B8A295BF33; Wed, 20 Mar 2024 16:20:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1710951646; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=2Ra30lBIEkWU0GsWihGIGFtJIodvPtrSfyWdrpJ7jjE=; b=q+jH0BWuqCxKo+zUf2l3OR1j5GaTO0vFpZADKMYdZNuCfGy+rFncwyf6T1zk17/hmoA30B GO7SdsJpoSuUElsv1oF6AyznvTFH0W4wXFoJZA9TfX6Qkbhryy91RP3Zr3wXH+MkJ9oAFh 2zUZOdxK8fy5OCUs6owAWwY6enU5z9E= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1710951646; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=2Ra30lBIEkWU0GsWihGIGFtJIodvPtrSfyWdrpJ7jjE=; b=Iui2xXO0Jom2faC55SgThYCnrxSz9r62csyFxGZXQdzh8ZlPNoB0NzA1aeLBErB+7K+lRt j//XB4pTkQeyFXCA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1710951646; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=2Ra30lBIEkWU0GsWihGIGFtJIodvPtrSfyWdrpJ7jjE=; b=q+jH0BWuqCxKo+zUf2l3OR1j5GaTO0vFpZADKMYdZNuCfGy+rFncwyf6T1zk17/hmoA30B GO7SdsJpoSuUElsv1oF6AyznvTFH0W4wXFoJZA9TfX6Qkbhryy91RP3Zr3wXH+MkJ9oAFh 2zUZOdxK8fy5OCUs6owAWwY6enU5z9E= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1710951646; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=2Ra30lBIEkWU0GsWihGIGFtJIodvPtrSfyWdrpJ7jjE=; b=Iui2xXO0Jom2faC55SgThYCnrxSz9r62csyFxGZXQdzh8ZlPNoB0NzA1aeLBErB+7K+lRt j//XB4pTkQeyFXCA== Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id 9FAAB13976; Wed, 20 Mar 2024 16:20:46 +0000 (UTC) Received: from dovecot-director2.suse.de ([10.150.64.162]) by imap1.dmz-prg2.suse.org with ESMTPSA id 6Fu0Jd4M+2U/ZgAAD6G6ig (envelope-from <andrea.cervesato@suse.de>); Wed, 20 Mar 2024 16:20:46 +0000 From: Andrea Cervesato <andrea.cervesato@suse.de> Date: Wed, 20 Mar 2024 17:20:50 +0100 MIME-Version: 1.0 Message-Id: <20240320-new_website-v1-6-79b603c8aea1@suse.com> References: <20240320-new_website-v1-0-79b603c8aea1@suse.com> In-Reply-To: <20240320-new_website-v1-0-79b603c8aea1@suse.com> To: ltp@lists.linux.it X-Mailer: b4 0.13.0 X-Spam-Score: -1.30 X-Spamd-Result: default: False [-1.30 / 50.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; MIME_GOOD(-0.10)[text/plain]; RCVD_COUNT_THREE(0.00)[3]; DKIM_SIGNED(0.00)[suse.de:s=susede2_rsa,suse.de:s=susede2_ed25519]; NEURAL_HAM_SHORT(-0.20)[-1.000]; RCPT_COUNT_TWO(0.00)[2]; DBL_BLOCKED_OPENRESOLVER(0.00)[gnu.org:url,suse.com:email]; FUZZY_BLOCKED(0.00)[rspamd.com]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_ALL(0.00)[]; BAYES_HAM(-0.00)[41.05%] X-Spam-Level: Authentication-Results: smtp-out2.suse.de; none X-Spam-Status: No, score=0.1 required=7.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE shortcircuit=no autolearn=disabled version=4.0.0 X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on in-3.smtp.seeweb.it X-Virus-Scanned: clamav-milter 1.0.3 at in-3.smtp.seeweb.it X-Virus-Status: Clean Subject: [LTP] [PATCH 06/10] Refactor debugging documentation X-BeenThere: ltp@lists.linux.it X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux Test Project <ltp.lists.linux.it> List-Unsubscribe: <https://lists.linux.it/options/ltp>, <mailto:ltp-request@lists.linux.it?subject=unsubscribe> List-Archive: <http://lists.linux.it/pipermail/ltp/> List-Post: <mailto:ltp@lists.linux.it> List-Help: <mailto:ltp-request@lists.linux.it?subject=help> List-Subscribe: <https://lists.linux.it/listinfo/ltp>, <mailto:ltp-request@lists.linux.it?subject=subscribe> Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it Sender: "ltp" <ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it> |
Series |
New LTP documentation
|
expand
|
diff --git a/doc_new/developers/debugging.rst b/doc_new/developers/debugging.rst index 18a4a67e9..7a4e6b2ad 100644 --- a/doc_new/developers/debugging.rst +++ b/doc_new/developers/debugging.rst @@ -3,8 +3,19 @@ Debugging ========= -The new test library runs the actual test, i.e. the `test()` function in a +This section explains some tricks which can be used to debug test binaries. + +Debug messages +-------------- + +The LTP framework currently supports ``TDEBUG`` flag test debug messages. These +messages can be enabled using the ``-D`` test's argument. + +Tracing and debugging syscalls +------------------------------ + +The new test library runs the actual test (i.e. the ``test()`` function) in a forked process. To get stack trace of a crashing test in gdb it's needed to `set follow-fork-mode child <https://ftp.gnu.org/old-gnu/Manuals/gdb/html_node/gdb_25.html>`_. -To trace the test, please use `strace -f` to enable tracing also for the +To trace the test, please use ``strace -f`` to enable tracing also for the forked processes.
From: Andrea Cervesato <andrea.cervesato@suse.com> The debugging documentation section explains how to debug test binaries and to enable TDEBUG messages on tests run. --- doc_new/developers/debugging.rst | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-)