]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
media: Documentation: Document -ENXIO for VIDIOC_SUBDEV_S_ROUTING
authorSakari Ailus <sakari.ailus@linux.intel.com>
Mon, 25 Aug 2025 07:52:54 +0000 (10:52 +0300)
committerHans Verkuil <hverkuil+cisco@kernel.org>
Wed, 14 Jan 2026 22:33:02 +0000 (23:33 +0100)
Document that -ENXIO is returned when the user tries to set a routing
configuration not supported by the hardware (or rather the driver). The
documentation details the exact cases of this, besides -EINVAL that is
already documented for VIDIOC_SUBDEV_S_ROUTING.

Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
Signed-off-by: Hans Verkuil <hverkuil+cisco@kernel.org>
Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst

index 1cf795480602067da8168887165c5545c6e79177..6f66ca38589e8d79ccc7bac9c87c240eb36b402e 100644 (file)
@@ -157,7 +157,14 @@ appropriately. The generic error codes are described at the
 EINVAL
    The sink or source pad identifiers reference a non-existing pad or reference
    pads of different types (ie. the sink_pad identifiers refers to a source
-   pad), or the ``which`` field has an unsupported value.
+   pad), the ``which`` field has an unsupported value, or, for
+   ``VIDIOC_SUBDEV_S_ROUTING``, the num_routes field set by the application is
+   larger than the len_routes field value.
+
+ENXIO
+   The application requested routes cannot be created or the state of
+   the specified routes cannot be modified. Only returned for
+   ``VIDIOC_SUBDEV_S_ROUTING``.
 
 E2BIG
    The application provided ``num_routes`` for ``VIDIOC_SUBDEV_S_ROUTING`` is