aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/feature-removal-schedule.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/feature-removal-schedule.txt')
-rw-r--r--Documentation/feature-removal-schedule.txt50
1 files changed, 26 insertions, 24 deletions
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
index 6c2f55e05f13..f2742e115b09 100644
--- a/Documentation/feature-removal-schedule.txt
+++ b/Documentation/feature-removal-schedule.txt
@@ -97,36 +97,38 @@ Who: Pavel Machek <pavel@ucw.cz>
97 97
98--------------------------- 98---------------------------
99 99
100What: Video4Linux API 1 ioctls and from Video devices.
101When: kernel 2.6.38
102Files: include/linux/videodev.h
103Check: include/linux/videodev.h
104Why: V4L1 AP1 was replaced by V4L2 API during migration from 2.4 to 2.6
105 series. The old API have lots of drawbacks and don't provide enough
106 means to work with all video and audio standards. The newer API is
107 already available on the main drivers and should be used instead.
108 Newer drivers should use v4l_compat_translate_ioctl function to handle
109 old calls, replacing to newer ones.
110 Decoder iocts are using internally to allow video drivers to
111 communicate with video decoders. This should also be improved to allow
112 V4L2 calls being translated into compatible internal ioctls.
113 Compatibility ioctls will be provided, for a while, via
114 v4l1-compat module.
115Who: Mauro Carvalho Chehab <mchehab@infradead.org>
116
117---------------------------
118
119What: Video4Linux obsolete drivers using V4L1 API 100What: Video4Linux obsolete drivers using V4L1 API
120When: kernel 2.6.38 101When: kernel 2.6.39
121Files: drivers/staging/cpia/* drivers/staging/stradis/* 102Files: drivers/staging/se401/* drivers/staging/usbvideo/*
122Check: drivers/staging/cpia/cpia.c drivers/staging/stradis/stradis.c 103Check: drivers/staging/se401/se401.c drivers/staging/usbvideo/usbvideo.c
123Why: There are some drivers still using V4L1 API, despite all efforts we've done 104Why: There are some drivers still using V4L1 API, despite all efforts we've done
124 to migrate. Those drivers are for obsolete hardware that the old maintainer 105 to migrate. Those drivers are for obsolete hardware that the old maintainer
125 didn't care (or not have the hardware anymore), and that no other developer 106 didn't care (or not have the hardware anymore), and that no other developer
126 could find any hardware to buy. They probably have no practical usage today, 107 could find any hardware to buy. They probably have no practical usage today,
127 and people with such old hardware could probably keep using an older version 108 and people with such old hardware could probably keep using an older version
128 of the kernel. Those drivers will be moved to staging on 2.6.37 and, if nobody 109 of the kernel. Those drivers will be moved to staging on 2.6.38 and, if nobody
129 care enough to port and test them with V4L2 API, they'll be removed on 2.6.38. 110 cares enough to port and test them with V4L2 API, they'll be removed on 2.6.39.
111Who: Mauro Carvalho Chehab <mchehab@infradead.org>
112
113---------------------------
114
115What: Video4Linux: Remove obsolete ioctl's
116When: kernel 2.6.39
117Files: include/media/videodev2.h
118Why: Some ioctl's were defined wrong on 2.6.2 and 2.6.6, using the wrong
119 type of R/W arguments. They were fixed, but the old ioctl names are
120 still there, maintained to avoid breaking binary compatibility:
121 #define VIDIOC_OVERLAY_OLD _IOWR('V', 14, int)
122 #define VIDIOC_S_PARM_OLD _IOW('V', 22, struct v4l2_streamparm)
123 #define VIDIOC_S_CTRL_OLD _IOW('V', 28, struct v4l2_control)
124 #define VIDIOC_G_AUDIO_OLD _IOWR('V', 33, struct v4l2_audio)
125 #define VIDIOC_G_AUDOUT_OLD _IOWR('V', 49, struct v4l2_audioout)
126 #define VIDIOC_CROPCAP_OLD _IOR('V', 58, struct v4l2_cropcap)
127 There's no sense on preserving those forever, as it is very doubtful
128 that someone would try to use a such old binary with a modern kernel.
129 Removing them will allow us to remove some magic done at the V4L ioctl
130 handler.
131
130Who: Mauro Carvalho Chehab <mchehab@infradead.org> 132Who: Mauro Carvalho Chehab <mchehab@infradead.org>
131 133
132--------------------------- 134---------------------------