From nobody Tue Apr 7 05:42:46 2026 Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) (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 C5227219A7A for ; Sun, 15 Mar 2026 17:09:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773594595; cv=none; b=NyesWKUK+rN92Xr/gPFiOJOxVQy0RfU3KKpvqMQYfYryulSuX7GdTKxco6ofC51q9ApnFOHagY2aDhrAyZeFT79OBMH2ghYeFbrtrobeVeALsITgyYQ+aOUsqWFKiZRTfiGmN8CAxnqricAkYzINfk+m5bUwG62XhXsV9W+scCY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773594595; c=relaxed/simple; bh=Y+ciYqgEYuUULxirfStjE29sDt56qCT9YdTIFI5A4Go=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=CLhvkqbQZS4imC9dEFnyD9jw8Km6nwIQqElO5klPNClJuyRh7aVNd58ZzmJdtHB8QkHrFV20o4vsEB1MUz1sKRpJY7O1whryuFYE6PxTZE9jqFucJ9MBJxnTpti/JOzUFGeqvwPZOsn2R9eSa5CqtgrkDFxL6/MtYyubZEKschg= 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=SIThIrRq; arc=none smtp.client-ip=209.85.128.48 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="SIThIrRq" Received: by mail-wm1-f48.google.com with SMTP id 5b1f17b1804b1-48558d6ef83so21500655e9.3 for ; Sun, 15 Mar 2026 10:09:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773594592; x=1774199392; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=md4e0GadqQLkeX4dUWT8I9t05U3Dl91Ii1kEk9RuTbs=; b=SIThIrRqPnKy2Q9gbfyEeGQE2hnWnv2zs7ocHI4Lv/rj85Qqpk6Z7Aeteo2n7Wmomm IA9glac8NJLLPnVVPRXwXWB9ihxzedHhw2onIj/n57P8zropkd88WGY9uh6rZmFLc0GK jxmI1uYM9Zbb2JU+f9UsNnYQXQhCLMvRdkLRHg+RIlhn80AF8/dX4+NMPXwhT491z4p0 V3AvXcDYsCDRPWzxe14baurjvtAqTWxbj2P5ttzEplyTmkCMZgRejghAdvg/DcoRlkF3 rpe/G1XrrJAMdbLo9Z9JzFrkeRWejgCmcc+eKcvpV37cSeGL9EBILXwEQJ0KzBsCqdDl 6o5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773594592; x=1774199392; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=md4e0GadqQLkeX4dUWT8I9t05U3Dl91Ii1kEk9RuTbs=; b=Rjli3jDzf0zjE4K/pIEcnwWIdzm/PIUi9lan9pTsNsOvunRufSiQDsD9jCsR5IVdLI Pl6n/5a6Fd6AJYgxl4CUXupLG5mADQtI26U1CnoZzLPtA/tlGG4VNh+S3CpKEop7RDXH lUqcrRTx58hpRgsoMWtNORCihcieLQdobot8E795UEAtM0Uh3uzHr45MrSv7K0S30Dvo /kL1czxP5KKtxa+MGmvRKbria5J0oA7De9GRp1Z4Di7qdfazGEiLnQOaG4wAbwZtC+N7 Nc2fMWv2bCWBIEpeT8aVNQIoXmNJmMXDPb4iggBea6I8hmcUvyScIhdmLLfo2W9pJuac vZ/g== X-Gm-Message-State: AOJu0YyCWKFNxVk2LYBiHyE26qbZD1ThYFWOX63aFxMrefAGPyVVElCi DVXimFBCgDkvMTL/iT4WePiXBoRz6qhIoXtYh6siVsKHSv7BQ9j+w5VM X-Gm-Gg: ATEYQzwEn4eYmGAaIL2kioHCUGvXmgjGyUxWR8Ozm0yjLeG+dj0LhuLCM3Nuz5DTcwF thPiI0jxrUpSspHTAgXq4vkW4RyP7nGnivoKwwtX3iraQQQ4AXSNepht1sP4NyrivfNKbgiC3s7 iKBTj86usUyvZl/xahjcPzfRSjUdPUUZ68M3we8aJcfnP5vFZCq0b5lnF3TMnbbWWz1mo7CFqJb u3DRXWdGLLn7hOmDOMooHXVGRBljw0CuqkN1FijKlP+aXcZVcB+I9KWoHXnTupC551V+OAyaXh6 0oDWd8022v/DAduVJW6r1EB/YjfUpjhyF5X891PVnd/gLJ7S/Oh2MhbZhwfzpGWC6Wu1tOWY+Vb oOFLMpModzA1TFfTr/K2h3smEqHpVyDmBXCURbafSUsd0wzULlKs9yJ/gOFdQyCo/XmH0sFxcwp x9Xc+tevkam7mqEkkZw9dqPbxw8Qe/RqsEC3ywn9aOdDKZDSr72bh6xU/tn2S2Dw0qUO5EQ7bYh i6xSr5ut85uG639iRXDx5lX83eywYQ4YwSbkk4j X-Received: by 2002:a05:600c:1388:b0:483:badb:618f with SMTP id 5b1f17b1804b1-485567050dcmr169006755e9.25.1773594592132; Sun, 15 Mar 2026 10:09:52 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4854b66dedfsm371152895e9.12.2026.03.15.10.09.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 10:09:51 -0700 (PDT) From: Kit Dallege To: Thomas Gleixner , Peter Zijlstra , Andy Lutomirski Cc: linux-kernel@vger.kernel.org Subject: [PATCH v2] entry: add missing kernel-doc for arch_ptrace_report_syscall functions Date: Sun, 15 Mar 2026 18:09:41 +0100 Message-ID: <20260315170941.65913-1-xaum.io@gmail.com> X-Mailer: git-send-email 2.53.0 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" Document the @regs and @step parameters for arch_ptrace_report_syscall_entry() and arch_ptrace_report_syscall_exit() that were missing from the kernel-doc comments. Assisted-by: Claude:claude-opus-4-6 Signed-off-by: Kit Dallege --- include/linux/entry-common.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/include/linux/entry-common.h b/include/linux/entry-common.h index f83ca0abf2cd..e8334a7939a8 100644 --- a/include/linux/entry-common.h +++ b/include/linux/entry-common.h @@ -48,6 +48,7 @@ =20 /** * arch_ptrace_report_syscall_entry - Architecture specific ptrace_report_= syscall_entry() wrapper + * @regs: pointer to the register state at syscall entry * * Invoked from syscall_trace_enter() to wrap ptrace_report_syscall_entry(= ). * @@ -205,6 +206,8 @@ static __always_inline bool report_single_step(unsigned= long work) =20 /** * arch_ptrace_report_syscall_exit - Architecture specific ptrace_report_s= yscall_exit() + * @regs: pointer to the register state at syscall exit + * @step: indicates a single-step exit rather than a normal syscall exit * * This allows architecture specific ptrace_report_syscall_exit() * implementations. If not defined by the architecture this falls back to --=20 2.53.0