summaryrefslogtreecommitdiff
path: root/include/uapi/linux/v4l2-subdev.h
diff options
context:
space:
mode:
authorLaurent Pinchart <laurent.pinchart@ideasonboard.com>2024-04-02 02:37:25 +0300
committerHans Verkuil <hverkuil-cisco@xs4all.nl>2024-04-29 15:56:36 +0300
commitc580efb94abed05f99bb80245abe96cf5d49128c (patch)
tree47174ee62a261f3b9b888b4766735b1cb63c0881 /include/uapi/linux/v4l2-subdev.h
parentcefc10d0d9164eb2f62e789b69dc658dc851eb58 (diff)
downloadlinux-c580efb94abed05f99bb80245abe96cf5d49128c.tar.xz
media: v4l2-subdev: Clearly document that the crop API won't be extended
The V4L2 subdev crop API has been marked as obsolete, deprecated by the selection API. Despite this, it has recently been extended with streams support. In hindsight this was a mistake. Make sure it doesn't happen again by clearly documenting that no new extensions will be accepted. Suggested-by: Hans Verkuil <hverkuil-cisco@xs4all.nl> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com> Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com> Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com> Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Diffstat (limited to 'include/uapi/linux/v4l2-subdev.h')
-rw-r--r--include/uapi/linux/v4l2-subdev.h4
1 files changed, 4 insertions, 0 deletions
diff --git a/include/uapi/linux/v4l2-subdev.h b/include/uapi/linux/v4l2-subdev.h
index 7048c51581c6..81a24bd38003 100644
--- a/include/uapi/linux/v4l2-subdev.h
+++ b/include/uapi/linux/v4l2-subdev.h
@@ -50,6 +50,10 @@ struct v4l2_subdev_format {
* @rect: pad crop rectangle boundaries
* @stream: stream number, defined in subdev routing
* @reserved: drivers and applications must zero this array
+ *
+ * The subdev crop API is an obsolete interface and may be removed in the
+ * future. It is superseded by the selection API. No new extensions to this
+ * structure will be accepted.
*/
struct v4l2_subdev_crop {
__u32 which;