From nobody Mon Feb 9 08:56:31 2026 Received: from mail-oa1-f43.google.com (mail-oa1-f43.google.com [209.85.160.43]) (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 98AFD2F531F for ; Wed, 14 Jan 2026 01:59:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.160.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768355942; cv=none; b=Y1Ed9nJ9E3JO6lDBWdSsSNwb8j/W+XoK3CdyMb1r249BZNX6B2f9fTvFBxMIOqjViQlxFpqigOwcYIPMfxUvSEImDKW4WWb+WFRo7olDbOabPGu49AdteLR4SJuwhIkK4YRqZ/lexNjhmB8VM85zE2ND63NVZGIUApTWahyM5qA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768355942; c=relaxed/simple; bh=EqxGeITc2UKYaMAzZMDYQfg02UCHl3X6FUpCJ4R9urE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=r7v2Eqw5hkKC5Egg2knMU1U6LzC1Wz9cd3pD1WSTEf6XJgA84rJMRWX06zngkmsfLaDC8QuUHxRqlrPqH/NKtINEJV2YVwqkyW5m1RD+tr0vvk6fxzQnE2NMJu4zSEhxOj4lVGPbpFEVAKTos0mKD75o1g1LUd+VS1K3B3DEzdY= 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=B8vVebGi; arc=none smtp.client-ip=209.85.160.43 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="B8vVebGi" Received: by mail-oa1-f43.google.com with SMTP id 586e51a60fabf-3ffbfebae12so2700496fac.2 for ; Tue, 13 Jan 2026 17:59:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1768355940; x=1768960740; 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=dFfaj1jg7DkAQbZ2xQqGZ0nerYqYJ2u1eC/UX4LEwiY=; b=B8vVebGiYhihD0QIhIsJgmdhmqh1SaFfiusq+xMbXalNPyNmIrXg3afpRis6xfqhAi 222xGjokB0CgddqX4gCFDfk0fd8y2nszCXU0CKhKnPI5LhZX/HiqXh/u42itp7waVF3v 4gzYXP4+cOHEI8nZpN2fPqri3Lq6/gII/Sw4o+xMxzoa38p+I934dkOfsrmO7rfXK8a8 f8s17AUJYG+aMRwReO3izqIu6gcLckDEntZsldvQt4Ncs7k0wlKYiZ0rOuPS7sTcUd3/ o+FO0q/cYLWG22Ynl/xsTsp70To/rf/wwrv+EaKsSDQi5kfg36OqVTjpSV3dbMh6cEne V7qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1768355940; x=1768960740; 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=dFfaj1jg7DkAQbZ2xQqGZ0nerYqYJ2u1eC/UX4LEwiY=; b=jV9tvpvJxJ1LSSULq0X7XlzD7Wq90On02faMIREe+rgTSCFdUbrKaVUHFrjON8Zu06 I23U42zmN6+SIWee2YHM9gm5wrr2GzWCHFvcUrH16VAO2xrIvmMORXjvsIEI4hydckmP L7yYyef+9v71UtuJWGqZRAq4PNHgid+2drPP7bOHAUnBE5dmHNFsnzIPDKr7fWsBhdGR 7MWplNcaWVd+nocdYaRkUblRXIohCYSUtymfNV0bT+8nDR2wzAeui5fl0c2RUg4ilVVj K20x/Cn+K02OUr6KRCKqN9nvz3FkH1jDMH2uni4XmjN+/gGjdkovZ3T/Wp4mANqLUXKx S2pA== X-Forwarded-Encrypted: i=1; AJvYcCXzNwMWhl6XYIPQ/+70MqMr6OxXdkLnoxl7d/nwJH1ohIhwJWT6i4Z8efh4OAeLMEKzcq2OSPuCIRDrxGs=@vger.kernel.org X-Gm-Message-State: AOJu0YzAwwONjtCDSIWFA1kH3WfiFpLMu08r6ie3XFNlnkWsYgMBd3WL 1iV72exzJzbS1md+I0OHm5sI/xqtenraAjH0ttvocbFvLt13ivm3Uyvp X-Gm-Gg: AY/fxX7NV5F8rhqjZduWlj/EWZ50WV54ejeKHtXHpwqa5mbAx9Kw4A4uD/a58sCUpEB j5kj6il1dysLyRcTLBtrNL4Skk9rwwug41ya/Xv1wlIOUeb0Bx7XmUIOX5gVJGkzFzZsbjKJLDh 7nv9+Xki1Cl5hCSMl2hQHuzjkv3owP1W+MkYwZYB7rYIFM/tDx2vh8LlhpdmwLOiUq+jjxMJSgW jcw905Jf+F18kxzgNITv+xFOcarhjxNjzyavBVSZEto6u1JwX2mHH28yzM14D2JPzyyKwSV+U76 VSGXZmLqwMSTlk2Rsuy/3FE+gEAK66o7WFCRcwTkPdQkosT8Z91me+I91QYMiR6Iym4A8I/KsC3 GTGNi47UGKX52IcjLpdBEXmR08OmPVQl4NRoQBpn7s1393GAWMZV727xk9OrAImat+5lfZuwxBd Da6jbnIX2MXJUiSyKfsJleLP7yD4h5C682HUfg X-Received: by 2002:a05:687c:409c:b0:3f5:d9b0:567e with SMTP id 586e51a60fabf-4040ba70e63mr407331fac.14.1768355939842; Tue, 13 Jan 2026 17:58:59 -0800 (PST) Received: from frodo (c-98-38-17-99.hsd1.co.comcast.net. [98.38.17.99]) by smtp.googlemail.com with ESMTPSA id 586e51a60fabf-3ffa4e3e844sm15596198fac.9.2026.01.13.17.58.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Jan 2026 17:58:59 -0800 (PST) From: Jim Cromie To: gregkh@linuxfoundation.org, linux-kernel@vger.kernel.org Cc: Jim Cromie , Jason Baron , =?UTF-8?q?=C5=81ukasz=20Bartosik?= , Louis Chauvet , Bagas Sanjaya , Dave Airlie , Daniel Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , dri-devel@lists.freedesktop.org, Petr Mladek , Shuah Khan , linux-doc@vger.kernel.org, Steven Rostedt , "Liam R. Howlett" Subject: [PATCH v8 04/31] docs/dyndbg: explain flags parse 1st Date: Tue, 13 Jan 2026 18:57:20 -0700 Message-ID: <20260114015815.1565725-5-jim.cromie@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20260114015815.1565725-1-jim.cromie@gmail.com> References: <20260114015815.1565725-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: quoted-printable Content-Type: text/plain; charset="utf-8" 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/Documentat= ion/admin-guide/dynamic-debug-howto.rst index 4ac18c0a1d95..e76ccd987704 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, up= on which to apply the flags-spec, all constraints are ANDed together. An absent keyword is the same as keyword "*". =20 - -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:: =20 match-spec ::=3D 'func' string | 'file' string | --=20 2.52.0