From nobody Sun Jun 14 06:08:25 2026 Received: from mail-ot1-f51.google.com (mail-ot1-f51.google.com [209.85.210.51]) (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 74D691EFFA1 for ; Sat, 2 May 2026 23:33:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777764782; cv=none; b=TnE7rC3A4u9IJXCRNvfqBJLHks7SnhNTc5FaZ02CPPnBIqFMBnAD262AEpZxGoMyYsujZhM4ljKRcLKiqd+5N/u7/WrvhbgVeVsq2h2YWvetLrJklHIHnno3DO5zE3ZY8eyVeXFkBLQ+MOu/NV3kar8P8rpGYwTLdcWqimMTfdU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777764782; c=relaxed/simple; bh=/BEze5uZvE97vkdxdEKscGQmmLTlvHt75B8/b2suPbI=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=B31PF5O9Sl3XswsMEwciEan6dLXo53R5rHKaAy1wgLossGJAla8sYO2l6bV7MdiDnkTYrvlq68Ym1+N3d9iSbedWJqYkzIbfiO4btMaMQYIMwFsyA0EjSWE/EFpF9+vcbL2pWDvwB7YXvyASixDAv0x8VrgJsC3fx11PuShGsI0= 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=OScRb0GR; arc=none smtp.client-ip=209.85.210.51 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="OScRb0GR" Received: by mail-ot1-f51.google.com with SMTP id 46e09a7af769-7dbd801138eso1907508a34.1 for ; Sat, 02 May 2026 16:33:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777764780; x=1778369580; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=CwPLhLRZkxVDbJ+XZfxPTCPSMzzunTFiSNGj95FvoLA=; b=OScRb0GRl3XRpQN/OFG1BOCVoEe0unh7oqxpiZU/jxCzO5Qd3RA8FRrtcJfiiDSi7a 0CkRG/boKlv5VxHsTSDydlFoVpE4pe8ADbPz3htaMl6/CxXe4crfP2fyk1zR1iFAiqND iPx52ie7A1kkGt2Go1GuvRpUcw+03LTeM5xOfdjKwpQmTyG1Z29bTz8sUc3a1nADr9fb xPQi1+yQCWaMwOnBVwObpqMsXjLkC/sdckvvBOjvZ8h8HfXA7Nw2+zXUMzpE2svfoESn Q2is+e1DNdlg/HURue3nV0WqUps3Ydj1a3itIijJTefW6H+e6SZLQCnH1kpXRG4yqvoS eq9A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777764780; x=1778369580; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=CwPLhLRZkxVDbJ+XZfxPTCPSMzzunTFiSNGj95FvoLA=; b=cQ4rXSXKtB9KywqHOKG/mBGBpRDZYi9H52SyDCAPkbDlUi4uUKRZTK5Cl9JUs3czhX ifa7LzyLxSGQDHoGNcJoPSJT0cfcLtjKSJJYBMHPczPWplxQgz3733u+alc3R41fgd3D Q7xv59Y9vHIpla6KNfbvHvGQi3EbWn6Sf+IziWgRYPRSzkzQpI5X6tq6/9gXKFj+A+1Q qsM0EgHQ5vT6X4tCQsnGu+ZnIW64WvM6jdjeR/C1Akmou8pq+k2+3canUJmH7mukHAgV cYxiJCGcCMOGE1VvTl7qHvwDI9FyLxZLAMVq4YxXJUkoRGFtc/OC0SynKmKjYzYPBzpl LaTw== X-Forwarded-Encrypted: i=1; AFNElJ/eDmC3PqkG70ntznjeMXVxFPrGqhDgVwO664p2lpG8KQQb3tqoJ32FIC9Zcbhqm7DpcIE8CwmCQbVFt60=@vger.kernel.org X-Gm-Message-State: AOJu0YzcrVEF0Cn4bVErjErHa82jdqWGd4dA2s0dTvybBbHoTVCNTxGD Ip+Z4SPtkH7mX5Fy+gVVPZyRcH3cFKFsRAtsD1oWm7EmBLtSHvGfOb51/N0/c06Y X-Gm-Gg: AeBDievuK1C6U4ume0hfL2l5MQdaSRMt1VkG0PRYUojRkNE2x+M1ZCEV0gao7UoxlPH GnyyRuN/PNcNc4pKfX6DqqPxwlmJ9nanBFsWqiVdz+H/XZGGf+r1bXvTQmwvhAdpnz6ZJ4crqqy NZzJqP11phB6A9mu8oI94YDEockQus1dTRS3XPoxY1uQwA+d0pYfDJ2uqs5m36dbPtXxMcPnaVH QkCWd6qd9qhAF7GW9lNYWq4amJKE9TW8HU6xBb1CwFMjz8WAH5kU3zG1xid6f3wqHULwGPy4jSP mJOTs721ArB2EXubMMqmWGWDZ59WhQXQepWJSKjWYleVaW865ruQtAL3/xikDcecwwir+lQMALZ 1EMTZEPcCkuhXwEvgy4cXQxLWDTLCZyzg2VsBhPP3ajX8hGPOiy/2Nn5gSuFETE2+K0HdcQRUR3 KMTlREX87pv781xPs+6ppU7F1iQe7Yn8Vz7ECzplaFfJ77NL4P7rxqWEmMdr6VN7KXk6tP8L4i X-Received: by 2002:a05:6820:1508:b0:696:1b18:18f3 with SMTP id 006d021491bc7-69696bb60d3mr1909403eaf.24.1777764780346; Sat, 02 May 2026 16:33:00 -0700 (PDT) Received: from [100.82.231.29] (c-98-38-17-99.hsd1.co.comcast.net. [98.38.17.99]) by smtp.googlemail.com with ESMTPSA id 006d021491bc7-69689266bacsm3903680eaf.0.2026.05.02.16.32.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 02 May 2026 16:32:59 -0700 (PDT) From: Jim Cromie Date: Sat, 02 May 2026 17:32:55 -0600 Subject: [PATCH 1/2] docs/dyndbg: update examples \012 to \n Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260502-dyndbg-doc-v1-1-67cc4a93a77e@gmail.com> References: <20260502-dyndbg-doc-v1-0-67cc4a93a77e@gmail.com> In-Reply-To: <20260502-dyndbg-doc-v1-0-67cc4a93a77e@gmail.com> To: Jonathan Corbet , Shuah Khan Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jim Cromie , Louis Chauvet X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1777764777; l=2677; i=jim.cromie@gmail.com; s=20260203; h=from:subject:message-id; bh=/BEze5uZvE97vkdxdEKscGQmmLTlvHt75B8/b2suPbI=; b=JTTcblre3K9H4lSFX/B+n6UQSsAIotCrurQYdlJsTXW7AOhVqHdyUgO0Rm7SCK5iS8VDGuCJX +4ax+UDJuv6BlMJo6GCV/yZ9FQZp8ZgeNBhjI2G82uaHvfe/HBDDh0B X-Developer-Key: i=jim.cromie@gmail.com; a=ed25519; pk=C6E5ODlPQo7ZBynATXH9wg7K6HxP0pIXyf4s38Qw0XE= commit 47ea6f99d06e ("dyndbg: use ESCAPE_SPACE for cat control") changed the control-file to display format strings with "\n" rather than "\012". Update the docs to match the new reality. Reviewed-by: Louis Chauvet Tested-by: Louis Chauvet Signed-off-by: Jim Cromie --- Documentation/admin-guide/dynamic-debug-howto.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/Documentation/admin-guide/dynamic-debug-howto.rst b/Documentat= ion/admin-guide/dynamic-debug-howto.rst index 095a63892257..4b14d9fd0300 100644 --- a/Documentation/admin-guide/dynamic-debug-howto.rst +++ b/Documentation/admin-guide/dynamic-debug-howto.rst @@ -38,12 +38,12 @@ You can view the currently configured behaviour in the = *prdbg* catalog:: =20 :#> head -n7 /proc/dynamic_debug/control # filename:lineno [module]function flags format - init/main.c:1179 [main]initcall_blacklist =3D_ "blacklisting initcall %s= \012 - init/main.c:1218 [main]initcall_blacklisted =3D_ "initcall %s blackliste= d\012" - init/main.c:1424 [main]run_init_process =3D_ " with arguments:\012" - init/main.c:1426 [main]run_init_process =3D_ " %s\012" - init/main.c:1427 [main]run_init_process =3D_ " with environment:\012" - init/main.c:1429 [main]run_init_process =3D_ " %s\012" + init/main.c:1179 [main]initcall_blacklist =3D_ "blacklisting initcall %s= \n" + init/main.c:1218 [main]initcall_blacklisted =3D_ "initcall %s blackliste= d\n" + init/main.c:1424 [main]run_init_process =3D_ " with arguments:\n" + init/main.c:1426 [main]run_init_process =3D_ " %s\n" + init/main.c:1427 [main]run_init_process =3D_ " with environment:\n" + init/main.c:1429 [main]run_init_process =3D_ " %s\n" =20 The 3rd space-delimited column shows the current flags, preceded by a ``=3D`` for easy use with grep/cut. ``=3Dp`` shows enabled callsites. @@ -59,10 +59,10 @@ query/commands to the control file. Example:: =20 :#> ddcmd '-p; module main func run* +p' :#> grep =3Dp /proc/dynamic_debug/control - init/main.c:1424 [main]run_init_process =3Dp " with arguments:\012" - init/main.c:1426 [main]run_init_process =3Dp " %s\012" - init/main.c:1427 [main]run_init_process =3Dp " with environment:\012" - init/main.c:1429 [main]run_init_process =3Dp " %s\012" + init/main.c:1424 [main]run_init_process =3Dp " with arguments:\n" + init/main.c:1426 [main]run_init_process =3Dp " %s\n" + init/main.c:1427 [main]run_init_process =3Dp " with environment:\n" + init/main.c:1429 [main]run_init_process =3Dp " %s\n" =20 Error messages go to console/syslog:: =20 --=20 2.54.0 From nobody Sun Jun 14 06:08:25 2026 Received: from mail-ot1-f46.google.com (mail-ot1-f46.google.com [209.85.210.46]) (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 6485330EF94 for ; Sat, 2 May 2026 23:33:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.46 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777764783; cv=none; b=P/upUt9PIrquSmwUBkh8HTPM5GmqXGqXL8xoF4eCSRh7WWgxVkpYRhcYmqsCt0g09aGHOXO2YL1ulSm9SYxkTVx43gdV/g4fA4fS2lLEOG/3u0Rf52trJGgnMdTX6n6SqrSnxRiTVyei+MHEBtZPyQ0JR+x4XLXv0t0IXd0Oosk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777764783; c=relaxed/simple; bh=Ybb0kJKNd2BJDDcZYbhZbCACFsLVAC7m/M+jXCdbe+s=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=l4GR29bZqugZ0mEI6KIdf2yHHhqwQS+yeeT6+7gLIwUy7U9Cr+kdIiKuUG2DBer+wufOfedUiIiu2PBTEHyM9UMRqSMyLPqUW5asttqhAGJOd99GeQoXek3CAki12QCHZJ/nI/CFQnE2/b2ez4uD90z79VybeTmwe2ZYPzNOUFk= 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=a3jE3rHt; arc=none smtp.client-ip=209.85.210.46 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="a3jE3rHt" Received: by mail-ot1-f46.google.com with SMTP id 46e09a7af769-7dd73b7c757so1456847a34.0 for ; Sat, 02 May 2026 16:33:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777764781; x=1778369581; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=T5zD1QygmB8fWogN5M5u4F28IFz6bLgLGYRTXYqao/U=; b=a3jE3rHt3c60r1uF7fLHC1sE0mchu5b4qfr7i2a+hI2gu/RV69j+qzMQ9iZQakcLOF CBBv5nC+BNK7dihM2kIgBQqwhmMZcK/S06Kpg9Es2ucl9Ww0+RHjijVfvbmB7LnxD0aI EUbr6OHy51NPNq6VhKr3vDtUiSY1l9b6g4t+lyKQfkfqKwFcUmsN6uHRMaxTRqHFoFvO azvLgdwup0kQF5eYwuVbo66j91dSyIm5/TMZKhH0CR2zrRFWZQYJMMhZhPqxh7yqYrgK MV1o5ESxjJXUFB2kd+1uf1f1fbwgc5mwfGz56cDUEP/akuvhDV7P6egtbPeVBgx/+osN N4+A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777764781; x=1778369581; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=T5zD1QygmB8fWogN5M5u4F28IFz6bLgLGYRTXYqao/U=; b=sfExCR7aQcPvvTQ6G4QhXA9RZnXNuA2FUP/TjKp6J0K2AtP/vbeTiJk8t0fceYDuM8 2rfs6Ztvs+8Y3Sf11vfRJ0wzCpFm2Kyf3h3QCgcIO1mjvu7bsfX6UA77/MQcsTcPgqZB mfIqPIgKMY94PwbYCq0vS6OjIQLgW5gARkVWJj3GwqwomGqBiEzqJ9y+/IXn85XpJipw vepvf6Xyd37hcUKHr/Op7okVOYYicWUXzByJjXBKK6RZNbjdUWBh97jx8oC+m77fEHvQ r7ZCkqBs5r6wy25DmAU5AoNXdmCpXVe6lWjGR9+os5AaIR641nCZcIC6xnt9/nh3JBHZ Ga7A== X-Forwarded-Encrypted: i=1; AFNElJ8LrOrMYB9GRbB/EXhNlCFq78Pe5loMX6D+UGJrck5YroU3H3oD+IyQOALBhAT6FjldGR6a8FKcXb5qjSA=@vger.kernel.org X-Gm-Message-State: AOJu0YyccJI/jF74niMLPWZigkO0kLmQ7mXPclZLGBz5iv8ltcSI6pb9 DpV2AFKua35LO+uIaeCTB3fjgyzkVoF4gVBGhNJlffzw1e6lYHMUsTmd X-Gm-Gg: AeBDieuQLUeku9ArVNa/dZEBQEaQPUv2AYKAF4rmdSu7Bln8fZcV0jgUq/w1P+G0aDS FvBsV6RY8i0tVODBcopkUwlApKHdZKUMl3cZCXqB8Z7TgEtOV/qOT3Hucb2ZHQWQTxb+6DSmw1A 8spsJGuFdvM2KBYcymNZ4k+MWog5u4lc5YcDOFvZsArdL3TwI3I4koOIMkBBB9uqmaxrNmaM6BA 0DoXgBNp6CP3T1akNqCKPwAoofyu8CoWJozaS+v5h69dKG6SUhmdFpvsVSg0cxAI0uZlLNNh70F TelEfJ4yIXDWemPsOJMO/caAFJoFZFvBzj/feCmAOJubJpf6Fm+LbF/dYsGoOK1gnW3J5JGy7yp eD9Spcu+fUcQEGOorixiovBm/Y9vj3I1eAR0tSADQCtfTV2uwOaPt1Q1IY16N4kySifeKMnUy1Y zwZTHiepKFKkZunJW7ci8f2W+7/Pw0FSRAvGUJzLit9mxtGpUCjCALzL+NgVmMZbJdWygRcGE+ X-Received: by 2002:a05:6820:2214:b0:696:1450:ff14 with SMTP id 006d021491bc7-69697c64d5fmr2080725eaf.37.1777764781355; Sat, 02 May 2026 16:33:01 -0700 (PDT) Received: from [100.82.231.29] (c-98-38-17-99.hsd1.co.comcast.net. [98.38.17.99]) by smtp.googlemail.com with ESMTPSA id 006d021491bc7-69689266bacsm3903680eaf.0.2026.05.02.16.33.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 02 May 2026 16:33:00 -0700 (PDT) From: Jim Cromie Date: Sat, 02 May 2026 17:32:56 -0600 Subject: [PATCH 2/2] docs/dyndbg: explain flags parse 1st Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260502-dyndbg-doc-v1-2-67cc4a93a77e@gmail.com> References: <20260502-dyndbg-doc-v1-0-67cc4a93a77e@gmail.com> In-Reply-To: <20260502-dyndbg-doc-v1-0-67cc4a93a77e@gmail.com> To: Jonathan Corbet , Shuah Khan Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jim Cromie , Louis Chauvet X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1777764777; l=1814; i=jim.cromie@gmail.com; s=20260203; h=from:subject:message-id; bh=Ybb0kJKNd2BJDDcZYbhZbCACFsLVAC7m/M+jXCdbe+s=; b=82PT/0qK+IxUG7xZFy2Px1H5AYKU1VZLvQW1GDekkphj5WdtgmbUWsucxlXZRUtTqfXEQxSzU IllXXKz/VCVCsos2p3ojZ5om0cJraaitIAKqrJ4jiBA9I/ihe1aAUnG X-Developer-Key: i=jim.cromie@gmail.com; a=ed25519; pk=C6E5ODlPQo7ZBynATXH9wg7K6HxP0pIXyf4s38Qw0XE= 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 --- Documentation/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.54.0