[PATCH 0/7] docs/abi: align userspace documentation with implementation

Iván Ezequiel Rodriguez posted 7 patches 1 week, 2 days ago
Documentation/userspace-api/dma-buf-heaps.rst |  2 +-
Documentation/userspace-api/futex2.rst        |  4 +--
.../userspace-api/ioctl/ioctl-number.rst      |  5 +--
Documentation/userspace-api/vduse.rst         | 33 ++++++++++++-------
drivers/gpio/gpiolib-cdev.c                   |  2 ++
include/uapi/linux/gpio.h                     |  2 +-
security/landlock/syscalls.c                  |  2 +-
7 files changed, 31 insertions(+), 19 deletions(-)
[PATCH 0/7] docs/abi: align userspace documentation with implementation
Posted by Iván Ezequiel Rodriguez 1 week, 2 days ago
Documentation and ABI alignment fixes found on v7.3-rc1 by comparing
userspace-api docs, kernel-doc blocks, and uapi headers against the
current implementation.

Patches 1-6 are documentation only. Patch 7 makes GPIO v2 return
-EOPNOTSUPP when EVENT_CLOCK_HTE is requested but no HTE provider is
available, matching the documented behaviour.

No functional ABI changes are intended beyond the GPIO errno correction.

Iván Ezequiel Rodriguez (7):
  docs: futex2: fix documented errno names for futex_waitv
  docs: landlock: fix ENOMSG condition in create_ruleset kernel-doc
  docs: gpio: note lineinfo padding must be zero filled
  docs: dma-buf-heaps: fix CMA heap name typo
  docs: vduse: align documentation with current uapi and driver
  docs: ioctl: fix stale NVMe registry entry and note N conflict
  gpio: cdev: return EOPNOTSUPP when HTE is unavailable

 Documentation/userspace-api/dma-buf-heaps.rst |  2 +-
 Documentation/userspace-api/futex2.rst        |  4 +--
 .../userspace-api/ioctl/ioctl-number.rst      |  5 +--
 Documentation/userspace-api/vduse.rst         | 33 ++++++++++++-------
 drivers/gpio/gpiolib-cdev.c                   |  2 ++
 include/uapi/linux/gpio.h                     |  2 +-
 security/landlock/syscalls.c                  |  2 +-
 7 files changed, 31 insertions(+), 19 deletions(-)

-- 
2.43.0

Re: [PATCH 0/7] docs/abi: align userspace documentation with implementation
Posted by Bartosz Golaszewski 1 week, 1 day ago
On Mon, 31 Aug 2026 16:31:18 +0200, "Iván Ezequiel Rodriguez"
<ivanrwcm25@gmail.com> said:
> Documentation and ABI alignment fixes found on v7.3-rc1 by comparing
> userspace-api docs, kernel-doc blocks, and uapi headers against the
> current implementation.
>
> Patches 1-6 are documentation only. Patch 7 makes GPIO v2 return
> -EOPNOTSUPP when EVENT_CLOCK_HTE is requested but no HTE provider is
> available, matching the documented behaviour.
>

I suppose the separate series you sent after is the one I should be looking at?

Bartosz