From patchwork Thu Mar 14 13:07:28 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Aktemur, Tankut Baris" X-Patchwork-Id: 87184 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C5B403858C3A for ; Thu, 14 Mar 2024 13:08:32 +0000 (GMT) X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.11]) by sourceware.org (Postfix) with ESMTPS id B37B43857B89 for ; Thu, 14 Mar 2024 13:07:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org B37B43857B89 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=intel.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org B37B43857B89 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=198.175.65.11 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1710421682; cv=none; b=tl/YxYq7x5YKLtmeaXaZwndYv88KlHO8iYsgY27lEk4Btzoh0pZjuwC4d92b7S5JukapeBnAxTsTjB36g1C8JvOPbXf+lKUsvgYWvN7b2mWPeCM1Tmv3vdknoDZehsqj1wmVozIVHJhMXUo7SDIhYkhnlVjaFyBzjiF8qWIfp6w= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1710421682; c=relaxed/simple; bh=0w2er1eFSg8I+iMjyEGu1nKSPawULgjqw0x0G4hlLVk=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=gU5Xy5GRAhXzWTixTMNlg6S/++rBYIBTkBEUOyKHxnUfVNo77Xa2guovJwAgnIuhlxaF+WIFQX39ilGQxXzctwjDwlHMVNWNaXrAPJGZb9+FFG6ouTdxLIVZXlciCccTp+NnMMsxTw0JxP9wdnVGNd8Rcfazax9/cqLuIDBkgJE= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1710421680; x=1741957680; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=0w2er1eFSg8I+iMjyEGu1nKSPawULgjqw0x0G4hlLVk=; b=PfIVZgeUqzJnvlIE1ARgz6MpjV0HgIgumAJLQLSHfDpVIZU0lBPgw8Q3 rRGqUpFWoizymXqk2lHt8eXtPFUrOQbAyxxabD+QBQn2IDakA1CjdWhJf B5HK2dhRp7/9iPCDAGuo+4TAgEGuUY0cUlVvI4/bVSLL+Cgi6s9O+tatd Q1fT7H4oeb/5XH2Vm1L3pCF19/wFa5UQjiCfxWy7rqo0iZZb2yjTAKk0Y ufj9l28wZy2uzWcg9thGUbwVUab2pbNXuIA+bbJvBw1eO6RCF60Ku6Q1G GnWrXQ5ZCLqBQCg8gR2u1AcJSMvHIqPbgEQdJrMJWmitfiLa9cviKvPPG w==; X-IronPort-AV: E=McAfee;i="6600,9927,11012"; a="15791639" X-IronPort-AV: E=Sophos;i="6.07,125,1708416000"; d="scan'208";a="15791639" Received: from orviesa007.jf.intel.com ([10.64.159.147]) by orvoesa103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Mar 2024 06:07:59 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.07,125,1708416000"; d="scan'208";a="12734972" Received: from gkldtt-dev-004.igk.intel.com (HELO localhost) ([10.123.221.202]) by orviesa007-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Mar 2024 06:07:57 -0700 From: Tankut Baris Aktemur To: gdb-patches@sourceware.org Cc: tom@tromey.com Subject: [PATCH v2 1/4] doc: fine-tune the documentation of the 'm' RSP packet Date: Thu, 14 Mar 2024 14:07:28 +0100 Message-Id: <5d5b5ad695a50a196ff640e710d8d31766d2cf3d.1710420898.git.tankut.baris.aktemur@intel.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 X-Spam-Status: No, score=-11.0 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org Revise a sentence to avoid misinterpretation. Move @cindex entries before the text they index. Refer to trace frames regarding partial reads. --- gdb/doc/gdb.texinfo | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 6099d125a60..f2b80db94ef 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -42743,24 +42743,25 @@ probes the target state as if a new connection was opened @item m @var{addr},@var{length} @cindex @samp{m} packet Read @var{length} addressable memory units starting at address @var{addr} -(@pxref{addressable memory unit}). Note that @var{addr} may not be aligned to -any particular boundary. +(@pxref{addressable memory unit}). Note that @var{addr} does not have to +be aligned to any particular boundary. +@cindex alignment of remote memory accesses +@cindex size of remote memory accesses +@cindex memory, alignment and size of remote accesses The stub need not use any particular size or alignment when gathering data from memory for the response; even if @var{addr} is word-aligned and @var{length} is a multiple of the word size, the stub is free to use byte accesses, or not. For this reason, this packet may not be suitable for accessing memory-mapped I/O devices. -@cindex alignment of remote memory accesses -@cindex size of remote memory accesses -@cindex memory, alignment and size of remote accesses Reply: @table @samp @item @var{XX@dots{}} Memory contents; each byte is transmitted as a two-digit hexadecimal number. The reply may contain fewer addressable memory units than requested if the -server was able to read only part of the region of memory. +server was reading from a trace frame memory and was able to read only part +of the region of memory. @item E @var{NN} @var{NN} is errno @end table