From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dl1-f46.google.com (mail-dl1-f46.google.com [74.125.82.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 D80DB22301 for ; Sun, 28 Jun 2026 02:42:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.46 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782614575; cv=none; b=UWUjJpny2EANfIx8rNB5GR8b5BR17ZGnSEqO4Gbst1jsfRWDqsNik6Iikt5aKlPtURffBjQbbXDApQmzaV1ICUiNvg2rLGBPFDXL5F+zpaKnzRZW9650UfN9uFRW698gcOfqL1UptGbgc6/XiUWyp7vyhhHzXnnVVGBU/p+eLlA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782614575; c=relaxed/simple; bh=649Z0LbsZxt9v2GNFlMpGZV2z3so3LuGKY20y204+bg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=oUoMbwQD2nnYh/hGhrnJYyja1ilDuxpllIE4BnlqcPLLx59TIBYx016OlVt1RHoRTXjsEpto1tujsW86TNAqMaGJOxT9bL+ng99Fb8crwkM9zQPIT/OJ4ESW3T/DPoBEz+SHiFVvRyL8OkXg+U/IW3Hr+3CEkZs0uzQiETz1B24= 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=r7XMaYUB; arc=none smtp.client-ip=74.125.82.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="r7XMaYUB" Received: by mail-dl1-f46.google.com with SMTP id a92af1059eb24-13981833e13so2799864c88.1 for ; Sat, 27 Jun 2026 19:42:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1782614573; x=1783219373; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=V3DmUXHUqCj3jnRaIeaQ/+M0QNpEcXrql9n0NvrahhE=; b=r7XMaYUBi+igWACGYEOGtqXJ2+pwNxKdJqYoyiD8LV1AFE+NMmfCd4kqjtntVCTPND tAOD+Dek3XPmkYVYS8zzPou+JFSadrKX+2NEyqbl26moMVUv0Pbym0gxPlzI9n4EqD8C sXEkQ82zAf3Xj0PDFeK+XifPKC5cunM6iVFpwI3NUqE41ts0ih07zwADWuzvc3TYsTDz HL2T/xjiu+lCo9of9EGidX6rqhAfveSJPPhNfVXTwui1+fsiEsDfc0ymNG6SlzuH6iSl 1JFyH2Py2OQ4/Bc14TuWfCHvcbyGQIL12hRiPZ+TJ4iGFtU/Jz6yx1+Y52Jb4K7QQxbd WLaQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1782614573; x=1783219373; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=V3DmUXHUqCj3jnRaIeaQ/+M0QNpEcXrql9n0NvrahhE=; b=EUuIsezM5S0v5ZIfx+NTxGw9Po2bjZzf8nI4JonlnZNpENNdE0ADmPpFQYsGylS1eU OnWY2HxvX113HnzGl6UYsYWOWWPUgPCHFtWWSL//tv6QaaM3n0UNu9IKloK3ADt1FJD8 PPadfJUIF59vwPlzQjxGkRN0AyAWG1spO6SZmd3jiW/FE9TTov1MZJ2aROdC7D1s2Z9G ZXnldAFCsF/zustPum3E4XowsVQatmjI6nEn902g3pAe88vXmC0O2SgInOEO2WL7J95G LCombm9ai6HfBD5xVrC1VsV1lgWAyUb+u3RpRc7cbMMqFl/PW0B55BjGkh6XMvWqPfxh RZww== X-Forwarded-Encrypted: i=1; AFNElJ8h+J7dJa7ViNjSC2PE2N12t566tNZsOzSwrMdghLo1KnmO1X5LtpEJOvqsqJoqV213jZoppPxte56PUCo=@vger.kernel.org X-Gm-Message-State: AOJu0YzezQY9z9FkaphuHllJmljUe7Fb+h1GTR1tBaZSr4J6fOJ5RTvu 21D6YpMVnDCyKWYz3xPSWlybOBvACCFCSrPX2+4YEnhIgKb2WLYqiSBR X-Gm-Gg: AfdE7ckydJ+W6/sd2VvULK8qj0D4ML2w8UoXi1wcrZA7JzoDvBXXdx+g1jEQIMjCSXF 4k/GGpoZeNx3K8RchfpprevoovlpAdrWPa9tk/5G1UcnbpUki3gwq+c19uu/RGDh8ZnrK4/hRp7 du+sjTLtZMXpW4zUIO/pHZWwiilqGg60eLJ9jplgXW1E3NIFypoydp7c+0JBDWqDQx+KcnHtpGU XX6VRxuWJvnK53koOHDB1woDfdyd1DrvPCJ4yoXU5/tjJ2D2oIHEPughTv6QRORnAgb33Rd97Qp QoTtwgC9W8Zri18AqrnUpH5dX/ls/RSPNHrUas7ybmWnzjIhc1WxQQQurMI8vdQgYI2uiSWCsTO AG42sIiwkx6XDxzVxW2unXgmdJrvA/hOD4gcfOy1eKjuVU1q1DoGo42GONW7/5OhiBw+KOA2XkR hv2X3Vb/GtiUZcsFT8Tlbp X-Received: by 2002:a05:7022:6094:b0:132:ac76:9772 with SMTP id a92af1059eb24-139dbb329c9mr9918725c88.34.1782614572846; Sat, 27 Jun 2026 19:42:52 -0700 (PDT) Received: from RodriguezRyzen.. ([181.229.23.179]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-139d90e95c6sm47507970c88.11.2026.06.27.19.42.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 27 Jun 2026 19:42:52 -0700 (PDT) From: =?UTF-8?q?Iv=C3=A1n=20Ezequiel=20Rodriguez?= To: zfigura@codeweavers.com Cc: wine-devel@winehq.org, linux-kernel@vger.kernel.org, =?UTF-8?q?Iv=C3=A1n=20Ezequiel=20Rodriguez?= Subject: [PATCH 1/4] docs: ntsync: align uAPI ioctl names and struct layout with ntsync.h Date: Sat, 27 Jun 2026 23:42:36 -0300 Message-ID: <20260628024239.152852-2-ivanrwcm25@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260628024239.152852-1-ivanrwcm25@gmail.com> References: <20260628024239.152852-1-ivanrwcm25@gmail.com> 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: 8bit 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. Signed-off-by: Iván Ezequiel Rodriguez --- Documentation/userspace-api/ntsync.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/Documentation/userspace-api/ntsync.rst b/Documentation/userspace-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:: }; struct ntsync_event_args { - __u32 signaled; __u32 manual; + __u32 signaled; }; struct ntsync_wait_args { __u64 timeout; __u64 objs; __u32 count; - __u32 owner; __u32 index; - __u32 alert; __u32 flags; + __u32 owner; + __u32 alert; __u32 pad; }; @@ -152,7 +152,7 @@ The ioctls on the device file are as follows: The ioctls on the individual objects are as follows: -.. c:macro:: NTSYNC_IOC_SEM_POST +.. c:macro:: NTSYNC_IOC_SEM_RELEASE 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. -.. c:macro:: NTSYNC_IOC_SET_EVENT +.. c:macro:: NTSYNC_IOC_EVENT_SET 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. -.. c:macro:: NTSYNC_IOC_RESET_EVENT +.. c:macro:: NTSYNC_IOC_EVENT_RESET Designal an event object. Takes a pointer to a 32-bit integer, which on output contains the previous state of the event. -.. c:macro:: NTSYNC_IOC_PULSE_EVENT +.. c:macro:: NTSYNC_IOC_EVENT_PULSE 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. -.. c:macro:: NTSYNC_IOC_READ_SEM +.. c:macro:: NTSYNC_IOC_SEM_READ 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. -.. c:macro:: NTSYNC_IOC_READ_MUTEX +.. c:macro:: NTSYNC_IOC_MUTEX_READ 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. -.. c:macro:: NTSYNC_IOC_READ_EVENT +.. c:macro:: NTSYNC_IOC_EVENT_READ 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. -.. c:macro:: NTSYNC_IOC_KILL_OWNER +.. c:macro:: NTSYNC_IOC_MUTEX_KILL 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 -- 2.43.0