From nobody Mon Jun 15 09:42:01 2026 Received: from mo4-p01-ob.smtp.rzone.de (mo4-p01-ob.smtp.rzone.de [81.169.146.165]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C73F2376497 for ; Fri, 22 May 2026 19:11:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=pass smtp.client-ip=81.169.146.165 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779477104; cv=pass; b=E4F5pcARqnHCuf0nmTnStu7kqSJNB+PmfjB5nzdIkwaqaOrUMYeXySnnSUrxY2pfPRcHFjtw752txHdt73eaV1SZ+2+WU4xJDPHB9hg7zyvOMuQj/7nfz0GlFr6sTgR3buRotbcoukH9WtbJZpwxOQd+mjhj8KlybRtHc2N5uf4= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779477104; c=relaxed/simple; bh=tiQEAZ6DRaVBut0g9CS6HOJ0zZNZjkQ2gFvWmg9pPjA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=mqel8BvRk2t/mHPNyviXx4TrDt6wvPCafItGBQak0ABEqIA/OS7oCUUI0F57PI5tIPDiXELC9Jh3CgVDIsFHrjsFhXLBxrx2vAIbX7c3h4MGUEy+SwD0AYNq1UCO47tJcRObfHHigxXLa5+j3HuvxLdLld8XShNFMJBHnkBi3ls= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=lechthaler.online; spf=none smtp.mailfrom=lechthaler.online; dkim=pass (2048-bit key) header.d=lechthaler.online header.i=@lechthaler.online header.b=e4QE5H7h; dkim=permerror (0-bit key) header.d=lechthaler.online header.i=@lechthaler.online header.b=R59sDssF; arc=pass smtp.client-ip=81.169.146.165 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=lechthaler.online Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=lechthaler.online Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lechthaler.online header.i=@lechthaler.online header.b="e4QE5H7h"; dkim=permerror (0-bit key) header.d=lechthaler.online header.i=@lechthaler.online header.b="R59sDssF" ARC-Seal: i=1; a=rsa-sha256; t=1779476729; cv=none; d=strato.com; s=strato-dkim-0002; b=WcewO/hnb3cgPZjAvb1W2Y+WSN77G/J8S3hEt8C+T4d3sSIgoqr9REk4jI5S0e3ZYA mWAUZnIuQq1tiw9qmfpuW5n+aF/paOir0OYTNh4x6321ia2aGAhkeaLdTlHKiAcFdtI3 fXh5tIv/uC6HslAZyVrojJnjW4BqDVrdTRDUhQU5Aq0TZZvGWcIwq8SfI9GqpCbok6ls QRIf/FbudsBr8L7Jgk4g5ISAUoIfvbNdFKHX6dDHqav2u0NimNoLGT4CIkKOtZ4BECHQ 0j8tHAB/v62Rl43vKOpzNeHELRm9RjEzqeg50RdMVI/71Rza8nCFkQGWK6wwnj9oB5UG HGJQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; t=1779476729; s=strato-dkim-0002; d=strato.com; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=oeyWmWn1ru/XuRM4KLzmx7kQAMCTBl/K/MfFP9wGqvI=; b=MuMBgHMjQvY2Lrft6QlRqopHatJrep6oix2fPqgiBnQ0IUSkmnxsUsEvV09V/GX9HQ PhPzPsoo4aPaxi0RPp3uk8kWmEB/DGBTRjcSPiIuAcCoNy4Z1jTogK6IUi0AWA6g/f98 EQXCo3sMvdnXnVQL53FyVww3d27ayIzRGToJxmHmz7qYSAVkN4TnWoPqzf2P8e06QEuq WGKQcI4w7udrb8nTn8rZzZBPv5rdAZziZ8Tbfbm37Q5k83Jjho/PW+bTeXN6FOnk5qmW sgtK5WkFPb2W7gdio37gEyM29D283UVfSFDmXqm2VYuoDvWZA8DWsQRg2TCFc3hvgKSM +rUg== ARC-Authentication-Results: i=1; strato.com; arc=none; dkim=none X-RZG-CLASS-ID: mo01 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1779476729; s=strato-dkim-0002; d=lechthaler.online; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=oeyWmWn1ru/XuRM4KLzmx7kQAMCTBl/K/MfFP9wGqvI=; b=e4QE5H7h8jPx/kLV6SM+S9NkCR21xSt48m5b2SQkxhhnm5DU1WDVOKyFrLqnGkptUr GPJPY6HnU7QhuN7GqyN+kKVcp6DGAT1MkqGHnheucK9GUtvr295rL7dRCJ7XPD3Icm5K +S2ECF1HGLgPTUJYd5l2KI3Toe/TE8m5muuSIxRPO7MjwGPGxJ2W1WIgVL9WIpn/vch/ QZg7NTFHNFEoW2YyWNtBZd3KSK4lDEON4xkCPlcd0dqgaGd8j3bCLRCa7ytKip+cbXKo wD9OvJvPz0mXHmtXsyqxCorHWqDobJJHfzeBS3efPu8P98KYecrlKpQQ0or8QB7MRPHu qLHg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; t=1779476729; s=strato-dkim-0003; d=lechthaler.online; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=oeyWmWn1ru/XuRM4KLzmx7kQAMCTBl/K/MfFP9wGqvI=; b=R59sDssFtUxJoBTaoEN8i2tgotOj34FcIkLUwPSGj+UYQravk/a9xue991p/pbIfM6 Z7AKFwRCvow3KZQcFdCw== X-RZG-AUTH: ":LWABbUGmf/p3GWz138t3dAG4+iFy9XUTxnN94F8mUwTghZauya1bHdwWZANyhT7JUoBGg72fwp4OIxY=" Received: from alex-e16.. by smtp.strato.de (RZmta 55.0.1 AUTH) with ESMTPSA id j78f5a24MJ5SPvF (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits)) (Client did not present a certificate); Fri, 22 May 2026 21:05:28 +0200 (CEST) From: Alexander Lechthaler To: arnd@arndb.de, david@kernel.org, ljs@kernel.org Cc: linux-kernel@vger.kernel.org, Alexander Lechthaler Subject: [PATCH] ipc/sem: fix malformed kernel-doc comment Date: Fri, 22 May 2026 21:05:07 +0200 Message-ID: <20260522190507.97175-1-alexander@lechthaler.online> X-Mailer: git-send-email 2.43.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" perform_atomic_semop[_slow]() uses unsupported kernel-doc syntax, triggering a warning: This comment starts with '/**', but isn't a kernel-doc comment Split the shared comment into separate kernel-doc blocks for perform_atomic_semop() and perform_atomic_semop_slow(). No functional change. Signed-off-by: Alexander Lechthaler Acked-by: Lorenzo Stoakes --- ipc/sem.c | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/ipc/sem.c b/ipc/sem.c index 6cdf862b1f5c..fde2bcc225dc 100644 --- a/ipc/sem.c +++ b/ipc/sem.c @@ -627,8 +627,8 @@ SYSCALL_DEFINE3(semget, key_t, key, int, nsems, int, se= mflg) } =20 /** - * perform_atomic_semop[_slow] - Attempt to perform semaphore - * operations on a given array. + * perform_atomic_semop_slow - Attempt to perform semaphore + * operations on a given array. * @sma: semaphore array * @q: struct sem_queue that describes the operation * @@ -716,6 +716,23 @@ static int perform_atomic_semop_slow(struct sem_array = *sma, struct sem_queue *q) return result; } =20 +/** + * perform_atomic_semop - Attempt to perform semaphore + * operations on a given array. + * @sma: semaphore array + * @q: struct sem_queue that describes the operation + * + * Caller blocking are as follows, based the value + * indicated by the semaphore operation (sem_op): + * + * (1) >0 never blocks. + * (2) 0 (wait-for-zero operation): semval is non-zero. + * (3) <0 attempting to decrement semval to a value smaller than zero. + * + * Returns 0 if the operation was possible. + * Returns 1 if the operation is impossible, the caller must sleep. + * Returns <0 for error codes. + */ static int perform_atomic_semop(struct sem_array *sma, struct sem_queue *q) { int result, sem_op, nsops; --=20 2.43.0