From nobody Tue Apr 7 12:55:31 2026 Received: from mail-oi1-f179.google.com (mail-oi1-f179.google.com [209.85.167.179]) (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 F238F39021B for ; Fri, 13 Mar 2026 13:23:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773408188; cv=none; b=tsmBB6CB/7Gndl0xEinOR2ZxkEhRgEuNI3hg+5OnWz3AZD0O65//eS/2+McXVgsAZoLwJum5fGPRn9SjM6VYW9TxsBsfZLrtKt86xjek+wTh2mM4hidyps42ZHcnxEnAWuFOXOuVmrQ3f8ZEX/KF2CsQz1+tvEN+mxcKt3/BpWE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773408188; c=relaxed/simple; bh=E1VF4T7M7c35q9Qypwa46ANAajyN9sx88/WRdouByGg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=fJL/HW7i5+ZXlXEP2pt4DYq0EyJZiTvg81JozH65ZlQEXLsqcK7ccf2l5iXfpakh48t2EeJhFYNn/jUVo//h+yrzimOrwPPoyoRn4zuzSsa6L+BmlmEqvTkCfrAInUuRhlut9Ju6AZviGQClfFw/rJLY7gf76c4/NI1VlUCQDKY= 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=cCS2F5jr; arc=none smtp.client-ip=209.85.167.179 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="cCS2F5jr" Received: by mail-oi1-f179.google.com with SMTP id 5614622812f47-46704177508so1464973b6e.0 for ; Fri, 13 Mar 2026 06:23:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773408186; x=1774012986; 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=cCS2F5jrWy3+pT9/v3IFHHzZRS4ryUIg2i5U9DlQ3jvYgExUV+hhfaSNFOwja33kyt tDbbvGXw9k7Ax8T9XzYUNYpjvSVOwi83ch0X/idihNFsJoB7oyPXgXxBSDlO2ghS15S1 Q06mKVbT/q1WoKwM9js3bl+m+OyPSsV4L8qxzkw/af1srfOm3uX3Xo0WQQ7OBTh1rq5M /SNbhXVHtjENZQDlx4cb52hYayqCMblD3RnVsiHeBwEmrZ1hUyyUTV6JsfcDu4kPB7eG iMXPf+rs/1kDiKN1SpsaIQuPtComD4Y7vOKKGWDhgCLFjuORGnktQ1ew7Tp/i9vrZ4nL m01A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773408186; x=1774012986; 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=hmqAprXXhKnR1Y/Z1q2CEgXj4nwYaTPI0zMXoIYpORv6C3v5tt582IrwtJv6yqipTc 1aAmg3L0oN6harijXxWlcqXja93QLvIHsY3Yl+QPYk1L/6l5D7IV/TJAzhO3uqkXcwEG npbGnOE4n93cxeXrGsdFnDl+nDGsnD7oK50fuk3tkBv8ZjetI8ppSpqyU4dM+9eCEodu 9uZJK5xrtWdahJ28LQj9Qqbu37LKPNSpIOTN/gryTxmnHfgNbptZCzgohrxkoSYUAfQS 6bw2GaiCsCToWFSW0wTmEI0SrFhqhtdoBdx5XP7ulASHsud25uVGICRJlm7TgtywBQP1 KuDg== X-Forwarded-Encrypted: i=1; AJvYcCVqnjo3cnLjjD3ncI6i/17rULPVeS04VN4zo5AW6VkX1+k8iLK9JOCdCA1vKmsatUO48/8FJkT2/Qonkys=@vger.kernel.org X-Gm-Message-State: AOJu0YyG5JdQZaOhZEz4A40DqheBDxV5aA2/zJYAloDngaJcsRXlhU6n sCGp2KGk7Ae9pk0dqdzC+EmqbS7UgD4PXRZos/3bYbOIGuFyzl5HLgy8KEqycA== X-Gm-Gg: ATEYQzwtP6gPB0LW3zqrBT98tnJuAzXLLLyCN7XB24pWODpyrvhSvpljxaarvRy1Xem 8h3ZyzXVRdeFbqwSpVG0yo/R7eY68C9FwKlrOX6oZZajXCT4fEUcmJ/M7AO/DvSgtFlr4QM3raG nfZZBtQUOF+MjyZ9eGd+GwgloiI9pS2Yj8BCfln7ZlqAniousUzJ9F8JeatNE9zFiZdhVhZo/Hb 5oZQH31L1nbFsiQK0dSA0xSlSHzjcFH9cvNgAFhClW8Z1F3VJZvfD6CmY+LHTF1UU4+UbGPQC/G /2eRSovRLGjyixf0OIyM2zqxhlAy23Tx42hpUo5bK8ajnzLYfB3QcFcxU9D1paBIjDy0TfiYcDj rZe2VuBUxkHGBXHnUFyL8hh6CdmoqbKjhchWI2759MDYIEc/9zHYfkO5TvqDsQKZ8XZZNKmA6v2 vFR0LCU0X+5pDgodOcQieYsKLCxuDigpqPxwj1qnzEBc24nB5S X-Received: by 2002:a05:6808:15a2:b0:467:1e5:6766 with SMTP id 5614622812f47-4675766748fmr1758674b6e.45.1773408185885; Fri, 13 Mar 2026 06:23:05 -0700 (PDT) Received: from frodo (c-98-38-17-99.hsd1.co.comcast.net. [98.38.17.99]) by smtp.googlemail.com with ESMTPSA id 5614622812f47-4673434a35csm4795987b6e.20.2026.03.13.06.23.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Mar 2026 06:23:05 -0700 (PDT) From: Jim Cromie To: airlied@gmail.com, simona@ffwll.ch, jbaron@akamai.com, gregkh@linuxfoundation.org, Jonathan Corbet , Shuah Khan , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Jim Cromie , mripard@kernel.org, tzimmermann@suse.de, maarten.lankhorst@linux.intel.com, jani.nikula@intel.com, ville.syrjala@linux.intel.com, christian.koenig@amd.com, matthew.auld@intel.com, arunpravin.paneerselvam@amd.com, louis.chauvet@bootlin.com, pmladek@suse.com, ukaszb@chromium.org, dri-devel@lists.freedesktop.org, intel-gfx@lists.freedesktop.org, amd-gfx@lists.freedesktop.org Subject: [PATCH v11 05/65] docs/dyndbg: explain flags parse 1st Date: Fri, 13 Mar 2026 07:19:30 -0600 Message-ID: <20260313132103.2529746-6-jim.cromie@gmail.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260313132103.2529746-1-jim.cromie@gmail.com> References: <20260313132103.2529746-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 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, 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.53.0