From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.11]) by sourceware.org (Postfix) with ESMTPS id BC3813861019 for ; Tue, 9 Apr 2024 07:49:52 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org BC3813861019 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 BC3813861019 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=1712648994; cv=none; b=S0InL26qmNMzcOy+YFydpiFvOYLvz1lWGwgENIroFM26uj+evj+5nV1MMVj3RIPv/acPG85HhWwg9ZrQr6d9UBbL/bQtG7OTUF9dm0pzTVYu1A5HtWv1b0LUB7gzFV2Y+lsSfSwB2DGPbncuP9xtxoczZfpT6gscNLknf9igaO0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1712648994; c=relaxed/simple; bh=8jE4Mj8r1mLjqL4M4Zt3pYptRFklRH+lW5oeMNRnHfg=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=StTBl1+y/kZf61JSzVNPjXa97stuj5DOEVagmpgKFtrddHrVlJsE2gvEnRQ/llXSNpCxknXZUePreWDSns3BnLasiT6mf4jWoAVsc4lpKXCVrjmvNZHovtRTAZmn79p8kPYzGpOObxzSWQpzLluh2Og0QdoTOP7TG/DKVv3BadU= 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=1712648993; x=1744184993; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=8jE4Mj8r1mLjqL4M4Zt3pYptRFklRH+lW5oeMNRnHfg=; b=VuKEIJudsEnyQ/Rm/tT7TN3wt+tK/yypnaGShPBTC4Rs5wEAnRp/EgDN hmIR9h6vaGQT/YIlQaa12L7sqXiuoVpVZmN9LiPfDBOzgbohtbET3oF9p va1D8goNZCLgXUITZ1PBv3rplavfpfdiwAf+1sVmvfl5wYAkv+R7WzIiT uWefvRqMUOec8TTTxCGt+I2LSqTBtLj7qlT7yF1eSRc+FT8AMLg3KnLSu m0WhsgTVekhrejeyORvNqL5tKz+PebFTw65WApasOhqnsBvcapVrTh/oT dL9Ctq/oRAb9rjIpuIYVJzm5bA+PbC+m5A+y6Qn4S68RVDt2nOsSmpcOz g==; X-CSE-ConnectionGUID: UFyBcmIjRvCW2ee5oNBFZw== X-CSE-MsgGUID: iqZ67c3VRNKwKKnav5Jfzw== X-IronPort-AV: E=McAfee;i="6600,9927,11038"; a="18517538" X-IronPort-AV: E=Sophos;i="6.07,189,1708416000"; d="scan'208";a="18517538" Received: from fmviesa008.fm.intel.com ([10.60.135.148]) by orvoesa103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Apr 2024 00:49:52 -0700 X-CSE-ConnectionGUID: Mkrrfp/ZQxqf3GKNCbAfGw== X-CSE-MsgGUID: YxWY/2JYQIGmIFuXlNir9g== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.07,189,1708416000"; d="scan'208";a="20261768" Received: from gkldtt-dev-004.igk.intel.com (HELO localhost) ([10.123.221.202]) by fmviesa008-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Apr 2024 00:49:50 -0700 From: Tankut Baris Aktemur To: gdb-patches@sourceware.org Cc: tom@tromey.com, aburgess@redhat.com Subject: [PATCH v3 1/3] doc: fine-tune the documentation of the 'm' RSP packet Date: Tue, 9 Apr 2024 09:48:09 +0200 Message-Id: <941705a0a04ad587ae42e320574d76deab616864.1712648465.git.tankut.baris.aktemur@intel.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-11.8 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_LOW,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Revise a sentence to avoid misinterpretation. Move @cindex entries before the text they index. Refer to trace frames regarding partial reads. Approved-By: Eli Zaretskii --- 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 82a617e9ad3..0c4d602f7f7 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -42841,24 +42841,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 -- 2.34.1 Intel Deutschland GmbH Registered Address: Am Campeon 10, 85579 Neubiberg, Germany Tel: +49 89 99 8853-0, www.intel.de Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva Chairperson of the Supervisory Board: Nicole Lau Registered Office: Munich Commercial Register: Amtsgericht Muenchen HRB 186928