From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from fout-a3-smtp.messagingengine.com (fout-a3-smtp.messagingengine.com [103.168.172.146]) (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 BA60036C5B4 for ; Wed, 1 Jul 2026 16:37:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.146 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782923859; cv=none; b=N0Fjho3Yojc1nxHdGFve4AisDwGY8vLmU4YrPrg85kzuCNNt65BVqmGKbShTjnpSDcPn65oO0vGe23zoOCRsjGMaC5YFUbnQQW9I4doMSbkuBajPu+3SPNxQszFsnqcFSXp8x1q+U5/3K1g3SXXT2UdqHXL/M9f50OGDIne5B0o= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782923859; c=relaxed/simple; bh=H+NKQQinLuAjEHbcpvnhVykzr8XtvQy+cvanAd8BG00=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=qy4JzysccSsigqZpu4QWOrQ+TJfqieT2NnJW3Tc/UM5+0k9+1PnVJbGNp5HgM7r8O5tTQp1x8FSZp+ZSEhf5E3AetNxpjAgAd8k1KchbxvFbJ4rdLAqRon0OUrJl8qv9ok2Hrs99KQp+0SUGUV+5o/70ysJGFOBo/xjOwk9L0LE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=codeweavers.com; spf=pass smtp.mailfrom=codeweavers.com; dkim=pass (2048-bit key) header.d=codeweavers.com header.i=@codeweavers.com header.b=bfxpfIJl; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=ZttfWJKu; arc=none smtp.client-ip=103.168.172.146 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=codeweavers.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=codeweavers.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=codeweavers.com header.i=@codeweavers.com header.b="bfxpfIJl"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="ZttfWJKu" Received: from phl-compute-05.internal (phl-compute-05.internal [10.202.2.45]) by mailfout.phl.internal (Postfix) with ESMTP id 028FCEC00FB; Wed, 1 Jul 2026 12:37:37 -0400 (EDT) Received: from phl-frontend-03 ([10.202.2.162]) by phl-compute-05.internal (MEProxy); Wed, 01 Jul 2026 12:37:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=codeweavers.com; h=cc:cc:content-transfer-encoding:content-type:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:subject:subject:to:to; s=fm3; t=1782923856; x=1783010256; bh=fo2MkhcnhcGfeRnryBWlc4Hyma8oRvTh mwN55w80m+4=; b=bfxpfIJlfZGuOlBFplTCyICpKsXlnO6BrAUXgaOOvv2krth5 Q10JxGSG6gFEKxw5Aywsq3o9T/soZn6Oo+utdggGht4QgVzF6C9U5ySSJLRYGE1J F0R9+cf/XAt73Hf7X/xV0fgmrDJsdRq3bYFH7aCQfOi7nwiCKp8Oi3MNjkhuG+RJ 5hyuqRCI66QSZyL3Xj3OO6h+1NG3m5SebNq+MD4ovUDco5jftRDAdf4y2WhUxBVU ezLQG1FSB7qG5XT9/X7rxcoJHRh0c8Y+LBOBLyrQ9OCnna/v1HMc4AOeYnsoV3e7 a3oQTFvcd0zj4ll5Z+B7LHKhoQT8rGv4A1tUog== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1782923856; x= 1783010256; bh=fo2MkhcnhcGfeRnryBWlc4Hyma8oRvThmwN55w80m+4=; b=Z ttfWJKu/LAMn39TZ+gzMJLFME8dsPU5nnN1g3vLOZGUrbKFzs6zSXpKtTJkI2yay Be+FsKay4lzGvGm8z1YbWD+upqsclEyIHnJ046K1S2F+OyKala11XfSv4yqc/V0W B2EwauyT10Um96zdevzLf2ihB/z4Qdr6scdtO5yko3iVFjkdmnq4W4CAb+K4m8ih FJHkfcfB1wxirrISyRLfmtRW+88Z2QgOdF5f0dMqcsmkTY/GntVlnzhojKF857Bx 8jwlOt7MsLfDQ8zKdYHWD+rKSD/l8Sb6IlsHGy1IN1do4/kNLc3np0s8goH8KRWt PfYqR2MWXd3516w7SN2Ug== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTGrA53hEdGvMlzGjB8kDwHh2Dc1XwC7W48LFIeWXiCt65G+kIHaec3+OVQen+LDgj R/0JHMA/QI3YlGw7jsr2ZJsqGV5gJmsC52lomENS64ZxNzGYaZwZMJruCTqVwVBpZjaZ5/ mAr0t/kRhzK0i/JVKghW0ejuhPC9NnsN2gutr/D1LUhXOCqK5mu9BIpHd3Ozj/D8RlfEeu Xv1lq1I2q58Yp7aaCZkmB5mfvEM0zR977f7nfOX0M8NymohfSpHz+Ga54fhCi9fbr4Z+Xs C6c/2AMrEHt4d+8A7GbASygCr2aRm9VUwi0izRbqckRQ6ZQ/VhBdjJ6clE7QsdMFPceIKM /nAnFBwlfNmG0bmJs1OMuUFCI7Xuvrdrji8I0FVMgZJUmXr24bA7Ecd9ldA9+8mK8VoH62 GdEJAjJB+vgcbRle4f38Sn2dhmmvEcj7XZUzDTY6OT4l4YVpAzPeYi9TmP287r0VMyxP09 FaNlSnPd4bjlOoXYiF5KnxVR/2xqObN4u3OTjnd016fZy91YqAjGohiQVUQpSHIfoLVNDa djWBVYex32L7BMfCbyvZANn70HWBVx+GNZpke4w8/8wJnMRjsJxLr5HkGBsQGubvgHFEc6 pOdgRCm/zoGRjlYlC4KmEwQlUFKid24twnIq2kEZkEVtRxr8Tu31uhMT0cww X-ME-Proxy: Feedback-ID: i01ae4b70:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 1 Jul 2026 12:37:36 -0400 (EDT) From: Elizabeth Figura To: =?UTF-8?B?SXbDoW4=?= Ezequiel Rodriguez Cc: wine-devel@winehq.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 1/4] docs: ntsync: align uAPI ioctl names and struct layout with ntsync.h Date: Wed, 01 Jul 2026 11:37:36 -0500 Message-ID: <12921830.O9o76ZdvQC@camazotz> In-Reply-To: <20260628024239.152852-2-ivanrwcm25@gmail.com> References: <20260628024239.152852-1-ivanrwcm25@gmail.com> <20260628024239.152852-2-ivanrwcm25@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" On Saturday, 27 June 2026 21:42:36 CDT Iv=C3=A1n Ezequiel Rodriguez wrote: > The userspace-api reference used stale macro names (SEM_POST, SET_EVENT, > READ_*, KILL_OWNER) and struct field order that did not match > include/uapi/linux/ntsync.h. Update the documentation to match the > published uapi so Wine and other consumers grep the correct symbols. >=20 > Signed-off-by: Iv=C3=A1n Ezequiel Rodriguez > --- > Documentation/userspace-api/ntsync.rst | 22 +++++++++++----------- > 1 file changed, 11 insertions(+), 11 deletions(-) >=20 > diff --git a/Documentation/userspace-api/ntsync.rst b/Documentation/users= pace-api/ntsync.rst > index 25e7c4aef968..535585331380 100644 > --- a/Documentation/userspace-api/ntsync.rst > +++ b/Documentation/userspace-api/ntsync.rst > @@ -83,18 +83,18 @@ structures used in ioctl calls:: > }; > =20 > struct ntsync_event_args { > - __u32 signaled; > __u32 manual; > + __u32 signaled; > }; > =20 > struct ntsync_wait_args { > __u64 timeout; > __u64 objs; > __u32 count; > - __u32 owner; > __u32 index; > - __u32 alert; > __u32 flags; > + __u32 owner; > + __u32 alert; > __u32 pad; > }; > =20 > @@ -152,7 +152,7 @@ The ioctls on the device file are as follows: > =20 > The ioctls on the individual objects are as follows: > =20 > -.. c:macro:: NTSYNC_IOC_SEM_POST > +.. c:macro:: NTSYNC_IOC_SEM_RELEASE > =20 > Post to a semaphore object. Takes a pointer to a 32-bit integer, > which on input holds the count to be added to the semaphore, and on > @@ -186,7 +186,7 @@ The ioctls on the individual objects are as follows: > unowned and signaled, and eligible threads waiting on it will be > woken as appropriate. > =20 > -.. c:macro:: NTSYNC_IOC_SET_EVENT > +.. c:macro:: NTSYNC_IOC_EVENT_SET > =20 > Signal an event object. Takes a pointer to a 32-bit integer, which on > output contains the previous state of the event. > @@ -194,12 +194,12 @@ The ioctls on the individual objects are as follows: > Eligible threads will be woken, and auto-reset events will be > designaled appropriately. > =20 > -.. c:macro:: NTSYNC_IOC_RESET_EVENT > +.. c:macro:: NTSYNC_IOC_EVENT_RESET > =20 > Designal an event object. Takes a pointer to a 32-bit integer, which > on output contains the previous state of the event. > =20 > -.. c:macro:: NTSYNC_IOC_PULSE_EVENT > +.. c:macro:: NTSYNC_IOC_EVENT_PULSE > =20 > Wake threads waiting on an event object while leaving it in an > unsignaled state. Takes a pointer to a 32-bit integer, which on > @@ -213,7 +213,7 @@ The ioctls on the individual objects are as follows: > afterwards, and a simultaneous read operation will always report the > event as unsignaled. > =20 > -.. c:macro:: NTSYNC_IOC_READ_SEM > +.. c:macro:: NTSYNC_IOC_SEM_READ > =20 > Read the current state of a semaphore object. Takes a pointer to > struct :c:type:`ntsync_sem_args`, which is used as follows: > @@ -225,7 +225,7 @@ The ioctls on the individual objects are as follows: > * - ``max`` > - On output, contains the maximum count of the semaphore. > =20 > -.. c:macro:: NTSYNC_IOC_READ_MUTEX > +.. c:macro:: NTSYNC_IOC_MUTEX_READ > =20 > Read the current state of a mutex object. Takes a pointer to struct > :c:type:`ntsync_mutex_args`, which is used as follows: > @@ -242,7 +242,7 @@ The ioctls on the individual objects are as follows: > ``EOWNERDEAD``. In this case, ``count`` and ``owner`` are set to > zero. > =20 > -.. c:macro:: NTSYNC_IOC_READ_EVENT > +.. c:macro:: NTSYNC_IOC_EVENT_READ > =20 > Read the current state of an event object. Takes a pointer to struct > :c:type:`ntsync_event_args`, which is used as follows: > @@ -255,7 +255,7 @@ The ioctls on the individual objects are as follows: > - On output, contains 1 if the event is a manual-reset event, > and 0 otherwise. > =20 > -.. c:macro:: NTSYNC_IOC_KILL_OWNER > +.. c:macro:: NTSYNC_IOC_MUTEX_KILL > =20 > Mark a mutex as unowned and abandoned if it is owned by the given > owner. Takes an input-only pointer to a 32-bit integer denoting the >=20 Reviewed-by: Elizabeth Figura =2D- This was already sent as , which was never applied, although that did not i= nclude modifications to the struct field order.