From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 0GX1GtYzzl/wRAAAWB0awg (envelope-from ) for ; Mon, 07 Dec 2020 08:53:26 -0500 Received: by simark.ca (Postfix, from userid 112) id 6C8C81F096; Mon, 7 Dec 2020 08:53:26 -0500 (EST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-1.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (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 simark.ca (Postfix) with ESMTPS id 9F5A41E552 for ; Mon, 7 Dec 2020 08:53:25 -0500 (EST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 5BA1F393D03E; Mon, 7 Dec 2020 13:53:25 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5BA1F393D03E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1607349205; bh=uCiFuT7Mb7s6XqZl4IA9ikqn1uU6IrNYlDDtNxUZtQI=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=m3g77m3RvXAONtnbsH4nto+ykdWpJLInCd8Bui0PNpCQA+9JQi2V3Cpy0u0IWCKDV KZ4Js0QsmjwHXkvkv4fJjc4ue4Qfho+bFMuLqF40qc6rF99+d97FmIH5HHmKZ8ozvE q/5JtBr1y6hQZIjHSkvM0Hpc19uz2m70PQ2z8aVk= Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by sourceware.org (Postfix) with ESMTPS id 78D153896C1E for ; Mon, 7 Dec 2020 13:53:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 78D153896C1E Received: by mail-wr1-x443.google.com with SMTP id z7so12859166wrn.3 for ; Mon, 07 Dec 2020 05:53:23 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=uCiFuT7Mb7s6XqZl4IA9ikqn1uU6IrNYlDDtNxUZtQI=; b=nDrrddkO6VFxIBy3mQYBg7yxe3tUqvk1NeAS67hfrKOjqpnhnmqTyeBzt2cREBVqxy dNNYTgF4vM7RCgA7sNBlro5Mxf7/RGiNhLTXOeBEWbB651gS2wJ6QVwGufFTURNkXwZL NIowI3EdUwsbMAoPcLsxgxaXib4LEWkKeCUBcLML2hOEOpk5FuzD+Ba+Si9t8GgOYkns pYIVC80xdu2xaBJY7pKOZH3IvWbKfu7uDTAqPuGqe8YpEfyFYSC6MippEphBMzu6iI4q 0YQeALCrt5JZyIZQQQ3SLumgn0OalZStIn7h9FTejCQI753dOL1AXDBSt2qrUaMIpLJq g+3A== X-Gm-Message-State: AOAM5317bHmEzbmzJZks4GjT4vphRs4JpV3SLo4JVSTEeYaw4sR3x+hE sL06z3l7ohQd/+8100Wef7ZUukn7r/pIdA== X-Google-Smtp-Source: ABdhPJzt+CstPtXd6NAr/gIGsrjBpJq0Tet07Lqsx46wnObFZD85oN8azVXyGjfda0vF03bRc3NOrg== X-Received: by 2002:a5d:4ece:: with SMTP id s14mr7416217wrv.427.1607349202519; Mon, 07 Dec 2020 05:53:22 -0800 (PST) Received: from zen.linaroharston ([51.148.130.216]) by smtp.gmail.com with ESMTPSA id o15sm14981778wrp.74.2020.12.07.05.53.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 07 Dec 2020 05:53:21 -0800 (PST) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id 68EA11FF7E; Mon, 7 Dec 2020 13:53:20 +0000 (GMT) To: gdb-patches@sourceware.org Subject: [RFC PATCH] gdb/doc: clarify the language for the '?' packet Date: Mon, 7 Dec 2020 13:53:19 +0000 Message-Id: <20201207135319.31884-1-alex.bennee@linaro.org> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: =?utf-8?q?Alex_Benn=C3=A9e_via_Gdb-patches?= Reply-To: =?UTF-8?q?Alex=20Benn=C3=A9e?= Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= Errors-To: gdb-patches-bounces@sourceware.org Sender: "Gdb-patches" Both QEMU and kgdb make the assumption that the '?' packet is only sent during the initial setup of a gdbstub connection. Both use that knowledge to reset breakpoints and ensure the gdbstub is in a clean-state on a resumed connection. This can cause confusion for others implementing clients that speak to gdbstub devices. To avoid that make the language clearer that this is a start-up query packet that you only expect to see once. Signed-off-by: Alex Bennée --- gdb/doc/gdb.texinfo | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 8bff27c940d..f5b6fdd8691 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -39273,9 +39273,9 @@ The remote target both supports and has enabled extended mode. @item ? @cindex @samp{?} packet -@anchor{? packet} -Indicate the reason the target halted. The reply is the same as for -step and continue. This packet has a special interpretation when the +@anchor{? packet} Is a query sent when connection is first established +to query the reason the target halted. The reply is the same as for +step and continue. This packet has a special interpretation when the target is in non-stop mode; see @ref{Remote Non-Stop}. Reply: -- 2.20.1