diff options
Diffstat (limited to 'Documentation/feature-removal-schedule.txt')
-rw-r--r-- | Documentation/feature-removal-schedule.txt | 50 |
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 | ||
100 | What: Video4Linux API 1 ioctls and from Video devices. | ||
101 | When: kernel 2.6.38 | ||
102 | Files: include/linux/videodev.h | ||
103 | Check: include/linux/videodev.h | ||
104 | Why: 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. | ||
115 | Who: Mauro Carvalho Chehab <mchehab@infradead.org> | ||
116 | |||
117 | --------------------------- | ||
118 | |||
119 | What: Video4Linux obsolete drivers using V4L1 API | 100 | What: Video4Linux obsolete drivers using V4L1 API |
120 | When: kernel 2.6.38 | 101 | When: kernel 2.6.39 |
121 | Files: drivers/staging/cpia/* drivers/staging/stradis/* | 102 | Files: drivers/staging/se401/* drivers/staging/usbvideo/* |
122 | Check: drivers/staging/cpia/cpia.c drivers/staging/stradis/stradis.c | 103 | Check: drivers/staging/se401/se401.c drivers/staging/usbvideo/usbvideo.c |
123 | Why: There are some drivers still using V4L1 API, despite all efforts we've done | 104 | Why: 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. |
111 | Who: Mauro Carvalho Chehab <mchehab@infradead.org> | ||
112 | |||
113 | --------------------------- | ||
114 | |||
115 | What: Video4Linux: Remove obsolete ioctl's | ||
116 | When: kernel 2.6.39 | ||
117 | Files: include/media/videodev2.h | ||
118 | Why: 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 | |||
130 | Who: Mauro Carvalho Chehab <mchehab@infradead.org> | 132 | Who: Mauro Carvalho Chehab <mchehab@infradead.org> |
131 | 133 | ||
132 | --------------------------- | 134 | --------------------------- |