From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 7esyKvrvoGhqEgUAWB0awg (envelope-from ) for ; Sat, 16 Aug 2025 16:54:18 -0400 Authentication-Results: simark.ca; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20230601 header.b=afUtP9hW; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 9B7FF1E047; Sat, 16 Aug 2025 16:54:18 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,RCVD_IN_VALIDITY_CERTIFIED_BLOCKED, RCVD_IN_VALIDITY_RPBL_BLOCKED,RCVD_IN_VALIDITY_SAFE_BLOCKED autolearn=ham autolearn_force=no version=4.0.1 Received: from server2.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 ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id B80F41E047 for ; Sat, 16 Aug 2025 16:54:17 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 497143858D26 for ; Sat, 16 Aug 2025 20:54:11 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 497143858D26 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20230601 header.b=afUtP9hW Received: from mail-il1-x12f.google.com (mail-il1-x12f.google.com [IPv6:2607:f8b0:4864:20::12f]) by sourceware.org (Postfix) with ESMTPS id C086D3858D1E for ; Sat, 16 Aug 2025 20:53:40 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org C086D3858D1E Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org C086D3858D1E Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2607:f8b0:4864:20::12f ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1755377621; cv=none; b=exKqEV5wgkIATHTm4tD9mxJCTWTjed2gLrn0fOM7met4vtocepJ6878hBERy98J3USakILG6j8Ow6hR8/U9tb2bfyzR6bwDIY05K/NN6S4JX9YFA6/6Zlwi3GjCkLDprNZDS3PRvW+kcEEkrh3U7kaNhD0JV15MuXmOT1RT2y2c= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1755377621; c=relaxed/simple; bh=fesfmKb1vf3xbOsnEyT4ka5XFDFfSzrP45qjnatgfFA=; h=DKIM-Signature:From:Date:Subject:MIME-Version:Message-Id:To; b=nt7u5Z2dJAB9MSrfS8bkEQx92IXTV6ZGVG0fgddqrHc1z7H2+zj4CrZJvS3WtsClGjxxDojGtEcQKFYkvTROrHypji++1+TTGTvlOX7PjHkBHIoHFiYzFIdwyXw6V8Z/L9ljUDJlGYDwVKPz73qlQxPdYsFdKDYTV4YiG7dsARg= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C086D3858D1E Received: by mail-il1-x12f.google.com with SMTP id e9e14a558f8ab-3e56ff1f604so17623645ab.0 for ; Sat, 16 Aug 2025 13:53:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755377619; x=1755982419; darn=sourceware.org; h=to:message-id:content-transfer-encoding:mime-version:subject:date :from:from:to:cc:subject:date:message-id:reply-to; bh=6H3cZ8tpvsV3K5c4uxROeNGLRaT06trm6J1Tabmb65k=; b=afUtP9hWkOrNddRsONJfPTAplg0zBtSK8V+669EPxofDWWMrizzVjaeaG4rHnmrVWh X2gv1L3kwzTx8d7TacU6T5cgnzaLAwEy3qF2/EhuztF3uRug5IY9Tdove02AGq6LDdE2 9vMtbtb2YMt486+vHl467DlUspm5jfMYJagCyErM3h9hc78fMBx3iD/E5gl6HrD1tiTV /pPNZIlwtAqRJSyiVXOFszjCLHrKwTNWk1tq7fg1s51b5xNcWQ3mePe/eBc776dLXWzi 8mkKx9M33o1tcQiEh84TQeuymz1YIYWJm94Gtlu2qkcCC4lpKOQcHJGi+MyHHCKQImMU DReg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755377619; x=1755982419; h=to:message-id:content-transfer-encoding:mime-version:subject:date :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=6H3cZ8tpvsV3K5c4uxROeNGLRaT06trm6J1Tabmb65k=; b=bpxXfb7Pkg3166Wa+4jJZv3nHJiuRz6mKhDfm5Dp98lzToILOgxzgTspYuOcDrETBq QOYAidnFqCXBI07ZYTyhqvugArDPtkyY+VJ+b9F1qe9AePRAMfzdskjL4Q/PnN+4InSJ +Lp+/QDAnCu9naU2NuaqqW7UqYrkxHSg/oNYlrtB+lxxlKTTiQtnVOWm4laKq0dGMxLR XDeFpXtNB/ZFB9zGTw8TxiwDWAiQphoAqK5lH7cH9xcfUZvlQKMNQ0/COCZt/3wYja+q fK/me8FOcIHLJwFZ1IVeNAndtprqahJJURSI0NTsPqv4mPs1yzbKMHcx9Z9eZ0WvHOxp A7XQ== X-Gm-Message-State: AOJu0Yzo4/Mz0KlRuyxRl7jbKmQSQPfLbQ3eqVeXrrm2lYqBPfox6QRq D3GeeDU2vg+Er+7Y/5/04aYEP+g2tSW1ek16erYu9s5HNcYInjo5ZyjPqy5liw== X-Gm-Gg: ASbGnctmYHC3U0SWgoXnPm9Y4PzjsJ9YZG/yLp8iztLUZo3dMNiodDdoHpdv3iTP6hX GDSO404BYtCVijk5ldOKkChjMgyeDB67wytA4+Q9bP0GYIKFxTbeeAqDx+RwIksRlVRPJXpVEs6 uOirSTsHSSBVDX6Mfzx3o2nAZiK0jGZsM1zulQPeiGU5lTkqDdJEd2P7ePD0iejum+4TdyDEClx Nndv7bBylLOCg5NfooN6zv/5sHmSH8vBq2BI8OmoO+lNIcSeW/HcebzWj5Fax6vNYZ4wAJduZHm Tywkbpk1ls5xgZfQWw0PVagfZk/bZm9n1WuR0MJ+ucXkUbu47jyNh02GPmQ0gR6FbbppGnCx4FJ kEjPGy9UhBQjg4IWffgHvg6/UYQsBtOGEnAOu18hfVnVkeb2//wYHeTfxQI+LgYEp9SQoIIr6eJ p30fw= X-Google-Smtp-Source: AGHT+IEh0p+U+1d61dsKPPHQL1fewez8wM9IaYETBrS4r3eJstnBA75d37mfZwBxJSGoBDrcD+NYng== X-Received: by 2002:a05:6e02:19ce:b0:3e5:42ec:1357 with SMTP id e9e14a558f8ab-3e57e7da221mr139556255ab.4.1755377619476; Sat, 16 Aug 2025 13:53:39 -0700 (PDT) Received: from [127.0.1.1] (172-2-191-226.lightspeed.clmboh.sbcglobal.net. [172.2.191.226]) by smtp.gmail.com with ESMTPSA id 8926c6da1cb9f-50c949a0190sm1333649173.55.2025.08.16.13.53.37 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 16 Aug 2025 13:53:38 -0700 (PDT) From: Aaron Griffith Date: Sat, 16 Aug 2025 16:52:54 -0400 Subject: [PATCH] gdb/doc: qSearch:memory packets use escaped binary patterns MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20250816-qsearch-doc-binary-v1-1-55e8f1864ddd@gmail.com> X-B4-Tracking: v=1; b=H4sIAKbvoGgC/x3MTQqAIBBA4avErBtQ+yG6SrQwnXI2ViNEEd49a fkt3nshkTAlGKsXhC5OvMcCXVfggo0bIftiMMp0atA9nomsuIB+d7hwtPKgb5QdTKPbhToo4SG 08v1PpznnDyiypdRkAAAA X-Change-ID: 20250816-qsearch-doc-binary-d30a82314be5 To: gdb-patches@sourceware.org X-Mailer: b4 0.14.2 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~public-inbox=simark.ca@sourceware.org The `qSearch:memory` packet uses hex encoding for the address and length arguments, but the search-pattern argument uses escaped binary. --- This documentation change can be confirmed two ways: * Inspect the packets sent by gdb with `set debug remote`, and then search memory with e.g. `find &buf[0], +sizeof(buf), "foo"`. * The implementation `search_memory` in gdb/remote.c uses `remote_escape_output` for the pattern argument, and this function is documented as encoding escaped binary data. --- gdb/doc/gdb.texinfo | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index d4a5a632c24306f6c0ff6bd6d14e01a847e9a494..0ae15642c0d1b92f08bbd16011cf0214deec6dfa 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -44887,7 +44887,8 @@ packets.) @anchor{qSearch memory} Search @var{length} bytes at @var{address} for @var{search-pattern}. Both @var{address} and @var{length} are encoded in hex; -@var{search-pattern} is a sequence of bytes, also hex encoded. +@var{search-pattern} is a sequence of binary-encoded bytes +(@pxref{Binary Data}). Reply: @table @samp --- base-commit: e579b537353cd91cb8fac1eaeb69901d4936766f change-id: 20250816-qsearch-doc-binary-d30a82314be5 Best regards, -- Aaron Griffith