From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f46.google.com (mail-wm1-f46.google.com [209.85.128.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 8D981235BE2 for ; Sun, 15 Mar 2026 15:35:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.46 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773588929; cv=none; b=LtLtcJTeqIwcGvGg/s2J0NO0mP0JJ1kPvRJtGTXts/4ouvT6XJavX/RHjywdHVyrLob/DuAAqR/0fV5lFPVMwJTIR58cR+Nae3EKP1OslYuFVCWnwfTobyYA7alxvys/EMzAKGv7UfETbb4RsnMntdIihEGF93wpfXJw2y/KLx0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773588929; c=relaxed/simple; bh=bhTBH90iuw3Zz/KJiqL5c+PungKsiGSxg038h+DOwqg=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=mX+4AKClYRxc9gDJsKofrgqbo1JWZueP/fy1O4BuNbYYoIiYmYx0Qfr4frgQdwjbw/pksj6ROKSvKJuHns7tk/JoiFxh4G5m61YWDcxzMhQv1d4Muo5BHtnIvDd9rtq7rBq6Z9ySwukU3iBzMpx0n7uMzog4j1HruVcr6l4OxPU= 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=WXl8/Kk6; arc=none smtp.client-ip=209.85.128.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="WXl8/Kk6" Received: by mail-wm1-f46.google.com with SMTP id 5b1f17b1804b1-4852b81c73aso33112385e9.3 for ; Sun, 15 Mar 2026 08:35:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773588927; x=1774193727; 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=i9xwjqIYz840GC499p7R2pPSK4rtVCBgO6U0XZNZcMw=; b=WXl8/Kk68YCnpjhDtjiN/bYN4L7SDWL9K4Fs4mB3MusAJuruRg3VtuRpV8MJ4nua5b AYcbIgsODosGckK/u65PVofjfkzL77ijQWnIQa7n54NN/YvsaBNCgkOEED/kquox9jMX Pihp5FBUV8fblWWLQdIM1ThNKr9N19O4kDJAua9hhXbQXZaL2ee9+456kvLAMYdRB5Ha fZlBwFykRPWgWZOv0ralf6Ta5tT8GoqmzC41pFtBUq7Vp6yFqqQFSd4MAxXirQFaVLls UHxCJ8/wQ+NY0rNS/eIBUsXMUc/JadUadECYHJyiDADpTiFW4bClPr1vIeBSuFJ0c5/p wnQQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773588927; x=1774193727; 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=i9xwjqIYz840GC499p7R2pPSK4rtVCBgO6U0XZNZcMw=; b=WU2UoSfDuekbe2pn3UEF/JOpS5B/kWC6DhBiTKAuOcIfWtNPtgQlZwu2kJ4bHGy5kR EmZV5Qnoa9hJ4eCLzrA6u81BCNZfsOsstx11H3BH3IeZVCxALK74Y8uM18GHVpRx0oV7 fvu3HlHzpuiYnLLtLnADTVXE7QPAjqacXksqdEbQ6V9eYQkdzTNtOk3tQb7nZfhyVfb7 tyOPvKU6BG6sNXyu7oyfQ5D1M41cTGs2hu8jb1LTuO5agVmQ/eg+HWTKPpg3FmhEHMej mjMQaT5TqmWlf8CFcIZRhRK7BD3mqaMSEicOvizNJo/6OGIgEuOryx4DIuO2XK8CAnKs qQTQ== X-Gm-Message-State: AOJu0Yy7BSvGDpBnVCQn5+94lDXhgqp5+mUlHYqb/eXciuMwd7KsGq+b CEvkt7HbnlNZSqU/vZFEcRJ5cXwROzOOpMikpp+fWl6soZ6Asdq3n03IzyAhS9Oji/s= X-Gm-Gg: ATEYQzzgcLihvgyUYF1MTN7V0Mz7T0tGqaQuSHxxXflQNQHx9+JWsMQURcpud7CtHXa JT4asSEyAYYxpRtkOj5uuMXaKFgmGA1gVqD3XF6CTjDsp45GdC0NVDGEOTigrmFCT3VGljkLCiM l0d8QMhFIwHZEQnwItg4BzEpDUd8n/3uhetwD1V3mNnlIFiOZiVfUvn0wnR+n1u2DaKBsBZK7oS K0ReDrmIlFK/Y/y2jCq9uzF/fyWlbOePIFu0Vn3sPiLUUupe8vH/wu4LaSAlkcYuRGOqEm4q7Gf zdiQQYKuduzC+7Zf+zGVS+IR2A4qEbN7djGo8OHd7yeo/MhuC+RsthK3OXoLAnsntENsgMjQAx1 O01IqBqQTPUil/m4xYhM3wTweVN9x76zw1iQMLMYh9nU2MDJEM0SYfokOI8FEoqxIzjnPz+lShy 6LZX2XfPruL+7OsBVWCy+SmCWia6itLVIeXnyKQK5WzP/tpeqPmonCRJKgfUK97lLKMlo7Z6o1h CZE1skCjuLN8G+Zg3vP4xd8tyuzaQ== X-Received: by 2002:a05:600c:4689:b0:482:e5d4:b7ca with SMTP id 5b1f17b1804b1-485566d6e49mr162998235e9.8.1773588926721; Sun, 15 Mar 2026 08:35:26 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-485696a12d0sm2200685e9.13.2026.03.15.08.35.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 08:35:25 -0700 (PDT) From: Kit Dallege To: Thomas Gleixner , Peter Zijlstra , Andy Lutomirski Cc: linux-kernel@vger.kernel.org, Kit Dallege , Claude Subject: [PATCH 7/9] entry: add missing kernel-doc for arch_ptrace_report_syscall functions Date: Sun, 15 Mar 2026 16:35:14 +0100 Message-ID: <20260315153514.48632-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: 8bit 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 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 @@ /** * 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) /** * arch_ptrace_report_syscall_exit - Architecture specific ptrace_report_syscall_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 -- 2.53.0