From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oo1-f45.google.com (mail-oo1-f45.google.com [209.85.161.45]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 33D9C386565 for ; Wed, 8 Apr 2026 20:02:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.45 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775678548; cv=none; b=QdW/sDzVFGt2hm1gIwAmiO8leKRDG8jti9p+vcLWT0Bf52c4U5IOJoT7Qn38bHr3eLgPIUjOc3qQR1M5FWM8utXrLa/1LdfoTUbHsB+C1kQIMBJRisV0i/h/f45FFdvZkKTrCX5uP99ay5ugnxNmZ9/z+Tzv+/tZ8kMNsIodM24= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775678548; c=relaxed/simple; bh=E1VF4T7M7c35q9Qypwa46ANAajyN9sx88/WRdouByGg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=RkBhSz0k+qiXJ6vOp4EiaUQgOpdxYpXsudKdo0h2R/Q7ZvfC2RbVEKW81mRAdFgU1NgjMe8MM3bfHRG/WbbY2fzE2smuHhI3wbxwm9KGMsJlV+5Qp9cj0okNFzBiWnexEmD5+2lsDrUxDcrdGfD59mswl27YcD/YzZW+P8eb85U= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=lC5H+HsB; arc=none smtp.client-ip=209.85.161.45 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lC5H+HsB" Received: by mail-oo1-f45.google.com with SMTP id 006d021491bc7-68470763896so83339eaf.1 for ; Wed, 08 Apr 2026 13:02:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1775678545; x=1776283345; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=4wIIBK2xLHmy9ZZczWpP2RzFmOx4bELZz7aMw+RGO2w=; b=lC5H+HsB7LjjlA9mRpxkvYVRssBvFBiq40kbqZGSv59ZpCYnwzW5hwIEpSrnU3Ls6A bG0ejlRFSnYDu93tO0wdTnVzXsQ9dPdz6DvmrGhVes/x34zGxH7/YW2AZMS6bKxzNhOM i2OXCzziFoGscl8Dc0hQP5M330soJ2BvBEFxlAz0fs89ewJY6KkupjuYZxRoZy7WXYqr QNnmIRsi+TOp6pB2iGj0XiFuOqt93wz6BS7ud+b/2dD7SWEMMnILXJeqmRKaKFaztGJE 4B/OkQmBkh9EpS8uIdaUoGx7plkLBtiBEi8pniIGY3gg666NKmewLgXyZl45dCOlw7MI xq8w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1775678545; x=1776283345; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=4wIIBK2xLHmy9ZZczWpP2RzFmOx4bELZz7aMw+RGO2w=; b=V41/g07BIByv3kTk/3IzSsZvX8O/mBr4aklsySC41iw1SEhliJGGJTUUEUnXt7M0gq 9oE16jbiqi6gwQiKtTwSsikP/UpdnsOrXvFVUqWF7dglw2hnNr0RPCpv2mT9a9McIFRW pYKZOKGLF3YMYbO6IlSqJuOE0+RbyLHG0aXfhZLDLoF6eWocwzDdsDuRQ1tPWb7poem1 sAQQ5Du8x9ywGL3Z2yT9kiqRdSKgOrL9MSkAgPQwXyhJVp7B3GrsOppH0tPK1t3Pk3cT V/XSV+pqWO8tgj4opCkj487w1Vo4e8HUq5OpzEaFMQzF8HHw0mQZBQcId1lKteN7CT3d k25g== X-Gm-Message-State: AOJu0YzYMLyPwBz8Rlllek8GZwu1CHxoVEVn+rQETs3vMe7LoWvWL4V3 /RR5wxil+qF19fsHcwW9wAiCedQMnmBdRApreHNU5PUgcD7nlwFpJpghZx4rvg== X-Gm-Gg: AeBDiesJoaffOXFxRXwxsCbK1CIAp0S6g6ZVEhk4rCCI1YgUYbyOSboiY1PCb7Fley/ arWTXS8V8JgXABXy8vvZcEFl1CQcnP8VCPzC7zV/7iFK5lwSSW4wI8/P9Lvk1HQuLfIZY/b2zC7 gJ1UVMzWRNocZw9KtKLvzj85630rtCBE9/0he0iwQ/g/V8MYiQ8knPJuLgLNhmUoRFTF3U2SUUV lzTUPDUW6K/IQ5jqawdMe1nS9WOHo0+J6Sxw47J4SWsuH+qvMutc41J8OdGR+gNhF7kM9b1I57I Wez9AmXxcQkfr+JUQhGou6iDrB641HqKJX7pGCiuHHB7pCWLG3Vx+zObd25jgozXkpQxxV+PcAS no48ZaJ3rsO4BbpSltrA3aXXtXT3sfFlftM+dn3mBeyWXtFqOBo7rzqUAF1HXfSOZ0BNHMg6m71 LX011CtdKHVt0qV9rL8FeYsvinHBqR+6v/z5HNQZN10uBuwG+ySMiCwh9yMvLA+Himc8V9VBT69 Do= X-Received: by 2002:a05:6820:2004:b0:682:644b:ba03 with SMTP id 006d021491bc7-682644bbbaamr12449783eaf.16.1775678544819; Wed, 08 Apr 2026 13:02:24 -0700 (PDT) Received: from frodo.raven-morpho.ts.net (c-98-38-17-99.hsd1.co.comcast.net. [98.38.17.99]) by smtp.googlemail.com with ESMTPSA id 006d021491bc7-680a63c7fd1sm12254208eaf.8.2026.04.08.13.02.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 08 Apr 2026 13:02:24 -0700 (PDT) From: Jim Cromie To: linux-kernel@vger.kernel.org Cc: gregkh@linuxfoundation.org, jbaron@akamai.com, louis.chauvet@bootlin.com, Jim Cromie , linux-doc@vger.kernel.org Subject: [PATCH v13 08/36] docs/dyndbg: explain flags parse 1st Date: Wed, 8 Apr 2026 14:01:43 -0600 Message-ID: <20260408200211.43821-9-jim.cromie@gmail.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260408200211.43821-1-jim.cromie@gmail.com> References: <20260408200211.43821-1-jim.cromie@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit When writing queries to >control, flags are parsed 1st, since they are the only required field, and they require specific compositions. So if the flags draw an error (on those specifics), then keyword errors aren't reported. This can be mildly confusing/annoying, so explain it instead. cc: linux-doc@vger.kernel.org Reviewed-by: Louis Chauvet Signed-off-by: Jim Cromie --- .../admin-guide/dynamic-debug-howto.rst | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/dynamic-debug-howto.rst b/Documentation/admin-guide/dynamic-debug-howto.rst index 4b14d9fd0300..9c2f096ed1d8 100644 --- a/Documentation/admin-guide/dynamic-debug-howto.rst +++ b/Documentation/admin-guide/dynamic-debug-howto.rst @@ -109,10 +109,19 @@ The match-spec's select *prdbgs* from the catalog, upon which to apply the flags-spec, all constraints are ANDed together. An absent keyword is the same as keyword "*". - -A match specification is a keyword, which selects the attribute of -the callsite to be compared, and a value to compare against. Possible -keywords are::: +Note that since the match-spec can be empty, the flags are checked 1st, +then the pairs of keyword and value. Flag errs will hide keyword errs:: + + bash-5.2# ddcmd mod bar +foo + dyndbg: read 13 bytes from userspace + dyndbg: query 0: "mod bar +foo" mod:* + dyndbg: unknown flag 'o' + dyndbg: flags parse failed + dyndbg: processed 1 queries, with 0 matches, 1 errs + +So a match-spec is a keyword, which selects the attribute of the +callsite to be compared, and a value to compare against. Possible +keywords are:: match-spec ::= 'func' string | 'file' string | -- 2.53.0