From nobody Sun Dec 29 01:32:22 2024 Delivered-To: importer2@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer2=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=crans.org ARC-Seal: i=1; a=rsa-sha256; t=1718892003; cv=none; d=zohomail.com; s=zohoarc; b=Ao+UfS69kJZyhqrFSYc48Ftpmvd/EtepP4a2d5ml1BDnq9XWaoiLjPPrVOqoHGPfYvsD6dwCXwODwf0pwQrX7+NV6Z7kOrSQCIqUQ/khaqgPQ3C0Ua0Ff1M7DBtsyrRcTOslf09lTb+lHGYSizfSXPaFzpBt5P0qYFSVpJX6q6U= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1718892003; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:Message-Id:Reply-To:To; bh=NDHPK0eWboiB34Ruz3/qFRa3v6rEVlrkhOFJyAbDa3w=; b=DLGNkyu676OmaBf7ePxkvWSj9WeITK74HSwRWdP5BrQsuZhNAeouKhKPQItfp8+PR+nj7FBAqKcJyT714iMwS9wGZYT+a2EwRnmhfIIjJ14KaQQYdkr4ha9jBurYv+OWSeqajOELzUKgMk7zoZf6H2SncPpe0GldZpD1Xza9Uos= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer2=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1718892003150937.1444265848387; Thu, 20 Jun 2024 07:00:03 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sKIKL-00075U-DT; Thu, 20 Jun 2024 09:59:49 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sKIKJ-00075M-FU for qemu-devel@nongnu.org; Thu, 20 Jun 2024 09:59:47 -0400 Received: from redisdead.crans.org ([2a0c:700:2::ff:fe01:2402]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sKIKH-0000aR-Gm for qemu-devel@nongnu.org; Thu, 20 Jun 2024 09:59:47 -0400 Received: from zamok.crans.org (users.adm.crans.org [172.16.10.31]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by redisdead.crans.org (Postfix) with ESMTPS id 03716215; Thu, 20 Jun 2024 15:59:31 +0200 (CEST) Received: by zamok.crans.org (Postfix, from userid 11692) id E4E91E0123; Thu, 20 Jun 2024 15:59:30 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=crans.org; s=mail; t=1718891971; bh=utWa3G2ROFcZq2Bxifn6vY1dON8iJ2NFho33pEVqScE=; h=From:To:Cc:Subject:Date:From; b=K8LslR+ovaJIyxkxf9pPaOzNhP+Jcz4FKn+px6tK9JA9cJ1ObKiEi1tgn+elaQdBW jd7phTXUoj7tGZl27xRz/QMQ1owRMWk3IcptyXKHuVwMP6PsFQ4TySluvX0/mNCZ8U nknIsJ9SvmQIc0syeOWr48N+5ESJtD+1AcohRP6Ax5hRu4I8n86EA/QfGj3kv97+mi NqbXPyrVtYQW7iE+8jxW2RhTw+X6A8aoF8xuWioTFVDER1rVvisadMQAgoPYlM8ObA H+kt8X6YQXddj2mQgFk8xY5wQtOjjK9PkRlIa3vHPHGfeQyNkG4j7jjpyxqmDz0JOn yAY8c+HFGwvW2UwsnU6Z6mCew1wbSVbqwwKJXfQGhEM/qDETI5NI6W20q4TTwgOJ7y 6wZtmLHY0C7yqbfrNQjdfKX7jHf1BhdOHEfZWxMigWmtEcvFCjikXzkunnl07nt6tl K89v4smHRU4DrB4HrN+lFqL7tbpJfAIMNK63pzIYp5Tz+Azh0Iv73hpBR87hS4yo5H ckaJWG9+otfYDAmcYwPQPDGkagJ5kquPGXm4Dg4s4rb5OYQANL/pfVZ9Ev6irAlBKl oiDQ874jy8SrzQwlCuYt67iJRZqaigRrvQ4ZpKsK8pk/jp649B48F1JZuK91TCQoZs lq8mD0aTFQVnGg/L98eSf6jY= From: Alexandre Iooss To: Cc: Alexandre Iooss , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Mahmoud Mandour , Pierrick Bouvier , Richard Henderson , Paolo Bonzini , qemu-devel@nongnu.org (open list:All patches CC here) Subject: [PATCH] docs: add precision about capstone for execlog plugin Date: Thu, 20 Jun 2024 15:57:32 +0200 Message-Id: <20240620135731.977377-1-erdnaxe@crans.org> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer2=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a0c:700:2::ff:fe01:2402; envelope-from=erdnaxe@crans.org; helo=redisdead.crans.org X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer2=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer2=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @crans.org) X-ZM-MESSAGEID: 1718892005672100001 Content-Type: text/plain; charset="utf-8" Some people are wondering why they get an empty string as disassembly. Most of the time, they configured QEMU without Capstone support. Let's document this behaviour to help users. Signed-off-by: Alexandre Iooss Reviewed-by: Pierrick Bouvier --- docs/devel/tcg-plugins.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst index 9cc09d8c3d..f7d7b9e3a4 100644 --- a/docs/devel/tcg-plugins.rst +++ b/docs/devel/tcg-plugins.rst @@ -539,7 +539,9 @@ which will output an execution trace following this str= ucture:: 0, 0xd34, 0xf9c8f000, "bl #0x10c8" 0, 0x10c8, 0xfff96c43, "ldr r3, [r0, #0x44]", load, 0x200000e4, RAM =20 -the output can be filtered to only track certain instructions or +Please note that you need to configure QEMU with Capstone support to get d= isassembly. + +The output can be filtered to only track certain instructions or addresses using the ``ifilter`` or ``afilter`` options. You can stack the arguments if required:: =20 --=20 2.30.2