Merge branch 'x86-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[cris-mirror.git] / drivers / media / v4l2-core / v4l2-ioctl.c
blob260288ca4f551c0a868ff5b679aa192af91dd431
1 /*
2 * Video capture interface for Linux version 2
4 * A generic framework to process V4L2 ioctl commands.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
11 * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1)
12 * Mauro Carvalho Chehab <mchehab@infradead.org> (version 2)
15 #include <linux/mm.h>
16 #include <linux/module.h>
17 #include <linux/slab.h>
18 #include <linux/types.h>
19 #include <linux/kernel.h>
20 #include <linux/version.h>
22 #include <linux/videodev2.h>
24 #include <media/v4l2-common.h>
25 #include <media/v4l2-ioctl.h>
26 #include <media/v4l2-ctrls.h>
27 #include <media/v4l2-fh.h>
28 #include <media/v4l2-event.h>
29 #include <media/v4l2-device.h>
30 #include <media/videobuf2-v4l2.h>
31 #include <media/v4l2-mc.h>
33 #include <trace/events/v4l2.h>
35 /* Zero out the end of the struct pointed to by p. Everything after, but
36 * not including, the specified field is cleared. */
37 #define CLEAR_AFTER_FIELD(p, field) \
38 memset((u8 *)(p) + offsetof(typeof(*(p)), field) + sizeof((p)->field), \
39 0, sizeof(*(p)) - offsetof(typeof(*(p)), field) - sizeof((p)->field))
41 #define is_valid_ioctl(vfd, cmd) test_bit(_IOC_NR(cmd), (vfd)->valid_ioctls)
43 struct std_descr {
44 v4l2_std_id std;
45 const char *descr;
48 static const struct std_descr standards[] = {
49 { V4L2_STD_NTSC, "NTSC" },
50 { V4L2_STD_NTSC_M, "NTSC-M" },
51 { V4L2_STD_NTSC_M_JP, "NTSC-M-JP" },
52 { V4L2_STD_NTSC_M_KR, "NTSC-M-KR" },
53 { V4L2_STD_NTSC_443, "NTSC-443" },
54 { V4L2_STD_PAL, "PAL" },
55 { V4L2_STD_PAL_BG, "PAL-BG" },
56 { V4L2_STD_PAL_B, "PAL-B" },
57 { V4L2_STD_PAL_B1, "PAL-B1" },
58 { V4L2_STD_PAL_G, "PAL-G" },
59 { V4L2_STD_PAL_H, "PAL-H" },
60 { V4L2_STD_PAL_I, "PAL-I" },
61 { V4L2_STD_PAL_DK, "PAL-DK" },
62 { V4L2_STD_PAL_D, "PAL-D" },
63 { V4L2_STD_PAL_D1, "PAL-D1" },
64 { V4L2_STD_PAL_K, "PAL-K" },
65 { V4L2_STD_PAL_M, "PAL-M" },
66 { V4L2_STD_PAL_N, "PAL-N" },
67 { V4L2_STD_PAL_Nc, "PAL-Nc" },
68 { V4L2_STD_PAL_60, "PAL-60" },
69 { V4L2_STD_SECAM, "SECAM" },
70 { V4L2_STD_SECAM_B, "SECAM-B" },
71 { V4L2_STD_SECAM_G, "SECAM-G" },
72 { V4L2_STD_SECAM_H, "SECAM-H" },
73 { V4L2_STD_SECAM_DK, "SECAM-DK" },
74 { V4L2_STD_SECAM_D, "SECAM-D" },
75 { V4L2_STD_SECAM_K, "SECAM-K" },
76 { V4L2_STD_SECAM_K1, "SECAM-K1" },
77 { V4L2_STD_SECAM_L, "SECAM-L" },
78 { V4L2_STD_SECAM_LC, "SECAM-Lc" },
79 { 0, "Unknown" }
82 /* video4linux standard ID conversion to standard name
84 const char *v4l2_norm_to_name(v4l2_std_id id)
86 u32 myid = id;
87 int i;
89 /* HACK: ppc32 architecture doesn't have __ucmpdi2 function to handle
90 64 bit comparations. So, on that architecture, with some gcc
91 variants, compilation fails. Currently, the max value is 30bit wide.
93 BUG_ON(myid != id);
95 for (i = 0; standards[i].std; i++)
96 if (myid == standards[i].std)
97 break;
98 return standards[i].descr;
100 EXPORT_SYMBOL(v4l2_norm_to_name);
102 /* Returns frame period for the given standard */
103 void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod)
105 if (id & V4L2_STD_525_60) {
106 frameperiod->numerator = 1001;
107 frameperiod->denominator = 30000;
108 } else {
109 frameperiod->numerator = 1;
110 frameperiod->denominator = 25;
113 EXPORT_SYMBOL(v4l2_video_std_frame_period);
115 /* Fill in the fields of a v4l2_standard structure according to the
116 'id' and 'transmission' parameters. Returns negative on error. */
117 int v4l2_video_std_construct(struct v4l2_standard *vs,
118 int id, const char *name)
120 vs->id = id;
121 v4l2_video_std_frame_period(id, &vs->frameperiod);
122 vs->framelines = (id & V4L2_STD_525_60) ? 525 : 625;
123 strlcpy(vs->name, name, sizeof(vs->name));
124 return 0;
126 EXPORT_SYMBOL(v4l2_video_std_construct);
128 /* ----------------------------------------------------------------- */
129 /* some arrays for pretty-printing debug messages of enum types */
131 const char *v4l2_field_names[] = {
132 [V4L2_FIELD_ANY] = "any",
133 [V4L2_FIELD_NONE] = "none",
134 [V4L2_FIELD_TOP] = "top",
135 [V4L2_FIELD_BOTTOM] = "bottom",
136 [V4L2_FIELD_INTERLACED] = "interlaced",
137 [V4L2_FIELD_SEQ_TB] = "seq-tb",
138 [V4L2_FIELD_SEQ_BT] = "seq-bt",
139 [V4L2_FIELD_ALTERNATE] = "alternate",
140 [V4L2_FIELD_INTERLACED_TB] = "interlaced-tb",
141 [V4L2_FIELD_INTERLACED_BT] = "interlaced-bt",
143 EXPORT_SYMBOL(v4l2_field_names);
145 const char *v4l2_type_names[] = {
146 [0] = "0",
147 [V4L2_BUF_TYPE_VIDEO_CAPTURE] = "vid-cap",
148 [V4L2_BUF_TYPE_VIDEO_OVERLAY] = "vid-overlay",
149 [V4L2_BUF_TYPE_VIDEO_OUTPUT] = "vid-out",
150 [V4L2_BUF_TYPE_VBI_CAPTURE] = "vbi-cap",
151 [V4L2_BUF_TYPE_VBI_OUTPUT] = "vbi-out",
152 [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
153 [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT] = "sliced-vbi-out",
154 [V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY] = "vid-out-overlay",
155 [V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE] = "vid-cap-mplane",
156 [V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE] = "vid-out-mplane",
157 [V4L2_BUF_TYPE_SDR_CAPTURE] = "sdr-cap",
158 [V4L2_BUF_TYPE_SDR_OUTPUT] = "sdr-out",
159 [V4L2_BUF_TYPE_META_CAPTURE] = "meta-cap",
161 EXPORT_SYMBOL(v4l2_type_names);
163 static const char *v4l2_memory_names[] = {
164 [V4L2_MEMORY_MMAP] = "mmap",
165 [V4L2_MEMORY_USERPTR] = "userptr",
166 [V4L2_MEMORY_OVERLAY] = "overlay",
167 [V4L2_MEMORY_DMABUF] = "dmabuf",
170 #define prt_names(a, arr) (((unsigned)(a)) < ARRAY_SIZE(arr) ? arr[a] : "unknown")
172 /* ------------------------------------------------------------------ */
173 /* debug help functions */
175 static void v4l_print_querycap(const void *arg, bool write_only)
177 const struct v4l2_capability *p = arg;
179 pr_cont("driver=%.*s, card=%.*s, bus=%.*s, version=0x%08x, capabilities=0x%08x, device_caps=0x%08x\n",
180 (int)sizeof(p->driver), p->driver,
181 (int)sizeof(p->card), p->card,
182 (int)sizeof(p->bus_info), p->bus_info,
183 p->version, p->capabilities, p->device_caps);
186 static void v4l_print_enuminput(const void *arg, bool write_only)
188 const struct v4l2_input *p = arg;
190 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, tuner=%u, std=0x%08Lx, status=0x%x, capabilities=0x%x\n",
191 p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
192 p->tuner, (unsigned long long)p->std, p->status,
193 p->capabilities);
196 static void v4l_print_enumoutput(const void *arg, bool write_only)
198 const struct v4l2_output *p = arg;
200 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, modulator=%u, std=0x%08Lx, capabilities=0x%x\n",
201 p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
202 p->modulator, (unsigned long long)p->std, p->capabilities);
205 static void v4l_print_audio(const void *arg, bool write_only)
207 const struct v4l2_audio *p = arg;
209 if (write_only)
210 pr_cont("index=%u, mode=0x%x\n", p->index, p->mode);
211 else
212 pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
213 p->index, (int)sizeof(p->name), p->name,
214 p->capability, p->mode);
217 static void v4l_print_audioout(const void *arg, bool write_only)
219 const struct v4l2_audioout *p = arg;
221 if (write_only)
222 pr_cont("index=%u\n", p->index);
223 else
224 pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
225 p->index, (int)sizeof(p->name), p->name,
226 p->capability, p->mode);
229 static void v4l_print_fmtdesc(const void *arg, bool write_only)
231 const struct v4l2_fmtdesc *p = arg;
233 pr_cont("index=%u, type=%s, flags=0x%x, pixelformat=%c%c%c%c, description='%.*s'\n",
234 p->index, prt_names(p->type, v4l2_type_names),
235 p->flags, (p->pixelformat & 0xff),
236 (p->pixelformat >> 8) & 0xff,
237 (p->pixelformat >> 16) & 0xff,
238 (p->pixelformat >> 24) & 0xff,
239 (int)sizeof(p->description), p->description);
242 static void v4l_print_format(const void *arg, bool write_only)
244 const struct v4l2_format *p = arg;
245 const struct v4l2_pix_format *pix;
246 const struct v4l2_pix_format_mplane *mp;
247 const struct v4l2_vbi_format *vbi;
248 const struct v4l2_sliced_vbi_format *sliced;
249 const struct v4l2_window *win;
250 const struct v4l2_sdr_format *sdr;
251 const struct v4l2_meta_format *meta;
252 unsigned i;
254 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
255 switch (p->type) {
256 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
257 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
258 pix = &p->fmt.pix;
259 pr_cont(", width=%u, height=%u, pixelformat=%c%c%c%c, field=%s, bytesperline=%u, sizeimage=%u, colorspace=%d, flags=0x%x, ycbcr_enc=%u, quantization=%u, xfer_func=%u\n",
260 pix->width, pix->height,
261 (pix->pixelformat & 0xff),
262 (pix->pixelformat >> 8) & 0xff,
263 (pix->pixelformat >> 16) & 0xff,
264 (pix->pixelformat >> 24) & 0xff,
265 prt_names(pix->field, v4l2_field_names),
266 pix->bytesperline, pix->sizeimage,
267 pix->colorspace, pix->flags, pix->ycbcr_enc,
268 pix->quantization, pix->xfer_func);
269 break;
270 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
271 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
272 mp = &p->fmt.pix_mp;
273 pr_cont(", width=%u, height=%u, format=%c%c%c%c, field=%s, colorspace=%d, num_planes=%u, flags=0x%x, ycbcr_enc=%u, quantization=%u, xfer_func=%u\n",
274 mp->width, mp->height,
275 (mp->pixelformat & 0xff),
276 (mp->pixelformat >> 8) & 0xff,
277 (mp->pixelformat >> 16) & 0xff,
278 (mp->pixelformat >> 24) & 0xff,
279 prt_names(mp->field, v4l2_field_names),
280 mp->colorspace, mp->num_planes, mp->flags,
281 mp->ycbcr_enc, mp->quantization, mp->xfer_func);
282 for (i = 0; i < mp->num_planes; i++)
283 printk(KERN_DEBUG "plane %u: bytesperline=%u sizeimage=%u\n", i,
284 mp->plane_fmt[i].bytesperline,
285 mp->plane_fmt[i].sizeimage);
286 break;
287 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
288 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
289 win = &p->fmt.win;
290 /* Note: we can't print the clip list here since the clips
291 * pointer is a userspace pointer, not a kernelspace
292 * pointer. */
293 pr_cont(", wxh=%dx%d, x,y=%d,%d, field=%s, chromakey=0x%08x, clipcount=%u, clips=%p, bitmap=%p, global_alpha=0x%02x\n",
294 win->w.width, win->w.height, win->w.left, win->w.top,
295 prt_names(win->field, v4l2_field_names),
296 win->chromakey, win->clipcount, win->clips,
297 win->bitmap, win->global_alpha);
298 break;
299 case V4L2_BUF_TYPE_VBI_CAPTURE:
300 case V4L2_BUF_TYPE_VBI_OUTPUT:
301 vbi = &p->fmt.vbi;
302 pr_cont(", sampling_rate=%u, offset=%u, samples_per_line=%u, sample_format=%c%c%c%c, start=%u,%u, count=%u,%u\n",
303 vbi->sampling_rate, vbi->offset,
304 vbi->samples_per_line,
305 (vbi->sample_format & 0xff),
306 (vbi->sample_format >> 8) & 0xff,
307 (vbi->sample_format >> 16) & 0xff,
308 (vbi->sample_format >> 24) & 0xff,
309 vbi->start[0], vbi->start[1],
310 vbi->count[0], vbi->count[1]);
311 break;
312 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
313 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
314 sliced = &p->fmt.sliced;
315 pr_cont(", service_set=0x%08x, io_size=%d\n",
316 sliced->service_set, sliced->io_size);
317 for (i = 0; i < 24; i++)
318 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
319 sliced->service_lines[0][i],
320 sliced->service_lines[1][i]);
321 break;
322 case V4L2_BUF_TYPE_SDR_CAPTURE:
323 case V4L2_BUF_TYPE_SDR_OUTPUT:
324 sdr = &p->fmt.sdr;
325 pr_cont(", pixelformat=%c%c%c%c\n",
326 (sdr->pixelformat >> 0) & 0xff,
327 (sdr->pixelformat >> 8) & 0xff,
328 (sdr->pixelformat >> 16) & 0xff,
329 (sdr->pixelformat >> 24) & 0xff);
330 break;
331 case V4L2_BUF_TYPE_META_CAPTURE:
332 meta = &p->fmt.meta;
333 pr_cont(", dataformat=%c%c%c%c, buffersize=%u\n",
334 (meta->dataformat >> 0) & 0xff,
335 (meta->dataformat >> 8) & 0xff,
336 (meta->dataformat >> 16) & 0xff,
337 (meta->dataformat >> 24) & 0xff,
338 meta->buffersize);
339 break;
343 static void v4l_print_framebuffer(const void *arg, bool write_only)
345 const struct v4l2_framebuffer *p = arg;
347 pr_cont("capability=0x%x, flags=0x%x, base=0x%p, width=%u, height=%u, pixelformat=%c%c%c%c, bytesperline=%u, sizeimage=%u, colorspace=%d\n",
348 p->capability, p->flags, p->base,
349 p->fmt.width, p->fmt.height,
350 (p->fmt.pixelformat & 0xff),
351 (p->fmt.pixelformat >> 8) & 0xff,
352 (p->fmt.pixelformat >> 16) & 0xff,
353 (p->fmt.pixelformat >> 24) & 0xff,
354 p->fmt.bytesperline, p->fmt.sizeimage,
355 p->fmt.colorspace);
358 static void v4l_print_buftype(const void *arg, bool write_only)
360 pr_cont("type=%s\n", prt_names(*(u32 *)arg, v4l2_type_names));
363 static void v4l_print_modulator(const void *arg, bool write_only)
365 const struct v4l2_modulator *p = arg;
367 if (write_only)
368 pr_cont("index=%u, txsubchans=0x%x\n", p->index, p->txsubchans);
369 else
370 pr_cont("index=%u, name=%.*s, capability=0x%x, rangelow=%u, rangehigh=%u, txsubchans=0x%x\n",
371 p->index, (int)sizeof(p->name), p->name, p->capability,
372 p->rangelow, p->rangehigh, p->txsubchans);
375 static void v4l_print_tuner(const void *arg, bool write_only)
377 const struct v4l2_tuner *p = arg;
379 if (write_only)
380 pr_cont("index=%u, audmode=%u\n", p->index, p->audmode);
381 else
382 pr_cont("index=%u, name=%.*s, type=%u, capability=0x%x, rangelow=%u, rangehigh=%u, signal=%u, afc=%d, rxsubchans=0x%x, audmode=%u\n",
383 p->index, (int)sizeof(p->name), p->name, p->type,
384 p->capability, p->rangelow,
385 p->rangehigh, p->signal, p->afc,
386 p->rxsubchans, p->audmode);
389 static void v4l_print_frequency(const void *arg, bool write_only)
391 const struct v4l2_frequency *p = arg;
393 pr_cont("tuner=%u, type=%u, frequency=%u\n",
394 p->tuner, p->type, p->frequency);
397 static void v4l_print_standard(const void *arg, bool write_only)
399 const struct v4l2_standard *p = arg;
401 pr_cont("index=%u, id=0x%Lx, name=%.*s, fps=%u/%u, framelines=%u\n",
402 p->index,
403 (unsigned long long)p->id, (int)sizeof(p->name), p->name,
404 p->frameperiod.numerator,
405 p->frameperiod.denominator,
406 p->framelines);
409 static void v4l_print_std(const void *arg, bool write_only)
411 pr_cont("std=0x%08Lx\n", *(const long long unsigned *)arg);
414 static void v4l_print_hw_freq_seek(const void *arg, bool write_only)
416 const struct v4l2_hw_freq_seek *p = arg;
418 pr_cont("tuner=%u, type=%u, seek_upward=%u, wrap_around=%u, spacing=%u, rangelow=%u, rangehigh=%u\n",
419 p->tuner, p->type, p->seek_upward, p->wrap_around, p->spacing,
420 p->rangelow, p->rangehigh);
423 static void v4l_print_requestbuffers(const void *arg, bool write_only)
425 const struct v4l2_requestbuffers *p = arg;
427 pr_cont("count=%d, type=%s, memory=%s\n",
428 p->count,
429 prt_names(p->type, v4l2_type_names),
430 prt_names(p->memory, v4l2_memory_names));
433 static void v4l_print_buffer(const void *arg, bool write_only)
435 const struct v4l2_buffer *p = arg;
436 const struct v4l2_timecode *tc = &p->timecode;
437 const struct v4l2_plane *plane;
438 int i;
440 pr_cont("%02ld:%02d:%02d.%08ld index=%d, type=%s, flags=0x%08x, field=%s, sequence=%d, memory=%s",
441 p->timestamp.tv_sec / 3600,
442 (int)(p->timestamp.tv_sec / 60) % 60,
443 (int)(p->timestamp.tv_sec % 60),
444 (long)p->timestamp.tv_usec,
445 p->index,
446 prt_names(p->type, v4l2_type_names),
447 p->flags, prt_names(p->field, v4l2_field_names),
448 p->sequence, prt_names(p->memory, v4l2_memory_names));
450 if (V4L2_TYPE_IS_MULTIPLANAR(p->type) && p->m.planes) {
451 pr_cont("\n");
452 for (i = 0; i < p->length; ++i) {
453 plane = &p->m.planes[i];
454 printk(KERN_DEBUG
455 "plane %d: bytesused=%d, data_offset=0x%08x, offset/userptr=0x%lx, length=%d\n",
456 i, plane->bytesused, plane->data_offset,
457 plane->m.userptr, plane->length);
459 } else {
460 pr_cont(", bytesused=%d, offset/userptr=0x%lx, length=%d\n",
461 p->bytesused, p->m.userptr, p->length);
464 printk(KERN_DEBUG "timecode=%02d:%02d:%02d type=%d, flags=0x%08x, frames=%d, userbits=0x%08x\n",
465 tc->hours, tc->minutes, tc->seconds,
466 tc->type, tc->flags, tc->frames, *(__u32 *)tc->userbits);
469 static void v4l_print_exportbuffer(const void *arg, bool write_only)
471 const struct v4l2_exportbuffer *p = arg;
473 pr_cont("fd=%d, type=%s, index=%u, plane=%u, flags=0x%08x\n",
474 p->fd, prt_names(p->type, v4l2_type_names),
475 p->index, p->plane, p->flags);
478 static void v4l_print_create_buffers(const void *arg, bool write_only)
480 const struct v4l2_create_buffers *p = arg;
482 pr_cont("index=%d, count=%d, memory=%s, ",
483 p->index, p->count,
484 prt_names(p->memory, v4l2_memory_names));
485 v4l_print_format(&p->format, write_only);
488 static void v4l_print_streamparm(const void *arg, bool write_only)
490 const struct v4l2_streamparm *p = arg;
492 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
494 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
495 p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE) {
496 const struct v4l2_captureparm *c = &p->parm.capture;
498 pr_cont(", capability=0x%x, capturemode=0x%x, timeperframe=%d/%d, extendedmode=%d, readbuffers=%d\n",
499 c->capability, c->capturemode,
500 c->timeperframe.numerator, c->timeperframe.denominator,
501 c->extendedmode, c->readbuffers);
502 } else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT ||
503 p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
504 const struct v4l2_outputparm *c = &p->parm.output;
506 pr_cont(", capability=0x%x, outputmode=0x%x, timeperframe=%d/%d, extendedmode=%d, writebuffers=%d\n",
507 c->capability, c->outputmode,
508 c->timeperframe.numerator, c->timeperframe.denominator,
509 c->extendedmode, c->writebuffers);
510 } else {
511 pr_cont("\n");
515 static void v4l_print_queryctrl(const void *arg, bool write_only)
517 const struct v4l2_queryctrl *p = arg;
519 pr_cont("id=0x%x, type=%d, name=%.*s, min/max=%d/%d, step=%d, default=%d, flags=0x%08x\n",
520 p->id, p->type, (int)sizeof(p->name), p->name,
521 p->minimum, p->maximum,
522 p->step, p->default_value, p->flags);
525 static void v4l_print_query_ext_ctrl(const void *arg, bool write_only)
527 const struct v4l2_query_ext_ctrl *p = arg;
529 pr_cont("id=0x%x, type=%d, name=%.*s, min/max=%lld/%lld, step=%lld, default=%lld, flags=0x%08x, elem_size=%u, elems=%u, nr_of_dims=%u, dims=%u,%u,%u,%u\n",
530 p->id, p->type, (int)sizeof(p->name), p->name,
531 p->minimum, p->maximum,
532 p->step, p->default_value, p->flags,
533 p->elem_size, p->elems, p->nr_of_dims,
534 p->dims[0], p->dims[1], p->dims[2], p->dims[3]);
537 static void v4l_print_querymenu(const void *arg, bool write_only)
539 const struct v4l2_querymenu *p = arg;
541 pr_cont("id=0x%x, index=%d\n", p->id, p->index);
544 static void v4l_print_control(const void *arg, bool write_only)
546 const struct v4l2_control *p = arg;
548 pr_cont("id=0x%x, value=%d\n", p->id, p->value);
551 static void v4l_print_ext_controls(const void *arg, bool write_only)
553 const struct v4l2_ext_controls *p = arg;
554 int i;
556 pr_cont("which=0x%x, count=%d, error_idx=%d",
557 p->which, p->count, p->error_idx);
558 for (i = 0; i < p->count; i++) {
559 if (!p->controls[i].size)
560 pr_cont(", id/val=0x%x/0x%x",
561 p->controls[i].id, p->controls[i].value);
562 else
563 pr_cont(", id/size=0x%x/%u",
564 p->controls[i].id, p->controls[i].size);
566 pr_cont("\n");
569 static void v4l_print_cropcap(const void *arg, bool write_only)
571 const struct v4l2_cropcap *p = arg;
573 pr_cont("type=%s, bounds wxh=%dx%d, x,y=%d,%d, defrect wxh=%dx%d, x,y=%d,%d, pixelaspect %d/%d\n",
574 prt_names(p->type, v4l2_type_names),
575 p->bounds.width, p->bounds.height,
576 p->bounds.left, p->bounds.top,
577 p->defrect.width, p->defrect.height,
578 p->defrect.left, p->defrect.top,
579 p->pixelaspect.numerator, p->pixelaspect.denominator);
582 static void v4l_print_crop(const void *arg, bool write_only)
584 const struct v4l2_crop *p = arg;
586 pr_cont("type=%s, wxh=%dx%d, x,y=%d,%d\n",
587 prt_names(p->type, v4l2_type_names),
588 p->c.width, p->c.height,
589 p->c.left, p->c.top);
592 static void v4l_print_selection(const void *arg, bool write_only)
594 const struct v4l2_selection *p = arg;
596 pr_cont("type=%s, target=%d, flags=0x%x, wxh=%dx%d, x,y=%d,%d\n",
597 prt_names(p->type, v4l2_type_names),
598 p->target, p->flags,
599 p->r.width, p->r.height, p->r.left, p->r.top);
602 static void v4l_print_jpegcompression(const void *arg, bool write_only)
604 const struct v4l2_jpegcompression *p = arg;
606 pr_cont("quality=%d, APPn=%d, APP_len=%d, COM_len=%d, jpeg_markers=0x%x\n",
607 p->quality, p->APPn, p->APP_len,
608 p->COM_len, p->jpeg_markers);
611 static void v4l_print_enc_idx(const void *arg, bool write_only)
613 const struct v4l2_enc_idx *p = arg;
615 pr_cont("entries=%d, entries_cap=%d\n",
616 p->entries, p->entries_cap);
619 static void v4l_print_encoder_cmd(const void *arg, bool write_only)
621 const struct v4l2_encoder_cmd *p = arg;
623 pr_cont("cmd=%d, flags=0x%x\n",
624 p->cmd, p->flags);
627 static void v4l_print_decoder_cmd(const void *arg, bool write_only)
629 const struct v4l2_decoder_cmd *p = arg;
631 pr_cont("cmd=%d, flags=0x%x\n", p->cmd, p->flags);
633 if (p->cmd == V4L2_DEC_CMD_START)
634 pr_info("speed=%d, format=%u\n",
635 p->start.speed, p->start.format);
636 else if (p->cmd == V4L2_DEC_CMD_STOP)
637 pr_info("pts=%llu\n", p->stop.pts);
640 static void v4l_print_dbg_chip_info(const void *arg, bool write_only)
642 const struct v4l2_dbg_chip_info *p = arg;
644 pr_cont("type=%u, ", p->match.type);
645 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
646 pr_cont("name=%.*s, ",
647 (int)sizeof(p->match.name), p->match.name);
648 else
649 pr_cont("addr=%u, ", p->match.addr);
650 pr_cont("name=%.*s\n", (int)sizeof(p->name), p->name);
653 static void v4l_print_dbg_register(const void *arg, bool write_only)
655 const struct v4l2_dbg_register *p = arg;
657 pr_cont("type=%u, ", p->match.type);
658 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
659 pr_cont("name=%.*s, ",
660 (int)sizeof(p->match.name), p->match.name);
661 else
662 pr_cont("addr=%u, ", p->match.addr);
663 pr_cont("reg=0x%llx, val=0x%llx\n",
664 p->reg, p->val);
667 static void v4l_print_dv_timings(const void *arg, bool write_only)
669 const struct v4l2_dv_timings *p = arg;
671 switch (p->type) {
672 case V4L2_DV_BT_656_1120:
673 pr_cont("type=bt-656/1120, interlaced=%u, pixelclock=%llu, width=%u, height=%u, polarities=0x%x, hfrontporch=%u, hsync=%u, hbackporch=%u, vfrontporch=%u, vsync=%u, vbackporch=%u, il_vfrontporch=%u, il_vsync=%u, il_vbackporch=%u, standards=0x%x, flags=0x%x\n",
674 p->bt.interlaced, p->bt.pixelclock,
675 p->bt.width, p->bt.height,
676 p->bt.polarities, p->bt.hfrontporch,
677 p->bt.hsync, p->bt.hbackporch,
678 p->bt.vfrontporch, p->bt.vsync,
679 p->bt.vbackporch, p->bt.il_vfrontporch,
680 p->bt.il_vsync, p->bt.il_vbackporch,
681 p->bt.standards, p->bt.flags);
682 break;
683 default:
684 pr_cont("type=%d\n", p->type);
685 break;
689 static void v4l_print_enum_dv_timings(const void *arg, bool write_only)
691 const struct v4l2_enum_dv_timings *p = arg;
693 pr_cont("index=%u, ", p->index);
694 v4l_print_dv_timings(&p->timings, write_only);
697 static void v4l_print_dv_timings_cap(const void *arg, bool write_only)
699 const struct v4l2_dv_timings_cap *p = arg;
701 switch (p->type) {
702 case V4L2_DV_BT_656_1120:
703 pr_cont("type=bt-656/1120, width=%u-%u, height=%u-%u, pixelclock=%llu-%llu, standards=0x%x, capabilities=0x%x\n",
704 p->bt.min_width, p->bt.max_width,
705 p->bt.min_height, p->bt.max_height,
706 p->bt.min_pixelclock, p->bt.max_pixelclock,
707 p->bt.standards, p->bt.capabilities);
708 break;
709 default:
710 pr_cont("type=%u\n", p->type);
711 break;
715 static void v4l_print_frmsizeenum(const void *arg, bool write_only)
717 const struct v4l2_frmsizeenum *p = arg;
719 pr_cont("index=%u, pixelformat=%c%c%c%c, type=%u",
720 p->index,
721 (p->pixel_format & 0xff),
722 (p->pixel_format >> 8) & 0xff,
723 (p->pixel_format >> 16) & 0xff,
724 (p->pixel_format >> 24) & 0xff,
725 p->type);
726 switch (p->type) {
727 case V4L2_FRMSIZE_TYPE_DISCRETE:
728 pr_cont(", wxh=%ux%u\n",
729 p->discrete.width, p->discrete.height);
730 break;
731 case V4L2_FRMSIZE_TYPE_STEPWISE:
732 pr_cont(", min=%ux%u, max=%ux%u, step=%ux%u\n",
733 p->stepwise.min_width,
734 p->stepwise.min_height,
735 p->stepwise.max_width,
736 p->stepwise.max_height,
737 p->stepwise.step_width,
738 p->stepwise.step_height);
739 break;
740 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
741 /* fall through */
742 default:
743 pr_cont("\n");
744 break;
748 static void v4l_print_frmivalenum(const void *arg, bool write_only)
750 const struct v4l2_frmivalenum *p = arg;
752 pr_cont("index=%u, pixelformat=%c%c%c%c, wxh=%ux%u, type=%u",
753 p->index,
754 (p->pixel_format & 0xff),
755 (p->pixel_format >> 8) & 0xff,
756 (p->pixel_format >> 16) & 0xff,
757 (p->pixel_format >> 24) & 0xff,
758 p->width, p->height, p->type);
759 switch (p->type) {
760 case V4L2_FRMIVAL_TYPE_DISCRETE:
761 pr_cont(", fps=%d/%d\n",
762 p->discrete.numerator,
763 p->discrete.denominator);
764 break;
765 case V4L2_FRMIVAL_TYPE_STEPWISE:
766 pr_cont(", min=%d/%d, max=%d/%d, step=%d/%d\n",
767 p->stepwise.min.numerator,
768 p->stepwise.min.denominator,
769 p->stepwise.max.numerator,
770 p->stepwise.max.denominator,
771 p->stepwise.step.numerator,
772 p->stepwise.step.denominator);
773 break;
774 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
775 /* fall through */
776 default:
777 pr_cont("\n");
778 break;
782 static void v4l_print_event(const void *arg, bool write_only)
784 const struct v4l2_event *p = arg;
785 const struct v4l2_event_ctrl *c;
787 pr_cont("type=0x%x, pending=%u, sequence=%u, id=%u, timestamp=%lu.%9.9lu\n",
788 p->type, p->pending, p->sequence, p->id,
789 p->timestamp.tv_sec, p->timestamp.tv_nsec);
790 switch (p->type) {
791 case V4L2_EVENT_VSYNC:
792 printk(KERN_DEBUG "field=%s\n",
793 prt_names(p->u.vsync.field, v4l2_field_names));
794 break;
795 case V4L2_EVENT_CTRL:
796 c = &p->u.ctrl;
797 printk(KERN_DEBUG "changes=0x%x, type=%u, ",
798 c->changes, c->type);
799 if (c->type == V4L2_CTRL_TYPE_INTEGER64)
800 pr_cont("value64=%lld, ", c->value64);
801 else
802 pr_cont("value=%d, ", c->value);
803 pr_cont("flags=0x%x, minimum=%d, maximum=%d, step=%d, default_value=%d\n",
804 c->flags, c->minimum, c->maximum,
805 c->step, c->default_value);
806 break;
807 case V4L2_EVENT_FRAME_SYNC:
808 pr_cont("frame_sequence=%u\n",
809 p->u.frame_sync.frame_sequence);
810 break;
814 static void v4l_print_event_subscription(const void *arg, bool write_only)
816 const struct v4l2_event_subscription *p = arg;
818 pr_cont("type=0x%x, id=0x%x, flags=0x%x\n",
819 p->type, p->id, p->flags);
822 static void v4l_print_sliced_vbi_cap(const void *arg, bool write_only)
824 const struct v4l2_sliced_vbi_cap *p = arg;
825 int i;
827 pr_cont("type=%s, service_set=0x%08x\n",
828 prt_names(p->type, v4l2_type_names), p->service_set);
829 for (i = 0; i < 24; i++)
830 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
831 p->service_lines[0][i],
832 p->service_lines[1][i]);
835 static void v4l_print_freq_band(const void *arg, bool write_only)
837 const struct v4l2_frequency_band *p = arg;
839 pr_cont("tuner=%u, type=%u, index=%u, capability=0x%x, rangelow=%u, rangehigh=%u, modulation=0x%x\n",
840 p->tuner, p->type, p->index,
841 p->capability, p->rangelow,
842 p->rangehigh, p->modulation);
845 static void v4l_print_edid(const void *arg, bool write_only)
847 const struct v4l2_edid *p = arg;
849 pr_cont("pad=%u, start_block=%u, blocks=%u\n",
850 p->pad, p->start_block, p->blocks);
853 static void v4l_print_u32(const void *arg, bool write_only)
855 pr_cont("value=%u\n", *(const u32 *)arg);
858 static void v4l_print_newline(const void *arg, bool write_only)
860 pr_cont("\n");
863 static void v4l_print_default(const void *arg, bool write_only)
865 pr_cont("driver-specific ioctl\n");
868 static int check_ext_ctrls(struct v4l2_ext_controls *c, int allow_priv)
870 __u32 i;
872 /* zero the reserved fields */
873 c->reserved[0] = c->reserved[1] = 0;
874 for (i = 0; i < c->count; i++)
875 c->controls[i].reserved2[0] = 0;
877 /* V4L2_CID_PRIVATE_BASE cannot be used as control class
878 when using extended controls.
879 Only when passed in through VIDIOC_G_CTRL and VIDIOC_S_CTRL
880 is it allowed for backwards compatibility.
882 if (!allow_priv && c->which == V4L2_CID_PRIVATE_BASE)
883 return 0;
884 if (!c->which)
885 return 1;
886 /* Check that all controls are from the same control class. */
887 for (i = 0; i < c->count; i++) {
888 if (V4L2_CTRL_ID2WHICH(c->controls[i].id) != c->which) {
889 c->error_idx = i;
890 return 0;
893 return 1;
896 static int check_fmt(struct file *file, enum v4l2_buf_type type)
898 struct video_device *vfd = video_devdata(file);
899 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
900 bool is_vid = vfd->vfl_type == VFL_TYPE_GRABBER;
901 bool is_vbi = vfd->vfl_type == VFL_TYPE_VBI;
902 bool is_sdr = vfd->vfl_type == VFL_TYPE_SDR;
903 bool is_tch = vfd->vfl_type == VFL_TYPE_TOUCH;
904 bool is_rx = vfd->vfl_dir != VFL_DIR_TX;
905 bool is_tx = vfd->vfl_dir != VFL_DIR_RX;
907 if (ops == NULL)
908 return -EINVAL;
910 switch (type) {
911 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
912 if ((is_vid || is_tch) && is_rx &&
913 (ops->vidioc_g_fmt_vid_cap || ops->vidioc_g_fmt_vid_cap_mplane))
914 return 0;
915 break;
916 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
917 if (is_vid && is_rx && ops->vidioc_g_fmt_vid_cap_mplane)
918 return 0;
919 break;
920 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
921 if (is_vid && is_rx && ops->vidioc_g_fmt_vid_overlay)
922 return 0;
923 break;
924 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
925 if (is_vid && is_tx &&
926 (ops->vidioc_g_fmt_vid_out || ops->vidioc_g_fmt_vid_out_mplane))
927 return 0;
928 break;
929 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
930 if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_mplane)
931 return 0;
932 break;
933 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
934 if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_overlay)
935 return 0;
936 break;
937 case V4L2_BUF_TYPE_VBI_CAPTURE:
938 if (is_vbi && is_rx && ops->vidioc_g_fmt_vbi_cap)
939 return 0;
940 break;
941 case V4L2_BUF_TYPE_VBI_OUTPUT:
942 if (is_vbi && is_tx && ops->vidioc_g_fmt_vbi_out)
943 return 0;
944 break;
945 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
946 if (is_vbi && is_rx && ops->vidioc_g_fmt_sliced_vbi_cap)
947 return 0;
948 break;
949 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
950 if (is_vbi && is_tx && ops->vidioc_g_fmt_sliced_vbi_out)
951 return 0;
952 break;
953 case V4L2_BUF_TYPE_SDR_CAPTURE:
954 if (is_sdr && is_rx && ops->vidioc_g_fmt_sdr_cap)
955 return 0;
956 break;
957 case V4L2_BUF_TYPE_SDR_OUTPUT:
958 if (is_sdr && is_tx && ops->vidioc_g_fmt_sdr_out)
959 return 0;
960 break;
961 case V4L2_BUF_TYPE_META_CAPTURE:
962 if (is_vid && is_rx && ops->vidioc_g_fmt_meta_cap)
963 return 0;
964 break;
965 default:
966 break;
968 return -EINVAL;
971 static void v4l_sanitize_format(struct v4l2_format *fmt)
973 unsigned int offset;
976 * The v4l2_pix_format structure has been extended with fields that were
977 * not previously required to be set to zero by applications. The priv
978 * field, when set to a magic value, indicates the the extended fields
979 * are valid. Otherwise they will contain undefined values. To simplify
980 * the API towards drivers zero the extended fields and set the priv
981 * field to the magic value when the extended pixel format structure
982 * isn't used by applications.
985 if (fmt->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
986 fmt->type != V4L2_BUF_TYPE_VIDEO_OUTPUT)
987 return;
989 if (fmt->fmt.pix.priv == V4L2_PIX_FMT_PRIV_MAGIC)
990 return;
992 fmt->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
994 offset = offsetof(struct v4l2_pix_format, priv)
995 + sizeof(fmt->fmt.pix.priv);
996 memset(((void *)&fmt->fmt.pix) + offset, 0,
997 sizeof(fmt->fmt.pix) - offset);
1000 static int v4l_querycap(const struct v4l2_ioctl_ops *ops,
1001 struct file *file, void *fh, void *arg)
1003 struct v4l2_capability *cap = (struct v4l2_capability *)arg;
1004 struct video_device *vfd = video_devdata(file);
1005 int ret;
1007 cap->version = LINUX_VERSION_CODE;
1008 cap->device_caps = vfd->device_caps;
1009 cap->capabilities = vfd->device_caps | V4L2_CAP_DEVICE_CAPS;
1011 ret = ops->vidioc_querycap(file, fh, cap);
1013 cap->capabilities |= V4L2_CAP_EXT_PIX_FORMAT;
1015 * Drivers MUST fill in device_caps, so check for this and
1016 * warn if it was forgotten.
1018 WARN(!(cap->capabilities & V4L2_CAP_DEVICE_CAPS) ||
1019 !cap->device_caps, "Bad caps for driver %s, %x %x",
1020 cap->driver, cap->capabilities, cap->device_caps);
1021 cap->device_caps |= V4L2_CAP_EXT_PIX_FORMAT;
1023 return ret;
1026 static int v4l_s_input(const struct v4l2_ioctl_ops *ops,
1027 struct file *file, void *fh, void *arg)
1029 struct video_device *vfd = video_devdata(file);
1030 int ret;
1032 ret = v4l_enable_media_source(vfd);
1033 if (ret)
1034 return ret;
1035 return ops->vidioc_s_input(file, fh, *(unsigned int *)arg);
1038 static int v4l_s_output(const struct v4l2_ioctl_ops *ops,
1039 struct file *file, void *fh, void *arg)
1041 return ops->vidioc_s_output(file, fh, *(unsigned int *)arg);
1044 static int v4l_g_priority(const struct v4l2_ioctl_ops *ops,
1045 struct file *file, void *fh, void *arg)
1047 struct video_device *vfd;
1048 u32 *p = arg;
1050 vfd = video_devdata(file);
1051 *p = v4l2_prio_max(vfd->prio);
1052 return 0;
1055 static int v4l_s_priority(const struct v4l2_ioctl_ops *ops,
1056 struct file *file, void *fh, void *arg)
1058 struct video_device *vfd;
1059 struct v4l2_fh *vfh;
1060 u32 *p = arg;
1062 vfd = video_devdata(file);
1063 if (!test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags))
1064 return -ENOTTY;
1065 vfh = file->private_data;
1066 return v4l2_prio_change(vfd->prio, &vfh->prio, *p);
1069 static int v4l_enuminput(const struct v4l2_ioctl_ops *ops,
1070 struct file *file, void *fh, void *arg)
1072 struct video_device *vfd = video_devdata(file);
1073 struct v4l2_input *p = arg;
1076 * We set the flags for CAP_DV_TIMINGS &
1077 * CAP_STD here based on ioctl handler provided by the
1078 * driver. If the driver doesn't support these
1079 * for a specific input, it must override these flags.
1081 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
1082 p->capabilities |= V4L2_IN_CAP_STD;
1084 return ops->vidioc_enum_input(file, fh, p);
1087 static int v4l_enumoutput(const struct v4l2_ioctl_ops *ops,
1088 struct file *file, void *fh, void *arg)
1090 struct video_device *vfd = video_devdata(file);
1091 struct v4l2_output *p = arg;
1094 * We set the flags for CAP_DV_TIMINGS &
1095 * CAP_STD here based on ioctl handler provided by the
1096 * driver. If the driver doesn't support these
1097 * for a specific output, it must override these flags.
1099 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
1100 p->capabilities |= V4L2_OUT_CAP_STD;
1102 return ops->vidioc_enum_output(file, fh, p);
1105 static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt)
1107 const unsigned sz = sizeof(fmt->description);
1108 const char *descr = NULL;
1109 u32 flags = 0;
1112 * We depart from the normal coding style here since the descriptions
1113 * should be aligned so it is easy to see which descriptions will be
1114 * longer than 31 characters (the max length for a description).
1115 * And frankly, this is easier to read anyway.
1117 * Note that gcc will use O(log N) comparisons to find the right case.
1119 switch (fmt->pixelformat) {
1120 /* Max description length mask: descr = "0123456789012345678901234567890" */
1121 case V4L2_PIX_FMT_RGB332: descr = "8-bit RGB 3-3-2"; break;
1122 case V4L2_PIX_FMT_RGB444: descr = "16-bit A/XRGB 4-4-4-4"; break;
1123 case V4L2_PIX_FMT_ARGB444: descr = "16-bit ARGB 4-4-4-4"; break;
1124 case V4L2_PIX_FMT_XRGB444: descr = "16-bit XRGB 4-4-4-4"; break;
1125 case V4L2_PIX_FMT_RGB555: descr = "16-bit A/XRGB 1-5-5-5"; break;
1126 case V4L2_PIX_FMT_ARGB555: descr = "16-bit ARGB 1-5-5-5"; break;
1127 case V4L2_PIX_FMT_XRGB555: descr = "16-bit XRGB 1-5-5-5"; break;
1128 case V4L2_PIX_FMT_RGB565: descr = "16-bit RGB 5-6-5"; break;
1129 case V4L2_PIX_FMT_RGB555X: descr = "16-bit A/XRGB 1-5-5-5 BE"; break;
1130 case V4L2_PIX_FMT_ARGB555X: descr = "16-bit ARGB 1-5-5-5 BE"; break;
1131 case V4L2_PIX_FMT_XRGB555X: descr = "16-bit XRGB 1-5-5-5 BE"; break;
1132 case V4L2_PIX_FMT_RGB565X: descr = "16-bit RGB 5-6-5 BE"; break;
1133 case V4L2_PIX_FMT_BGR666: descr = "18-bit BGRX 6-6-6-14"; break;
1134 case V4L2_PIX_FMT_BGR24: descr = "24-bit BGR 8-8-8"; break;
1135 case V4L2_PIX_FMT_RGB24: descr = "24-bit RGB 8-8-8"; break;
1136 case V4L2_PIX_FMT_BGR32: descr = "32-bit BGRA/X 8-8-8-8"; break;
1137 case V4L2_PIX_FMT_ABGR32: descr = "32-bit BGRA 8-8-8-8"; break;
1138 case V4L2_PIX_FMT_XBGR32: descr = "32-bit BGRX 8-8-8-8"; break;
1139 case V4L2_PIX_FMT_RGB32: descr = "32-bit A/XRGB 8-8-8-8"; break;
1140 case V4L2_PIX_FMT_ARGB32: descr = "32-bit ARGB 8-8-8-8"; break;
1141 case V4L2_PIX_FMT_XRGB32: descr = "32-bit XRGB 8-8-8-8"; break;
1142 case V4L2_PIX_FMT_GREY: descr = "8-bit Greyscale"; break;
1143 case V4L2_PIX_FMT_Y4: descr = "4-bit Greyscale"; break;
1144 case V4L2_PIX_FMT_Y6: descr = "6-bit Greyscale"; break;
1145 case V4L2_PIX_FMT_Y10: descr = "10-bit Greyscale"; break;
1146 case V4L2_PIX_FMT_Y12: descr = "12-bit Greyscale"; break;
1147 case V4L2_PIX_FMT_Y16: descr = "16-bit Greyscale"; break;
1148 case V4L2_PIX_FMT_Y16_BE: descr = "16-bit Greyscale BE"; break;
1149 case V4L2_PIX_FMT_Y10BPACK: descr = "10-bit Greyscale (Packed)"; break;
1150 case V4L2_PIX_FMT_Y8I: descr = "Interleaved 8-bit Greyscale"; break;
1151 case V4L2_PIX_FMT_Y12I: descr = "Interleaved 12-bit Greyscale"; break;
1152 case V4L2_PIX_FMT_Z16: descr = "16-bit Depth"; break;
1153 case V4L2_PIX_FMT_INZI: descr = "Planar 10:16 Greyscale Depth"; break;
1154 case V4L2_PIX_FMT_PAL8: descr = "8-bit Palette"; break;
1155 case V4L2_PIX_FMT_UV8: descr = "8-bit Chrominance UV 4-4"; break;
1156 case V4L2_PIX_FMT_YVU410: descr = "Planar YVU 4:1:0"; break;
1157 case V4L2_PIX_FMT_YVU420: descr = "Planar YVU 4:2:0"; break;
1158 case V4L2_PIX_FMT_YUYV: descr = "YUYV 4:2:2"; break;
1159 case V4L2_PIX_FMT_YYUV: descr = "YYUV 4:2:2"; break;
1160 case V4L2_PIX_FMT_YVYU: descr = "YVYU 4:2:2"; break;
1161 case V4L2_PIX_FMT_UYVY: descr = "UYVY 4:2:2"; break;
1162 case V4L2_PIX_FMT_VYUY: descr = "VYUY 4:2:2"; break;
1163 case V4L2_PIX_FMT_YUV422P: descr = "Planar YUV 4:2:2"; break;
1164 case V4L2_PIX_FMT_YUV411P: descr = "Planar YUV 4:1:1"; break;
1165 case V4L2_PIX_FMT_Y41P: descr = "YUV 4:1:1 (Packed)"; break;
1166 case V4L2_PIX_FMT_YUV444: descr = "16-bit A/XYUV 4-4-4-4"; break;
1167 case V4L2_PIX_FMT_YUV555: descr = "16-bit A/XYUV 1-5-5-5"; break;
1168 case V4L2_PIX_FMT_YUV565: descr = "16-bit YUV 5-6-5"; break;
1169 case V4L2_PIX_FMT_YUV32: descr = "32-bit A/XYUV 8-8-8-8"; break;
1170 case V4L2_PIX_FMT_YUV410: descr = "Planar YUV 4:1:0"; break;
1171 case V4L2_PIX_FMT_YUV420: descr = "Planar YUV 4:2:0"; break;
1172 case V4L2_PIX_FMT_HI240: descr = "8-bit Dithered RGB (BTTV)"; break;
1173 case V4L2_PIX_FMT_HM12: descr = "YUV 4:2:0 (16x16 Macroblocks)"; break;
1174 case V4L2_PIX_FMT_M420: descr = "YUV 4:2:0 (M420)"; break;
1175 case V4L2_PIX_FMT_NV12: descr = "Y/CbCr 4:2:0"; break;
1176 case V4L2_PIX_FMT_NV21: descr = "Y/CrCb 4:2:0"; break;
1177 case V4L2_PIX_FMT_NV16: descr = "Y/CbCr 4:2:2"; break;
1178 case V4L2_PIX_FMT_NV61: descr = "Y/CrCb 4:2:2"; break;
1179 case V4L2_PIX_FMT_NV24: descr = "Y/CbCr 4:4:4"; break;
1180 case V4L2_PIX_FMT_NV42: descr = "Y/CrCb 4:4:4"; break;
1181 case V4L2_PIX_FMT_NV12M: descr = "Y/CbCr 4:2:0 (N-C)"; break;
1182 case V4L2_PIX_FMT_NV21M: descr = "Y/CrCb 4:2:0 (N-C)"; break;
1183 case V4L2_PIX_FMT_NV16M: descr = "Y/CbCr 4:2:2 (N-C)"; break;
1184 case V4L2_PIX_FMT_NV61M: descr = "Y/CrCb 4:2:2 (N-C)"; break;
1185 case V4L2_PIX_FMT_NV12MT: descr = "Y/CbCr 4:2:0 (64x32 MB, N-C)"; break;
1186 case V4L2_PIX_FMT_NV12MT_16X16: descr = "Y/CbCr 4:2:0 (16x16 MB, N-C)"; break;
1187 case V4L2_PIX_FMT_YUV420M: descr = "Planar YUV 4:2:0 (N-C)"; break;
1188 case V4L2_PIX_FMT_YVU420M: descr = "Planar YVU 4:2:0 (N-C)"; break;
1189 case V4L2_PIX_FMT_YUV422M: descr = "Planar YUV 4:2:2 (N-C)"; break;
1190 case V4L2_PIX_FMT_YVU422M: descr = "Planar YVU 4:2:2 (N-C)"; break;
1191 case V4L2_PIX_FMT_YUV444M: descr = "Planar YUV 4:4:4 (N-C)"; break;
1192 case V4L2_PIX_FMT_YVU444M: descr = "Planar YVU 4:4:4 (N-C)"; break;
1193 case V4L2_PIX_FMT_SBGGR8: descr = "8-bit Bayer BGBG/GRGR"; break;
1194 case V4L2_PIX_FMT_SGBRG8: descr = "8-bit Bayer GBGB/RGRG"; break;
1195 case V4L2_PIX_FMT_SGRBG8: descr = "8-bit Bayer GRGR/BGBG"; break;
1196 case V4L2_PIX_FMT_SRGGB8: descr = "8-bit Bayer RGRG/GBGB"; break;
1197 case V4L2_PIX_FMT_SBGGR10: descr = "10-bit Bayer BGBG/GRGR"; break;
1198 case V4L2_PIX_FMT_SGBRG10: descr = "10-bit Bayer GBGB/RGRG"; break;
1199 case V4L2_PIX_FMT_SGRBG10: descr = "10-bit Bayer GRGR/BGBG"; break;
1200 case V4L2_PIX_FMT_SRGGB10: descr = "10-bit Bayer RGRG/GBGB"; break;
1201 case V4L2_PIX_FMT_SBGGR10P: descr = "10-bit Bayer BGBG/GRGR Packed"; break;
1202 case V4L2_PIX_FMT_SGBRG10P: descr = "10-bit Bayer GBGB/RGRG Packed"; break;
1203 case V4L2_PIX_FMT_SGRBG10P: descr = "10-bit Bayer GRGR/BGBG Packed"; break;
1204 case V4L2_PIX_FMT_SRGGB10P: descr = "10-bit Bayer RGRG/GBGB Packed"; break;
1205 case V4L2_PIX_FMT_IPU3_SBGGR10: descr = "10-bit bayer BGGR IPU3 Packed"; break;
1206 case V4L2_PIX_FMT_IPU3_SGBRG10: descr = "10-bit bayer GBRG IPU3 Packed"; break;
1207 case V4L2_PIX_FMT_IPU3_SGRBG10: descr = "10-bit bayer GRBG IPU3 Packed"; break;
1208 case V4L2_PIX_FMT_IPU3_SRGGB10: descr = "10-bit bayer RGGB IPU3 Packed"; break;
1209 case V4L2_PIX_FMT_SBGGR10ALAW8: descr = "8-bit Bayer BGBG/GRGR (A-law)"; break;
1210 case V4L2_PIX_FMT_SGBRG10ALAW8: descr = "8-bit Bayer GBGB/RGRG (A-law)"; break;
1211 case V4L2_PIX_FMT_SGRBG10ALAW8: descr = "8-bit Bayer GRGR/BGBG (A-law)"; break;
1212 case V4L2_PIX_FMT_SRGGB10ALAW8: descr = "8-bit Bayer RGRG/GBGB (A-law)"; break;
1213 case V4L2_PIX_FMT_SBGGR10DPCM8: descr = "8-bit Bayer BGBG/GRGR (DPCM)"; break;
1214 case V4L2_PIX_FMT_SGBRG10DPCM8: descr = "8-bit Bayer GBGB/RGRG (DPCM)"; break;
1215 case V4L2_PIX_FMT_SGRBG10DPCM8: descr = "8-bit Bayer GRGR/BGBG (DPCM)"; break;
1216 case V4L2_PIX_FMT_SRGGB10DPCM8: descr = "8-bit Bayer RGRG/GBGB (DPCM)"; break;
1217 case V4L2_PIX_FMT_SBGGR12: descr = "12-bit Bayer BGBG/GRGR"; break;
1218 case V4L2_PIX_FMT_SGBRG12: descr = "12-bit Bayer GBGB/RGRG"; break;
1219 case V4L2_PIX_FMT_SGRBG12: descr = "12-bit Bayer GRGR/BGBG"; break;
1220 case V4L2_PIX_FMT_SRGGB12: descr = "12-bit Bayer RGRG/GBGB"; break;
1221 case V4L2_PIX_FMT_SBGGR12P: descr = "12-bit Bayer BGBG/GRGR Packed"; break;
1222 case V4L2_PIX_FMT_SGBRG12P: descr = "12-bit Bayer GBGB/RGRG Packed"; break;
1223 case V4L2_PIX_FMT_SGRBG12P: descr = "12-bit Bayer GRGR/BGBG Packed"; break;
1224 case V4L2_PIX_FMT_SRGGB12P: descr = "12-bit Bayer RGRG/GBGB Packed"; break;
1225 case V4L2_PIX_FMT_SBGGR16: descr = "16-bit Bayer BGBG/GRGR"; break;
1226 case V4L2_PIX_FMT_SGBRG16: descr = "16-bit Bayer GBGB/RGRG"; break;
1227 case V4L2_PIX_FMT_SGRBG16: descr = "16-bit Bayer GRGR/BGBG"; break;
1228 case V4L2_PIX_FMT_SRGGB16: descr = "16-bit Bayer RGRG/GBGB"; break;
1229 case V4L2_PIX_FMT_SN9C20X_I420: descr = "GSPCA SN9C20X I420"; break;
1230 case V4L2_PIX_FMT_SPCA501: descr = "GSPCA SPCA501"; break;
1231 case V4L2_PIX_FMT_SPCA505: descr = "GSPCA SPCA505"; break;
1232 case V4L2_PIX_FMT_SPCA508: descr = "GSPCA SPCA508"; break;
1233 case V4L2_PIX_FMT_STV0680: descr = "GSPCA STV0680"; break;
1234 case V4L2_PIX_FMT_TM6000: descr = "A/V + VBI Mux Packet"; break;
1235 case V4L2_PIX_FMT_CIT_YYVYUY: descr = "GSPCA CIT YYVYUY"; break;
1236 case V4L2_PIX_FMT_KONICA420: descr = "GSPCA KONICA420"; break;
1237 case V4L2_PIX_FMT_HSV24: descr = "24-bit HSV 8-8-8"; break;
1238 case V4L2_PIX_FMT_HSV32: descr = "32-bit XHSV 8-8-8-8"; break;
1239 case V4L2_SDR_FMT_CU8: descr = "Complex U8"; break;
1240 case V4L2_SDR_FMT_CU16LE: descr = "Complex U16LE"; break;
1241 case V4L2_SDR_FMT_CS8: descr = "Complex S8"; break;
1242 case V4L2_SDR_FMT_CS14LE: descr = "Complex S14LE"; break;
1243 case V4L2_SDR_FMT_RU12LE: descr = "Real U12LE"; break;
1244 case V4L2_SDR_FMT_PCU16BE: descr = "Planar Complex U16BE"; break;
1245 case V4L2_SDR_FMT_PCU18BE: descr = "Planar Complex U18BE"; break;
1246 case V4L2_SDR_FMT_PCU20BE: descr = "Planar Complex U20BE"; break;
1247 case V4L2_TCH_FMT_DELTA_TD16: descr = "16-bit signed deltas"; break;
1248 case V4L2_TCH_FMT_DELTA_TD08: descr = "8-bit signed deltas"; break;
1249 case V4L2_TCH_FMT_TU16: descr = "16-bit unsigned touch data"; break;
1250 case V4L2_TCH_FMT_TU08: descr = "8-bit unsigned touch data"; break;
1251 case V4L2_META_FMT_VSP1_HGO: descr = "R-Car VSP1 1-D Histogram"; break;
1252 case V4L2_META_FMT_VSP1_HGT: descr = "R-Car VSP1 2-D Histogram"; break;
1253 case V4L2_META_FMT_UVC: descr = "UVC payload header metadata"; break;
1255 default:
1256 /* Compressed formats */
1257 flags = V4L2_FMT_FLAG_COMPRESSED;
1258 switch (fmt->pixelformat) {
1259 /* Max description length mask: descr = "0123456789012345678901234567890" */
1260 case V4L2_PIX_FMT_MJPEG: descr = "Motion-JPEG"; break;
1261 case V4L2_PIX_FMT_JPEG: descr = "JFIF JPEG"; break;
1262 case V4L2_PIX_FMT_DV: descr = "1394"; break;
1263 case V4L2_PIX_FMT_MPEG: descr = "MPEG-1/2/4"; break;
1264 case V4L2_PIX_FMT_H264: descr = "H.264"; break;
1265 case V4L2_PIX_FMT_H264_NO_SC: descr = "H.264 (No Start Codes)"; break;
1266 case V4L2_PIX_FMT_H264_MVC: descr = "H.264 MVC"; break;
1267 case V4L2_PIX_FMT_H263: descr = "H.263"; break;
1268 case V4L2_PIX_FMT_MPEG1: descr = "MPEG-1 ES"; break;
1269 case V4L2_PIX_FMT_MPEG2: descr = "MPEG-2 ES"; break;
1270 case V4L2_PIX_FMT_MPEG4: descr = "MPEG-4 part 2 ES"; break;
1271 case V4L2_PIX_FMT_XVID: descr = "Xvid"; break;
1272 case V4L2_PIX_FMT_VC1_ANNEX_G: descr = "VC-1 (SMPTE 412M Annex G)"; break;
1273 case V4L2_PIX_FMT_VC1_ANNEX_L: descr = "VC-1 (SMPTE 412M Annex L)"; break;
1274 case V4L2_PIX_FMT_VP8: descr = "VP8"; break;
1275 case V4L2_PIX_FMT_VP9: descr = "VP9"; break;
1276 case V4L2_PIX_FMT_CPIA1: descr = "GSPCA CPiA YUV"; break;
1277 case V4L2_PIX_FMT_WNVA: descr = "WNVA"; break;
1278 case V4L2_PIX_FMT_SN9C10X: descr = "GSPCA SN9C10X"; break;
1279 case V4L2_PIX_FMT_PWC1: descr = "Raw Philips Webcam Type (Old)"; break;
1280 case V4L2_PIX_FMT_PWC2: descr = "Raw Philips Webcam Type (New)"; break;
1281 case V4L2_PIX_FMT_ET61X251: descr = "GSPCA ET61X251"; break;
1282 case V4L2_PIX_FMT_SPCA561: descr = "GSPCA SPCA561"; break;
1283 case V4L2_PIX_FMT_PAC207: descr = "GSPCA PAC207"; break;
1284 case V4L2_PIX_FMT_MR97310A: descr = "GSPCA MR97310A"; break;
1285 case V4L2_PIX_FMT_JL2005BCD: descr = "GSPCA JL2005BCD"; break;
1286 case V4L2_PIX_FMT_SN9C2028: descr = "GSPCA SN9C2028"; break;
1287 case V4L2_PIX_FMT_SQ905C: descr = "GSPCA SQ905C"; break;
1288 case V4L2_PIX_FMT_PJPG: descr = "GSPCA PJPG"; break;
1289 case V4L2_PIX_FMT_OV511: descr = "GSPCA OV511"; break;
1290 case V4L2_PIX_FMT_OV518: descr = "GSPCA OV518"; break;
1291 case V4L2_PIX_FMT_JPGL: descr = "JPEG Lite"; break;
1292 case V4L2_PIX_FMT_SE401: descr = "GSPCA SE401"; break;
1293 case V4L2_PIX_FMT_S5C_UYVY_JPG: descr = "S5C73MX interleaved UYVY/JPEG"; break;
1294 case V4L2_PIX_FMT_MT21C: descr = "Mediatek Compressed Format"; break;
1295 default:
1296 WARN(1, "Unknown pixelformat 0x%08x\n", fmt->pixelformat);
1297 if (fmt->description[0])
1298 return;
1299 flags = 0;
1300 snprintf(fmt->description, sz, "%c%c%c%c%s",
1301 (char)(fmt->pixelformat & 0x7f),
1302 (char)((fmt->pixelformat >> 8) & 0x7f),
1303 (char)((fmt->pixelformat >> 16) & 0x7f),
1304 (char)((fmt->pixelformat >> 24) & 0x7f),
1305 (fmt->pixelformat & (1 << 31)) ? "-BE" : "");
1306 break;
1310 if (descr)
1311 WARN_ON(strlcpy(fmt->description, descr, sz) >= sz);
1312 fmt->flags = flags;
1315 static int v4l_enum_fmt(const struct v4l2_ioctl_ops *ops,
1316 struct file *file, void *fh, void *arg)
1318 struct v4l2_fmtdesc *p = arg;
1319 int ret = check_fmt(file, p->type);
1321 if (ret)
1322 return ret;
1323 ret = -EINVAL;
1325 switch (p->type) {
1326 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1327 if (unlikely(!ops->vidioc_enum_fmt_vid_cap))
1328 break;
1329 ret = ops->vidioc_enum_fmt_vid_cap(file, fh, arg);
1330 break;
1331 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1332 if (unlikely(!ops->vidioc_enum_fmt_vid_cap_mplane))
1333 break;
1334 ret = ops->vidioc_enum_fmt_vid_cap_mplane(file, fh, arg);
1335 break;
1336 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1337 if (unlikely(!ops->vidioc_enum_fmt_vid_overlay))
1338 break;
1339 ret = ops->vidioc_enum_fmt_vid_overlay(file, fh, arg);
1340 break;
1341 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1342 if (unlikely(!ops->vidioc_enum_fmt_vid_out))
1343 break;
1344 ret = ops->vidioc_enum_fmt_vid_out(file, fh, arg);
1345 break;
1346 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1347 if (unlikely(!ops->vidioc_enum_fmt_vid_out_mplane))
1348 break;
1349 ret = ops->vidioc_enum_fmt_vid_out_mplane(file, fh, arg);
1350 break;
1351 case V4L2_BUF_TYPE_SDR_CAPTURE:
1352 if (unlikely(!ops->vidioc_enum_fmt_sdr_cap))
1353 break;
1354 ret = ops->vidioc_enum_fmt_sdr_cap(file, fh, arg);
1355 break;
1356 case V4L2_BUF_TYPE_SDR_OUTPUT:
1357 if (unlikely(!ops->vidioc_enum_fmt_sdr_out))
1358 break;
1359 ret = ops->vidioc_enum_fmt_sdr_out(file, fh, arg);
1360 break;
1361 case V4L2_BUF_TYPE_META_CAPTURE:
1362 if (unlikely(!ops->vidioc_enum_fmt_meta_cap))
1363 break;
1364 ret = ops->vidioc_enum_fmt_meta_cap(file, fh, arg);
1365 break;
1367 if (ret == 0)
1368 v4l_fill_fmtdesc(p);
1369 return ret;
1372 static int v4l_g_fmt(const struct v4l2_ioctl_ops *ops,
1373 struct file *file, void *fh, void *arg)
1375 struct v4l2_format *p = arg;
1376 int ret = check_fmt(file, p->type);
1378 if (ret)
1379 return ret;
1382 * fmt can't be cleared for these overlay types due to the 'clips'
1383 * 'clipcount' and 'bitmap' pointers in struct v4l2_window.
1384 * Those are provided by the user. So handle these two overlay types
1385 * first, and then just do a simple memset for the other types.
1387 switch (p->type) {
1388 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1389 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY: {
1390 struct v4l2_clip __user *clips = p->fmt.win.clips;
1391 u32 clipcount = p->fmt.win.clipcount;
1392 void __user *bitmap = p->fmt.win.bitmap;
1394 memset(&p->fmt, 0, sizeof(p->fmt));
1395 p->fmt.win.clips = clips;
1396 p->fmt.win.clipcount = clipcount;
1397 p->fmt.win.bitmap = bitmap;
1398 break;
1400 default:
1401 memset(&p->fmt, 0, sizeof(p->fmt));
1402 break;
1405 switch (p->type) {
1406 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1407 if (unlikely(!ops->vidioc_g_fmt_vid_cap))
1408 break;
1409 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1410 ret = ops->vidioc_g_fmt_vid_cap(file, fh, arg);
1411 /* just in case the driver zeroed it again */
1412 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1413 return ret;
1414 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1415 return ops->vidioc_g_fmt_vid_cap_mplane(file, fh, arg);
1416 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1417 return ops->vidioc_g_fmt_vid_overlay(file, fh, arg);
1418 case V4L2_BUF_TYPE_VBI_CAPTURE:
1419 return ops->vidioc_g_fmt_vbi_cap(file, fh, arg);
1420 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1421 return ops->vidioc_g_fmt_sliced_vbi_cap(file, fh, arg);
1422 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1423 if (unlikely(!ops->vidioc_g_fmt_vid_out))
1424 break;
1425 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1426 ret = ops->vidioc_g_fmt_vid_out(file, fh, arg);
1427 /* just in case the driver zeroed it again */
1428 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1429 return ret;
1430 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1431 return ops->vidioc_g_fmt_vid_out_mplane(file, fh, arg);
1432 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1433 return ops->vidioc_g_fmt_vid_out_overlay(file, fh, arg);
1434 case V4L2_BUF_TYPE_VBI_OUTPUT:
1435 return ops->vidioc_g_fmt_vbi_out(file, fh, arg);
1436 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1437 return ops->vidioc_g_fmt_sliced_vbi_out(file, fh, arg);
1438 case V4L2_BUF_TYPE_SDR_CAPTURE:
1439 return ops->vidioc_g_fmt_sdr_cap(file, fh, arg);
1440 case V4L2_BUF_TYPE_SDR_OUTPUT:
1441 return ops->vidioc_g_fmt_sdr_out(file, fh, arg);
1442 case V4L2_BUF_TYPE_META_CAPTURE:
1443 return ops->vidioc_g_fmt_meta_cap(file, fh, arg);
1445 return -EINVAL;
1448 static void v4l_pix_format_touch(struct v4l2_pix_format *p)
1451 * The v4l2_pix_format structure contains fields that make no sense for
1452 * touch. Set them to default values in this case.
1455 p->field = V4L2_FIELD_NONE;
1456 p->colorspace = V4L2_COLORSPACE_RAW;
1457 p->flags = 0;
1458 p->ycbcr_enc = 0;
1459 p->quantization = 0;
1460 p->xfer_func = 0;
1463 static int v4l_s_fmt(const struct v4l2_ioctl_ops *ops,
1464 struct file *file, void *fh, void *arg)
1466 struct v4l2_format *p = arg;
1467 struct video_device *vfd = video_devdata(file);
1468 int ret = check_fmt(file, p->type);
1470 if (ret)
1471 return ret;
1473 ret = v4l_enable_media_source(vfd);
1474 if (ret)
1475 return ret;
1476 v4l_sanitize_format(p);
1478 switch (p->type) {
1479 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1480 if (unlikely(!ops->vidioc_s_fmt_vid_cap))
1481 break;
1482 CLEAR_AFTER_FIELD(p, fmt.pix);
1483 ret = ops->vidioc_s_fmt_vid_cap(file, fh, arg);
1484 /* just in case the driver zeroed it again */
1485 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1486 if (vfd->vfl_type == VFL_TYPE_TOUCH)
1487 v4l_pix_format_touch(&p->fmt.pix);
1488 return ret;
1489 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1490 if (unlikely(!ops->vidioc_s_fmt_vid_cap_mplane))
1491 break;
1492 CLEAR_AFTER_FIELD(p, fmt.pix_mp.xfer_func);
1493 return ops->vidioc_s_fmt_vid_cap_mplane(file, fh, arg);
1494 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1495 if (unlikely(!ops->vidioc_s_fmt_vid_overlay))
1496 break;
1497 CLEAR_AFTER_FIELD(p, fmt.win);
1498 return ops->vidioc_s_fmt_vid_overlay(file, fh, arg);
1499 case V4L2_BUF_TYPE_VBI_CAPTURE:
1500 if (unlikely(!ops->vidioc_s_fmt_vbi_cap))
1501 break;
1502 CLEAR_AFTER_FIELD(p, fmt.vbi);
1503 return ops->vidioc_s_fmt_vbi_cap(file, fh, arg);
1504 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1505 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_cap))
1506 break;
1507 CLEAR_AFTER_FIELD(p, fmt.sliced);
1508 return ops->vidioc_s_fmt_sliced_vbi_cap(file, fh, arg);
1509 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1510 if (unlikely(!ops->vidioc_s_fmt_vid_out))
1511 break;
1512 CLEAR_AFTER_FIELD(p, fmt.pix);
1513 ret = ops->vidioc_s_fmt_vid_out(file, fh, arg);
1514 /* just in case the driver zeroed it again */
1515 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1516 return ret;
1517 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1518 if (unlikely(!ops->vidioc_s_fmt_vid_out_mplane))
1519 break;
1520 CLEAR_AFTER_FIELD(p, fmt.pix_mp.xfer_func);
1521 return ops->vidioc_s_fmt_vid_out_mplane(file, fh, arg);
1522 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1523 if (unlikely(!ops->vidioc_s_fmt_vid_out_overlay))
1524 break;
1525 CLEAR_AFTER_FIELD(p, fmt.win);
1526 return ops->vidioc_s_fmt_vid_out_overlay(file, fh, arg);
1527 case V4L2_BUF_TYPE_VBI_OUTPUT:
1528 if (unlikely(!ops->vidioc_s_fmt_vbi_out))
1529 break;
1530 CLEAR_AFTER_FIELD(p, fmt.vbi);
1531 return ops->vidioc_s_fmt_vbi_out(file, fh, arg);
1532 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1533 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_out))
1534 break;
1535 CLEAR_AFTER_FIELD(p, fmt.sliced);
1536 return ops->vidioc_s_fmt_sliced_vbi_out(file, fh, arg);
1537 case V4L2_BUF_TYPE_SDR_CAPTURE:
1538 if (unlikely(!ops->vidioc_s_fmt_sdr_cap))
1539 break;
1540 CLEAR_AFTER_FIELD(p, fmt.sdr);
1541 return ops->vidioc_s_fmt_sdr_cap(file, fh, arg);
1542 case V4L2_BUF_TYPE_SDR_OUTPUT:
1543 if (unlikely(!ops->vidioc_s_fmt_sdr_out))
1544 break;
1545 CLEAR_AFTER_FIELD(p, fmt.sdr);
1546 return ops->vidioc_s_fmt_sdr_out(file, fh, arg);
1547 case V4L2_BUF_TYPE_META_CAPTURE:
1548 if (unlikely(!ops->vidioc_s_fmt_meta_cap))
1549 break;
1550 CLEAR_AFTER_FIELD(p, fmt.meta);
1551 return ops->vidioc_s_fmt_meta_cap(file, fh, arg);
1553 return -EINVAL;
1556 static int v4l_try_fmt(const struct v4l2_ioctl_ops *ops,
1557 struct file *file, void *fh, void *arg)
1559 struct v4l2_format *p = arg;
1560 int ret = check_fmt(file, p->type);
1562 if (ret)
1563 return ret;
1565 v4l_sanitize_format(p);
1567 switch (p->type) {
1568 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1569 if (unlikely(!ops->vidioc_try_fmt_vid_cap))
1570 break;
1571 CLEAR_AFTER_FIELD(p, fmt.pix);
1572 ret = ops->vidioc_try_fmt_vid_cap(file, fh, arg);
1573 /* just in case the driver zeroed it again */
1574 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1575 return ret;
1576 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1577 if (unlikely(!ops->vidioc_try_fmt_vid_cap_mplane))
1578 break;
1579 CLEAR_AFTER_FIELD(p, fmt.pix_mp.xfer_func);
1580 return ops->vidioc_try_fmt_vid_cap_mplane(file, fh, arg);
1581 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1582 if (unlikely(!ops->vidioc_try_fmt_vid_overlay))
1583 break;
1584 CLEAR_AFTER_FIELD(p, fmt.win);
1585 return ops->vidioc_try_fmt_vid_overlay(file, fh, arg);
1586 case V4L2_BUF_TYPE_VBI_CAPTURE:
1587 if (unlikely(!ops->vidioc_try_fmt_vbi_cap))
1588 break;
1589 CLEAR_AFTER_FIELD(p, fmt.vbi);
1590 return ops->vidioc_try_fmt_vbi_cap(file, fh, arg);
1591 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1592 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_cap))
1593 break;
1594 CLEAR_AFTER_FIELD(p, fmt.sliced);
1595 return ops->vidioc_try_fmt_sliced_vbi_cap(file, fh, arg);
1596 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1597 if (unlikely(!ops->vidioc_try_fmt_vid_out))
1598 break;
1599 CLEAR_AFTER_FIELD(p, fmt.pix);
1600 ret = ops->vidioc_try_fmt_vid_out(file, fh, arg);
1601 /* just in case the driver zeroed it again */
1602 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1603 return ret;
1604 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1605 if (unlikely(!ops->vidioc_try_fmt_vid_out_mplane))
1606 break;
1607 CLEAR_AFTER_FIELD(p, fmt.pix_mp.xfer_func);
1608 return ops->vidioc_try_fmt_vid_out_mplane(file, fh, arg);
1609 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1610 if (unlikely(!ops->vidioc_try_fmt_vid_out_overlay))
1611 break;
1612 CLEAR_AFTER_FIELD(p, fmt.win);
1613 return ops->vidioc_try_fmt_vid_out_overlay(file, fh, arg);
1614 case V4L2_BUF_TYPE_VBI_OUTPUT:
1615 if (unlikely(!ops->vidioc_try_fmt_vbi_out))
1616 break;
1617 CLEAR_AFTER_FIELD(p, fmt.vbi);
1618 return ops->vidioc_try_fmt_vbi_out(file, fh, arg);
1619 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1620 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_out))
1621 break;
1622 CLEAR_AFTER_FIELD(p, fmt.sliced);
1623 return ops->vidioc_try_fmt_sliced_vbi_out(file, fh, arg);
1624 case V4L2_BUF_TYPE_SDR_CAPTURE:
1625 if (unlikely(!ops->vidioc_try_fmt_sdr_cap))
1626 break;
1627 CLEAR_AFTER_FIELD(p, fmt.sdr);
1628 return ops->vidioc_try_fmt_sdr_cap(file, fh, arg);
1629 case V4L2_BUF_TYPE_SDR_OUTPUT:
1630 if (unlikely(!ops->vidioc_try_fmt_sdr_out))
1631 break;
1632 CLEAR_AFTER_FIELD(p, fmt.sdr);
1633 return ops->vidioc_try_fmt_sdr_out(file, fh, arg);
1634 case V4L2_BUF_TYPE_META_CAPTURE:
1635 if (unlikely(!ops->vidioc_try_fmt_meta_cap))
1636 break;
1637 CLEAR_AFTER_FIELD(p, fmt.meta);
1638 return ops->vidioc_try_fmt_meta_cap(file, fh, arg);
1640 return -EINVAL;
1643 static int v4l_streamon(const struct v4l2_ioctl_ops *ops,
1644 struct file *file, void *fh, void *arg)
1646 return ops->vidioc_streamon(file, fh, *(unsigned int *)arg);
1649 static int v4l_streamoff(const struct v4l2_ioctl_ops *ops,
1650 struct file *file, void *fh, void *arg)
1652 return ops->vidioc_streamoff(file, fh, *(unsigned int *)arg);
1655 static int v4l_g_tuner(const struct v4l2_ioctl_ops *ops,
1656 struct file *file, void *fh, void *arg)
1658 struct video_device *vfd = video_devdata(file);
1659 struct v4l2_tuner *p = arg;
1660 int err;
1662 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1663 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1664 err = ops->vidioc_g_tuner(file, fh, p);
1665 if (!err)
1666 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1667 return err;
1670 static int v4l_s_tuner(const struct v4l2_ioctl_ops *ops,
1671 struct file *file, void *fh, void *arg)
1673 struct video_device *vfd = video_devdata(file);
1674 struct v4l2_tuner *p = arg;
1675 int ret;
1677 ret = v4l_enable_media_source(vfd);
1678 if (ret)
1679 return ret;
1680 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1681 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1682 return ops->vidioc_s_tuner(file, fh, p);
1685 static int v4l_g_modulator(const struct v4l2_ioctl_ops *ops,
1686 struct file *file, void *fh, void *arg)
1688 struct video_device *vfd = video_devdata(file);
1689 struct v4l2_modulator *p = arg;
1690 int err;
1692 if (vfd->vfl_type == VFL_TYPE_RADIO)
1693 p->type = V4L2_TUNER_RADIO;
1695 err = ops->vidioc_g_modulator(file, fh, p);
1696 if (!err)
1697 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1698 return err;
1701 static int v4l_s_modulator(const struct v4l2_ioctl_ops *ops,
1702 struct file *file, void *fh, void *arg)
1704 struct video_device *vfd = video_devdata(file);
1705 struct v4l2_modulator *p = arg;
1707 if (vfd->vfl_type == VFL_TYPE_RADIO)
1708 p->type = V4L2_TUNER_RADIO;
1710 return ops->vidioc_s_modulator(file, fh, p);
1713 static int v4l_g_frequency(const struct v4l2_ioctl_ops *ops,
1714 struct file *file, void *fh, void *arg)
1716 struct video_device *vfd = video_devdata(file);
1717 struct v4l2_frequency *p = arg;
1719 if (vfd->vfl_type == VFL_TYPE_SDR)
1720 p->type = V4L2_TUNER_SDR;
1721 else
1722 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1723 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1724 return ops->vidioc_g_frequency(file, fh, p);
1727 static int v4l_s_frequency(const struct v4l2_ioctl_ops *ops,
1728 struct file *file, void *fh, void *arg)
1730 struct video_device *vfd = video_devdata(file);
1731 const struct v4l2_frequency *p = arg;
1732 enum v4l2_tuner_type type;
1733 int ret;
1735 ret = v4l_enable_media_source(vfd);
1736 if (ret)
1737 return ret;
1738 if (vfd->vfl_type == VFL_TYPE_SDR) {
1739 if (p->type != V4L2_TUNER_SDR && p->type != V4L2_TUNER_RF)
1740 return -EINVAL;
1741 } else {
1742 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1743 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1744 if (type != p->type)
1745 return -EINVAL;
1747 return ops->vidioc_s_frequency(file, fh, p);
1750 static int v4l_enumstd(const struct v4l2_ioctl_ops *ops,
1751 struct file *file, void *fh, void *arg)
1753 struct video_device *vfd = video_devdata(file);
1754 struct v4l2_standard *p = arg;
1755 v4l2_std_id id = vfd->tvnorms, curr_id = 0;
1756 unsigned int index = p->index, i, j = 0;
1757 const char *descr = "";
1759 /* Return -ENODATA if the tvnorms for the current input
1760 or output is 0, meaning that it doesn't support this API. */
1761 if (id == 0)
1762 return -ENODATA;
1764 /* Return norm array in a canonical way */
1765 for (i = 0; i <= index && id; i++) {
1766 /* last std value in the standards array is 0, so this
1767 while always ends there since (id & 0) == 0. */
1768 while ((id & standards[j].std) != standards[j].std)
1769 j++;
1770 curr_id = standards[j].std;
1771 descr = standards[j].descr;
1772 j++;
1773 if (curr_id == 0)
1774 break;
1775 if (curr_id != V4L2_STD_PAL &&
1776 curr_id != V4L2_STD_SECAM &&
1777 curr_id != V4L2_STD_NTSC)
1778 id &= ~curr_id;
1780 if (i <= index)
1781 return -EINVAL;
1783 v4l2_video_std_construct(p, curr_id, descr);
1784 return 0;
1787 static int v4l_s_std(const struct v4l2_ioctl_ops *ops,
1788 struct file *file, void *fh, void *arg)
1790 struct video_device *vfd = video_devdata(file);
1791 v4l2_std_id id = *(v4l2_std_id *)arg, norm;
1792 int ret;
1794 ret = v4l_enable_media_source(vfd);
1795 if (ret)
1796 return ret;
1797 norm = id & vfd->tvnorms;
1798 if (vfd->tvnorms && !norm) /* Check if std is supported */
1799 return -EINVAL;
1801 /* Calls the specific handler */
1802 return ops->vidioc_s_std(file, fh, norm);
1805 static int v4l_querystd(const struct v4l2_ioctl_ops *ops,
1806 struct file *file, void *fh, void *arg)
1808 struct video_device *vfd = video_devdata(file);
1809 v4l2_std_id *p = arg;
1810 int ret;
1812 ret = v4l_enable_media_source(vfd);
1813 if (ret)
1814 return ret;
1816 * If no signal is detected, then the driver should return
1817 * V4L2_STD_UNKNOWN. Otherwise it should return tvnorms with
1818 * any standards that do not apply removed.
1820 * This means that tuners, audio and video decoders can join
1821 * their efforts to improve the standards detection.
1823 *p = vfd->tvnorms;
1824 return ops->vidioc_querystd(file, fh, arg);
1827 static int v4l_s_hw_freq_seek(const struct v4l2_ioctl_ops *ops,
1828 struct file *file, void *fh, void *arg)
1830 struct video_device *vfd = video_devdata(file);
1831 struct v4l2_hw_freq_seek *p = arg;
1832 enum v4l2_tuner_type type;
1833 int ret;
1835 ret = v4l_enable_media_source(vfd);
1836 if (ret)
1837 return ret;
1838 /* s_hw_freq_seek is not supported for SDR for now */
1839 if (vfd->vfl_type == VFL_TYPE_SDR)
1840 return -EINVAL;
1842 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1843 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1844 if (p->type != type)
1845 return -EINVAL;
1846 return ops->vidioc_s_hw_freq_seek(file, fh, p);
1849 static int v4l_overlay(const struct v4l2_ioctl_ops *ops,
1850 struct file *file, void *fh, void *arg)
1852 return ops->vidioc_overlay(file, fh, *(unsigned int *)arg);
1855 static int v4l_reqbufs(const struct v4l2_ioctl_ops *ops,
1856 struct file *file, void *fh, void *arg)
1858 struct v4l2_requestbuffers *p = arg;
1859 int ret = check_fmt(file, p->type);
1861 if (ret)
1862 return ret;
1864 CLEAR_AFTER_FIELD(p, memory);
1866 return ops->vidioc_reqbufs(file, fh, p);
1869 static int v4l_querybuf(const struct v4l2_ioctl_ops *ops,
1870 struct file *file, void *fh, void *arg)
1872 struct v4l2_buffer *p = arg;
1873 int ret = check_fmt(file, p->type);
1875 return ret ? ret : ops->vidioc_querybuf(file, fh, p);
1878 static int v4l_qbuf(const struct v4l2_ioctl_ops *ops,
1879 struct file *file, void *fh, void *arg)
1881 struct v4l2_buffer *p = arg;
1882 int ret = check_fmt(file, p->type);
1884 return ret ? ret : ops->vidioc_qbuf(file, fh, p);
1887 static int v4l_dqbuf(const struct v4l2_ioctl_ops *ops,
1888 struct file *file, void *fh, void *arg)
1890 struct v4l2_buffer *p = arg;
1891 int ret = check_fmt(file, p->type);
1893 return ret ? ret : ops->vidioc_dqbuf(file, fh, p);
1896 static int v4l_create_bufs(const struct v4l2_ioctl_ops *ops,
1897 struct file *file, void *fh, void *arg)
1899 struct v4l2_create_buffers *create = arg;
1900 int ret = check_fmt(file, create->format.type);
1902 if (ret)
1903 return ret;
1905 CLEAR_AFTER_FIELD(create, format);
1907 v4l_sanitize_format(&create->format);
1909 ret = ops->vidioc_create_bufs(file, fh, create);
1911 if (create->format.type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
1912 create->format.type == V4L2_BUF_TYPE_VIDEO_OUTPUT)
1913 create->format.fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1915 return ret;
1918 static int v4l_prepare_buf(const struct v4l2_ioctl_ops *ops,
1919 struct file *file, void *fh, void *arg)
1921 struct v4l2_buffer *b = arg;
1922 int ret = check_fmt(file, b->type);
1924 return ret ? ret : ops->vidioc_prepare_buf(file, fh, b);
1927 static int v4l_g_parm(const struct v4l2_ioctl_ops *ops,
1928 struct file *file, void *fh, void *arg)
1930 struct v4l2_streamparm *p = arg;
1931 v4l2_std_id std;
1932 int ret = check_fmt(file, p->type);
1934 if (ret)
1935 return ret;
1936 if (ops->vidioc_g_parm)
1937 return ops->vidioc_g_parm(file, fh, p);
1938 if (p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
1939 p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
1940 return -EINVAL;
1941 p->parm.capture.readbuffers = 2;
1942 ret = ops->vidioc_g_std(file, fh, &std);
1943 if (ret == 0)
1944 v4l2_video_std_frame_period(std, &p->parm.capture.timeperframe);
1945 return ret;
1948 static int v4l_s_parm(const struct v4l2_ioctl_ops *ops,
1949 struct file *file, void *fh, void *arg)
1951 struct v4l2_streamparm *p = arg;
1952 int ret = check_fmt(file, p->type);
1954 return ret ? ret : ops->vidioc_s_parm(file, fh, p);
1957 static int v4l_queryctrl(const struct v4l2_ioctl_ops *ops,
1958 struct file *file, void *fh, void *arg)
1960 struct video_device *vfd = video_devdata(file);
1961 struct v4l2_queryctrl *p = arg;
1962 struct v4l2_fh *vfh =
1963 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1965 if (vfh && vfh->ctrl_handler)
1966 return v4l2_queryctrl(vfh->ctrl_handler, p);
1967 if (vfd->ctrl_handler)
1968 return v4l2_queryctrl(vfd->ctrl_handler, p);
1969 if (ops->vidioc_queryctrl)
1970 return ops->vidioc_queryctrl(file, fh, p);
1971 return -ENOTTY;
1974 static int v4l_query_ext_ctrl(const struct v4l2_ioctl_ops *ops,
1975 struct file *file, void *fh, void *arg)
1977 struct video_device *vfd = video_devdata(file);
1978 struct v4l2_query_ext_ctrl *p = arg;
1979 struct v4l2_fh *vfh =
1980 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1982 if (vfh && vfh->ctrl_handler)
1983 return v4l2_query_ext_ctrl(vfh->ctrl_handler, p);
1984 if (vfd->ctrl_handler)
1985 return v4l2_query_ext_ctrl(vfd->ctrl_handler, p);
1986 if (ops->vidioc_query_ext_ctrl)
1987 return ops->vidioc_query_ext_ctrl(file, fh, p);
1988 return -ENOTTY;
1991 static int v4l_querymenu(const struct v4l2_ioctl_ops *ops,
1992 struct file *file, void *fh, void *arg)
1994 struct video_device *vfd = video_devdata(file);
1995 struct v4l2_querymenu *p = arg;
1996 struct v4l2_fh *vfh =
1997 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1999 if (vfh && vfh->ctrl_handler)
2000 return v4l2_querymenu(vfh->ctrl_handler, p);
2001 if (vfd->ctrl_handler)
2002 return v4l2_querymenu(vfd->ctrl_handler, p);
2003 if (ops->vidioc_querymenu)
2004 return ops->vidioc_querymenu(file, fh, p);
2005 return -ENOTTY;
2008 static int v4l_g_ctrl(const struct v4l2_ioctl_ops *ops,
2009 struct file *file, void *fh, void *arg)
2011 struct video_device *vfd = video_devdata(file);
2012 struct v4l2_control *p = arg;
2013 struct v4l2_fh *vfh =
2014 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2015 struct v4l2_ext_controls ctrls;
2016 struct v4l2_ext_control ctrl;
2018 if (vfh && vfh->ctrl_handler)
2019 return v4l2_g_ctrl(vfh->ctrl_handler, p);
2020 if (vfd->ctrl_handler)
2021 return v4l2_g_ctrl(vfd->ctrl_handler, p);
2022 if (ops->vidioc_g_ctrl)
2023 return ops->vidioc_g_ctrl(file, fh, p);
2024 if (ops->vidioc_g_ext_ctrls == NULL)
2025 return -ENOTTY;
2027 ctrls.which = V4L2_CTRL_ID2WHICH(p->id);
2028 ctrls.count = 1;
2029 ctrls.controls = &ctrl;
2030 ctrl.id = p->id;
2031 ctrl.value = p->value;
2032 if (check_ext_ctrls(&ctrls, 1)) {
2033 int ret = ops->vidioc_g_ext_ctrls(file, fh, &ctrls);
2035 if (ret == 0)
2036 p->value = ctrl.value;
2037 return ret;
2039 return -EINVAL;
2042 static int v4l_s_ctrl(const struct v4l2_ioctl_ops *ops,
2043 struct file *file, void *fh, void *arg)
2045 struct video_device *vfd = video_devdata(file);
2046 struct v4l2_control *p = arg;
2047 struct v4l2_fh *vfh =
2048 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2049 struct v4l2_ext_controls ctrls;
2050 struct v4l2_ext_control ctrl;
2052 if (vfh && vfh->ctrl_handler)
2053 return v4l2_s_ctrl(vfh, vfh->ctrl_handler, p);
2054 if (vfd->ctrl_handler)
2055 return v4l2_s_ctrl(NULL, vfd->ctrl_handler, p);
2056 if (ops->vidioc_s_ctrl)
2057 return ops->vidioc_s_ctrl(file, fh, p);
2058 if (ops->vidioc_s_ext_ctrls == NULL)
2059 return -ENOTTY;
2061 ctrls.which = V4L2_CTRL_ID2WHICH(p->id);
2062 ctrls.count = 1;
2063 ctrls.controls = &ctrl;
2064 ctrl.id = p->id;
2065 ctrl.value = p->value;
2066 if (check_ext_ctrls(&ctrls, 1))
2067 return ops->vidioc_s_ext_ctrls(file, fh, &ctrls);
2068 return -EINVAL;
2071 static int v4l_g_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2072 struct file *file, void *fh, void *arg)
2074 struct video_device *vfd = video_devdata(file);
2075 struct v4l2_ext_controls *p = arg;
2076 struct v4l2_fh *vfh =
2077 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2079 p->error_idx = p->count;
2080 if (vfh && vfh->ctrl_handler)
2081 return v4l2_g_ext_ctrls(vfh->ctrl_handler, p);
2082 if (vfd->ctrl_handler)
2083 return v4l2_g_ext_ctrls(vfd->ctrl_handler, p);
2084 if (ops->vidioc_g_ext_ctrls == NULL)
2085 return -ENOTTY;
2086 return check_ext_ctrls(p, 0) ? ops->vidioc_g_ext_ctrls(file, fh, p) :
2087 -EINVAL;
2090 static int v4l_s_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2091 struct file *file, void *fh, void *arg)
2093 struct video_device *vfd = video_devdata(file);
2094 struct v4l2_ext_controls *p = arg;
2095 struct v4l2_fh *vfh =
2096 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2098 p->error_idx = p->count;
2099 if (vfh && vfh->ctrl_handler)
2100 return v4l2_s_ext_ctrls(vfh, vfh->ctrl_handler, p);
2101 if (vfd->ctrl_handler)
2102 return v4l2_s_ext_ctrls(NULL, vfd->ctrl_handler, p);
2103 if (ops->vidioc_s_ext_ctrls == NULL)
2104 return -ENOTTY;
2105 return check_ext_ctrls(p, 0) ? ops->vidioc_s_ext_ctrls(file, fh, p) :
2106 -EINVAL;
2109 static int v4l_try_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2110 struct file *file, void *fh, void *arg)
2112 struct video_device *vfd = video_devdata(file);
2113 struct v4l2_ext_controls *p = arg;
2114 struct v4l2_fh *vfh =
2115 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2117 p->error_idx = p->count;
2118 if (vfh && vfh->ctrl_handler)
2119 return v4l2_try_ext_ctrls(vfh->ctrl_handler, p);
2120 if (vfd->ctrl_handler)
2121 return v4l2_try_ext_ctrls(vfd->ctrl_handler, p);
2122 if (ops->vidioc_try_ext_ctrls == NULL)
2123 return -ENOTTY;
2124 return check_ext_ctrls(p, 0) ? ops->vidioc_try_ext_ctrls(file, fh, p) :
2125 -EINVAL;
2129 * The selection API specified originally that the _MPLANE buffer types
2130 * shouldn't be used. The reasons for this are lost in the mists of time
2131 * (or just really crappy memories). Regardless, this is really annoying
2132 * for userspace. So to keep things simple we map _MPLANE buffer types
2133 * to their 'regular' counterparts before calling the driver. And we
2134 * restore it afterwards. This way applications can use either buffer
2135 * type and drivers don't need to check for both.
2137 static int v4l_g_selection(const struct v4l2_ioctl_ops *ops,
2138 struct file *file, void *fh, void *arg)
2140 struct v4l2_selection *p = arg;
2141 u32 old_type = p->type;
2142 int ret;
2144 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2145 p->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2146 else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
2147 p->type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
2148 ret = ops->vidioc_g_selection(file, fh, p);
2149 p->type = old_type;
2150 return ret;
2153 static int v4l_s_selection(const struct v4l2_ioctl_ops *ops,
2154 struct file *file, void *fh, void *arg)
2156 struct v4l2_selection *p = arg;
2157 u32 old_type = p->type;
2158 int ret;
2160 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2161 p->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2162 else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
2163 p->type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
2164 ret = ops->vidioc_s_selection(file, fh, p);
2165 p->type = old_type;
2166 return ret;
2169 static int v4l_g_crop(const struct v4l2_ioctl_ops *ops,
2170 struct file *file, void *fh, void *arg)
2172 struct v4l2_crop *p = arg;
2173 struct v4l2_selection s = {
2174 .type = p->type,
2176 int ret;
2178 if (ops->vidioc_g_crop)
2179 return ops->vidioc_g_crop(file, fh, p);
2180 /* simulate capture crop using selection api */
2182 /* crop means compose for output devices */
2183 if (V4L2_TYPE_IS_OUTPUT(p->type))
2184 s.target = V4L2_SEL_TGT_COMPOSE_ACTIVE;
2185 else
2186 s.target = V4L2_SEL_TGT_CROP_ACTIVE;
2188 ret = v4l_g_selection(ops, file, fh, &s);
2190 /* copying results to old structure on success */
2191 if (!ret)
2192 p->c = s.r;
2193 return ret;
2196 static int v4l_s_crop(const struct v4l2_ioctl_ops *ops,
2197 struct file *file, void *fh, void *arg)
2199 struct v4l2_crop *p = arg;
2200 struct v4l2_selection s = {
2201 .type = p->type,
2202 .r = p->c,
2205 if (ops->vidioc_s_crop)
2206 return ops->vidioc_s_crop(file, fh, p);
2207 /* simulate capture crop using selection api */
2209 /* crop means compose for output devices */
2210 if (V4L2_TYPE_IS_OUTPUT(p->type))
2211 s.target = V4L2_SEL_TGT_COMPOSE_ACTIVE;
2212 else
2213 s.target = V4L2_SEL_TGT_CROP_ACTIVE;
2215 return v4l_s_selection(ops, file, fh, &s);
2218 static int v4l_cropcap(const struct v4l2_ioctl_ops *ops,
2219 struct file *file, void *fh, void *arg)
2221 struct v4l2_cropcap *p = arg;
2222 struct v4l2_selection s = { .type = p->type };
2223 int ret = 0;
2225 /* setting trivial pixelaspect */
2226 p->pixelaspect.numerator = 1;
2227 p->pixelaspect.denominator = 1;
2230 * The determine_valid_ioctls() call already should ensure
2231 * that this can never happen, but just in case...
2233 if (WARN_ON(!ops->vidioc_cropcap && !ops->vidioc_g_selection))
2234 return -ENOTTY;
2236 if (ops->vidioc_cropcap)
2237 ret = ops->vidioc_cropcap(file, fh, p);
2239 if (!ops->vidioc_g_selection)
2240 return ret;
2243 * Ignore ENOTTY or ENOIOCTLCMD error returns, just use the
2244 * square pixel aspect ratio in that case.
2246 if (ret && ret != -ENOTTY && ret != -ENOIOCTLCMD)
2247 return ret;
2249 /* Use g_selection() to fill in the bounds and defrect rectangles */
2251 /* obtaining bounds */
2252 if (V4L2_TYPE_IS_OUTPUT(p->type))
2253 s.target = V4L2_SEL_TGT_COMPOSE_BOUNDS;
2254 else
2255 s.target = V4L2_SEL_TGT_CROP_BOUNDS;
2257 ret = v4l_g_selection(ops, file, fh, &s);
2258 if (ret)
2259 return ret;
2260 p->bounds = s.r;
2262 /* obtaining defrect */
2263 if (V4L2_TYPE_IS_OUTPUT(p->type))
2264 s.target = V4L2_SEL_TGT_COMPOSE_DEFAULT;
2265 else
2266 s.target = V4L2_SEL_TGT_CROP_DEFAULT;
2268 ret = v4l_g_selection(ops, file, fh, &s);
2269 if (ret)
2270 return ret;
2271 p->defrect = s.r;
2273 return 0;
2276 static int v4l_log_status(const struct v4l2_ioctl_ops *ops,
2277 struct file *file, void *fh, void *arg)
2279 struct video_device *vfd = video_devdata(file);
2280 int ret;
2282 if (vfd->v4l2_dev)
2283 pr_info("%s: ================= START STATUS =================\n",
2284 vfd->v4l2_dev->name);
2285 ret = ops->vidioc_log_status(file, fh);
2286 if (vfd->v4l2_dev)
2287 pr_info("%s: ================== END STATUS ==================\n",
2288 vfd->v4l2_dev->name);
2289 return ret;
2292 static int v4l_dbg_g_register(const struct v4l2_ioctl_ops *ops,
2293 struct file *file, void *fh, void *arg)
2295 #ifdef CONFIG_VIDEO_ADV_DEBUG
2296 struct v4l2_dbg_register *p = arg;
2297 struct video_device *vfd = video_devdata(file);
2298 struct v4l2_subdev *sd;
2299 int idx = 0;
2301 if (!capable(CAP_SYS_ADMIN))
2302 return -EPERM;
2303 if (p->match.type == V4L2_CHIP_MATCH_SUBDEV) {
2304 if (vfd->v4l2_dev == NULL)
2305 return -EINVAL;
2306 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev)
2307 if (p->match.addr == idx++)
2308 return v4l2_subdev_call(sd, core, g_register, p);
2309 return -EINVAL;
2311 if (ops->vidioc_g_register && p->match.type == V4L2_CHIP_MATCH_BRIDGE &&
2312 (ops->vidioc_g_chip_info || p->match.addr == 0))
2313 return ops->vidioc_g_register(file, fh, p);
2314 return -EINVAL;
2315 #else
2316 return -ENOTTY;
2317 #endif
2320 static int v4l_dbg_s_register(const struct v4l2_ioctl_ops *ops,
2321 struct file *file, void *fh, void *arg)
2323 #ifdef CONFIG_VIDEO_ADV_DEBUG
2324 const struct v4l2_dbg_register *p = arg;
2325 struct video_device *vfd = video_devdata(file);
2326 struct v4l2_subdev *sd;
2327 int idx = 0;
2329 if (!capable(CAP_SYS_ADMIN))
2330 return -EPERM;
2331 if (p->match.type == V4L2_CHIP_MATCH_SUBDEV) {
2332 if (vfd->v4l2_dev == NULL)
2333 return -EINVAL;
2334 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev)
2335 if (p->match.addr == idx++)
2336 return v4l2_subdev_call(sd, core, s_register, p);
2337 return -EINVAL;
2339 if (ops->vidioc_s_register && p->match.type == V4L2_CHIP_MATCH_BRIDGE &&
2340 (ops->vidioc_g_chip_info || p->match.addr == 0))
2341 return ops->vidioc_s_register(file, fh, p);
2342 return -EINVAL;
2343 #else
2344 return -ENOTTY;
2345 #endif
2348 static int v4l_dbg_g_chip_info(const struct v4l2_ioctl_ops *ops,
2349 struct file *file, void *fh, void *arg)
2351 #ifdef CONFIG_VIDEO_ADV_DEBUG
2352 struct video_device *vfd = video_devdata(file);
2353 struct v4l2_dbg_chip_info *p = arg;
2354 struct v4l2_subdev *sd;
2355 int idx = 0;
2357 switch (p->match.type) {
2358 case V4L2_CHIP_MATCH_BRIDGE:
2359 if (ops->vidioc_s_register)
2360 p->flags |= V4L2_CHIP_FL_WRITABLE;
2361 if (ops->vidioc_g_register)
2362 p->flags |= V4L2_CHIP_FL_READABLE;
2363 strlcpy(p->name, vfd->v4l2_dev->name, sizeof(p->name));
2364 if (ops->vidioc_g_chip_info)
2365 return ops->vidioc_g_chip_info(file, fh, arg);
2366 if (p->match.addr)
2367 return -EINVAL;
2368 return 0;
2370 case V4L2_CHIP_MATCH_SUBDEV:
2371 if (vfd->v4l2_dev == NULL)
2372 break;
2373 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev) {
2374 if (p->match.addr != idx++)
2375 continue;
2376 if (sd->ops->core && sd->ops->core->s_register)
2377 p->flags |= V4L2_CHIP_FL_WRITABLE;
2378 if (sd->ops->core && sd->ops->core->g_register)
2379 p->flags |= V4L2_CHIP_FL_READABLE;
2380 strlcpy(p->name, sd->name, sizeof(p->name));
2381 return 0;
2383 break;
2385 return -EINVAL;
2386 #else
2387 return -ENOTTY;
2388 #endif
2391 static int v4l_dqevent(const struct v4l2_ioctl_ops *ops,
2392 struct file *file, void *fh, void *arg)
2394 return v4l2_event_dequeue(fh, arg, file->f_flags & O_NONBLOCK);
2397 static int v4l_subscribe_event(const struct v4l2_ioctl_ops *ops,
2398 struct file *file, void *fh, void *arg)
2400 return ops->vidioc_subscribe_event(fh, arg);
2403 static int v4l_unsubscribe_event(const struct v4l2_ioctl_ops *ops,
2404 struct file *file, void *fh, void *arg)
2406 return ops->vidioc_unsubscribe_event(fh, arg);
2409 static int v4l_g_sliced_vbi_cap(const struct v4l2_ioctl_ops *ops,
2410 struct file *file, void *fh, void *arg)
2412 struct v4l2_sliced_vbi_cap *p = arg;
2413 int ret = check_fmt(file, p->type);
2415 if (ret)
2416 return ret;
2418 /* Clear up to type, everything after type is zeroed already */
2419 memset(p, 0, offsetof(struct v4l2_sliced_vbi_cap, type));
2421 return ops->vidioc_g_sliced_vbi_cap(file, fh, p);
2424 static int v4l_enum_freq_bands(const struct v4l2_ioctl_ops *ops,
2425 struct file *file, void *fh, void *arg)
2427 struct video_device *vfd = video_devdata(file);
2428 struct v4l2_frequency_band *p = arg;
2429 enum v4l2_tuner_type type;
2430 int err;
2432 if (vfd->vfl_type == VFL_TYPE_SDR) {
2433 if (p->type != V4L2_TUNER_SDR && p->type != V4L2_TUNER_RF)
2434 return -EINVAL;
2435 type = p->type;
2436 } else {
2437 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
2438 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
2439 if (type != p->type)
2440 return -EINVAL;
2442 if (ops->vidioc_enum_freq_bands) {
2443 err = ops->vidioc_enum_freq_bands(file, fh, p);
2444 if (err != -ENOTTY)
2445 return err;
2447 if (is_valid_ioctl(vfd, VIDIOC_G_TUNER)) {
2448 struct v4l2_tuner t = {
2449 .index = p->tuner,
2450 .type = type,
2453 if (p->index)
2454 return -EINVAL;
2455 err = ops->vidioc_g_tuner(file, fh, &t);
2456 if (err)
2457 return err;
2458 p->capability = t.capability | V4L2_TUNER_CAP_FREQ_BANDS;
2459 p->rangelow = t.rangelow;
2460 p->rangehigh = t.rangehigh;
2461 p->modulation = (type == V4L2_TUNER_RADIO) ?
2462 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
2463 return 0;
2465 if (is_valid_ioctl(vfd, VIDIOC_G_MODULATOR)) {
2466 struct v4l2_modulator m = {
2467 .index = p->tuner,
2470 if (type != V4L2_TUNER_RADIO)
2471 return -EINVAL;
2472 if (p->index)
2473 return -EINVAL;
2474 err = ops->vidioc_g_modulator(file, fh, &m);
2475 if (err)
2476 return err;
2477 p->capability = m.capability | V4L2_TUNER_CAP_FREQ_BANDS;
2478 p->rangelow = m.rangelow;
2479 p->rangehigh = m.rangehigh;
2480 p->modulation = (type == V4L2_TUNER_RADIO) ?
2481 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
2482 return 0;
2484 return -ENOTTY;
2487 struct v4l2_ioctl_info {
2488 unsigned int ioctl;
2489 u32 flags;
2490 const char * const name;
2491 union {
2492 u32 offset;
2493 int (*func)(const struct v4l2_ioctl_ops *ops,
2494 struct file *file, void *fh, void *p);
2495 } u;
2496 void (*debug)(const void *arg, bool write_only);
2499 /* This control needs a priority check */
2500 #define INFO_FL_PRIO (1 << 0)
2501 /* This control can be valid if the filehandle passes a control handler. */
2502 #define INFO_FL_CTRL (1 << 1)
2503 /* This is a standard ioctl, no need for special code */
2504 #define INFO_FL_STD (1 << 2)
2505 /* This is ioctl has its own function */
2506 #define INFO_FL_FUNC (1 << 3)
2507 /* Queuing ioctl */
2508 #define INFO_FL_QUEUE (1 << 4)
2509 /* Always copy back result, even on error */
2510 #define INFO_FL_ALWAYS_COPY (1 << 5)
2511 /* Zero struct from after the field to the end */
2512 #define INFO_FL_CLEAR(v4l2_struct, field) \
2513 ((offsetof(struct v4l2_struct, field) + \
2514 sizeof(((struct v4l2_struct *)0)->field)) << 16)
2515 #define INFO_FL_CLEAR_MASK (_IOC_SIZEMASK << 16)
2517 #define IOCTL_INFO_STD(_ioctl, _vidioc, _debug, _flags) \
2518 [_IOC_NR(_ioctl)] = { \
2519 .ioctl = _ioctl, \
2520 .flags = _flags | INFO_FL_STD, \
2521 .name = #_ioctl, \
2522 .u.offset = offsetof(struct v4l2_ioctl_ops, _vidioc), \
2523 .debug = _debug, \
2526 #define IOCTL_INFO_FNC(_ioctl, _func, _debug, _flags) \
2527 [_IOC_NR(_ioctl)] = { \
2528 .ioctl = _ioctl, \
2529 .flags = _flags | INFO_FL_FUNC, \
2530 .name = #_ioctl, \
2531 .u.func = _func, \
2532 .debug = _debug, \
2535 static struct v4l2_ioctl_info v4l2_ioctls[] = {
2536 IOCTL_INFO_FNC(VIDIOC_QUERYCAP, v4l_querycap, v4l_print_querycap, 0),
2537 IOCTL_INFO_FNC(VIDIOC_ENUM_FMT, v4l_enum_fmt, v4l_print_fmtdesc, INFO_FL_CLEAR(v4l2_fmtdesc, type)),
2538 IOCTL_INFO_FNC(VIDIOC_G_FMT, v4l_g_fmt, v4l_print_format, 0),
2539 IOCTL_INFO_FNC(VIDIOC_S_FMT, v4l_s_fmt, v4l_print_format, INFO_FL_PRIO),
2540 IOCTL_INFO_FNC(VIDIOC_REQBUFS, v4l_reqbufs, v4l_print_requestbuffers, INFO_FL_PRIO | INFO_FL_QUEUE),
2541 IOCTL_INFO_FNC(VIDIOC_QUERYBUF, v4l_querybuf, v4l_print_buffer, INFO_FL_QUEUE | INFO_FL_CLEAR(v4l2_buffer, length)),
2542 IOCTL_INFO_STD(VIDIOC_G_FBUF, vidioc_g_fbuf, v4l_print_framebuffer, 0),
2543 IOCTL_INFO_STD(VIDIOC_S_FBUF, vidioc_s_fbuf, v4l_print_framebuffer, INFO_FL_PRIO),
2544 IOCTL_INFO_FNC(VIDIOC_OVERLAY, v4l_overlay, v4l_print_u32, INFO_FL_PRIO),
2545 IOCTL_INFO_FNC(VIDIOC_QBUF, v4l_qbuf, v4l_print_buffer, INFO_FL_QUEUE),
2546 IOCTL_INFO_STD(VIDIOC_EXPBUF, vidioc_expbuf, v4l_print_exportbuffer, INFO_FL_QUEUE | INFO_FL_CLEAR(v4l2_exportbuffer, flags)),
2547 IOCTL_INFO_FNC(VIDIOC_DQBUF, v4l_dqbuf, v4l_print_buffer, INFO_FL_QUEUE),
2548 IOCTL_INFO_FNC(VIDIOC_STREAMON, v4l_streamon, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
2549 IOCTL_INFO_FNC(VIDIOC_STREAMOFF, v4l_streamoff, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
2550 IOCTL_INFO_FNC(VIDIOC_G_PARM, v4l_g_parm, v4l_print_streamparm, INFO_FL_CLEAR(v4l2_streamparm, type)),
2551 IOCTL_INFO_FNC(VIDIOC_S_PARM, v4l_s_parm, v4l_print_streamparm, INFO_FL_PRIO),
2552 IOCTL_INFO_STD(VIDIOC_G_STD, vidioc_g_std, v4l_print_std, 0),
2553 IOCTL_INFO_FNC(VIDIOC_S_STD, v4l_s_std, v4l_print_std, INFO_FL_PRIO),
2554 IOCTL_INFO_FNC(VIDIOC_ENUMSTD, v4l_enumstd, v4l_print_standard, INFO_FL_CLEAR(v4l2_standard, index)),
2555 IOCTL_INFO_FNC(VIDIOC_ENUMINPUT, v4l_enuminput, v4l_print_enuminput, INFO_FL_CLEAR(v4l2_input, index)),
2556 IOCTL_INFO_FNC(VIDIOC_G_CTRL, v4l_g_ctrl, v4l_print_control, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_control, id)),
2557 IOCTL_INFO_FNC(VIDIOC_S_CTRL, v4l_s_ctrl, v4l_print_control, INFO_FL_PRIO | INFO_FL_CTRL),
2558 IOCTL_INFO_FNC(VIDIOC_G_TUNER, v4l_g_tuner, v4l_print_tuner, INFO_FL_CLEAR(v4l2_tuner, index)),
2559 IOCTL_INFO_FNC(VIDIOC_S_TUNER, v4l_s_tuner, v4l_print_tuner, INFO_FL_PRIO),
2560 IOCTL_INFO_STD(VIDIOC_G_AUDIO, vidioc_g_audio, v4l_print_audio, 0),
2561 IOCTL_INFO_STD(VIDIOC_S_AUDIO, vidioc_s_audio, v4l_print_audio, INFO_FL_PRIO),
2562 IOCTL_INFO_FNC(VIDIOC_QUERYCTRL, v4l_queryctrl, v4l_print_queryctrl, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_queryctrl, id)),
2563 IOCTL_INFO_FNC(VIDIOC_QUERYMENU, v4l_querymenu, v4l_print_querymenu, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_querymenu, index)),
2564 IOCTL_INFO_STD(VIDIOC_G_INPUT, vidioc_g_input, v4l_print_u32, 0),
2565 IOCTL_INFO_FNC(VIDIOC_S_INPUT, v4l_s_input, v4l_print_u32, INFO_FL_PRIO),
2566 IOCTL_INFO_STD(VIDIOC_G_EDID, vidioc_g_edid, v4l_print_edid, INFO_FL_ALWAYS_COPY),
2567 IOCTL_INFO_STD(VIDIOC_S_EDID, vidioc_s_edid, v4l_print_edid, INFO_FL_PRIO | INFO_FL_ALWAYS_COPY),
2568 IOCTL_INFO_STD(VIDIOC_G_OUTPUT, vidioc_g_output, v4l_print_u32, 0),
2569 IOCTL_INFO_FNC(VIDIOC_S_OUTPUT, v4l_s_output, v4l_print_u32, INFO_FL_PRIO),
2570 IOCTL_INFO_FNC(VIDIOC_ENUMOUTPUT, v4l_enumoutput, v4l_print_enumoutput, INFO_FL_CLEAR(v4l2_output, index)),
2571 IOCTL_INFO_STD(VIDIOC_G_AUDOUT, vidioc_g_audout, v4l_print_audioout, 0),
2572 IOCTL_INFO_STD(VIDIOC_S_AUDOUT, vidioc_s_audout, v4l_print_audioout, INFO_FL_PRIO),
2573 IOCTL_INFO_FNC(VIDIOC_G_MODULATOR, v4l_g_modulator, v4l_print_modulator, INFO_FL_CLEAR(v4l2_modulator, index)),
2574 IOCTL_INFO_FNC(VIDIOC_S_MODULATOR, v4l_s_modulator, v4l_print_modulator, INFO_FL_PRIO),
2575 IOCTL_INFO_FNC(VIDIOC_G_FREQUENCY, v4l_g_frequency, v4l_print_frequency, INFO_FL_CLEAR(v4l2_frequency, tuner)),
2576 IOCTL_INFO_FNC(VIDIOC_S_FREQUENCY, v4l_s_frequency, v4l_print_frequency, INFO_FL_PRIO),
2577 IOCTL_INFO_FNC(VIDIOC_CROPCAP, v4l_cropcap, v4l_print_cropcap, INFO_FL_CLEAR(v4l2_cropcap, type)),
2578 IOCTL_INFO_FNC(VIDIOC_G_CROP, v4l_g_crop, v4l_print_crop, INFO_FL_CLEAR(v4l2_crop, type)),
2579 IOCTL_INFO_FNC(VIDIOC_S_CROP, v4l_s_crop, v4l_print_crop, INFO_FL_PRIO),
2580 IOCTL_INFO_FNC(VIDIOC_G_SELECTION, v4l_g_selection, v4l_print_selection, INFO_FL_CLEAR(v4l2_selection, r)),
2581 IOCTL_INFO_FNC(VIDIOC_S_SELECTION, v4l_s_selection, v4l_print_selection, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_selection, r)),
2582 IOCTL_INFO_STD(VIDIOC_G_JPEGCOMP, vidioc_g_jpegcomp, v4l_print_jpegcompression, 0),
2583 IOCTL_INFO_STD(VIDIOC_S_JPEGCOMP, vidioc_s_jpegcomp, v4l_print_jpegcompression, INFO_FL_PRIO),
2584 IOCTL_INFO_FNC(VIDIOC_QUERYSTD, v4l_querystd, v4l_print_std, 0),
2585 IOCTL_INFO_FNC(VIDIOC_TRY_FMT, v4l_try_fmt, v4l_print_format, 0),
2586 IOCTL_INFO_STD(VIDIOC_ENUMAUDIO, vidioc_enumaudio, v4l_print_audio, INFO_FL_CLEAR(v4l2_audio, index)),
2587 IOCTL_INFO_STD(VIDIOC_ENUMAUDOUT, vidioc_enumaudout, v4l_print_audioout, INFO_FL_CLEAR(v4l2_audioout, index)),
2588 IOCTL_INFO_FNC(VIDIOC_G_PRIORITY, v4l_g_priority, v4l_print_u32, 0),
2589 IOCTL_INFO_FNC(VIDIOC_S_PRIORITY, v4l_s_priority, v4l_print_u32, INFO_FL_PRIO),
2590 IOCTL_INFO_FNC(VIDIOC_G_SLICED_VBI_CAP, v4l_g_sliced_vbi_cap, v4l_print_sliced_vbi_cap, INFO_FL_CLEAR(v4l2_sliced_vbi_cap, type)),
2591 IOCTL_INFO_FNC(VIDIOC_LOG_STATUS, v4l_log_status, v4l_print_newline, 0),
2592 IOCTL_INFO_FNC(VIDIOC_G_EXT_CTRLS, v4l_g_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL),
2593 IOCTL_INFO_FNC(VIDIOC_S_EXT_CTRLS, v4l_s_ext_ctrls, v4l_print_ext_controls, INFO_FL_PRIO | INFO_FL_CTRL),
2594 IOCTL_INFO_FNC(VIDIOC_TRY_EXT_CTRLS, v4l_try_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL),
2595 IOCTL_INFO_STD(VIDIOC_ENUM_FRAMESIZES, vidioc_enum_framesizes, v4l_print_frmsizeenum, INFO_FL_CLEAR(v4l2_frmsizeenum, pixel_format)),
2596 IOCTL_INFO_STD(VIDIOC_ENUM_FRAMEINTERVALS, vidioc_enum_frameintervals, v4l_print_frmivalenum, INFO_FL_CLEAR(v4l2_frmivalenum, height)),
2597 IOCTL_INFO_STD(VIDIOC_G_ENC_INDEX, vidioc_g_enc_index, v4l_print_enc_idx, 0),
2598 IOCTL_INFO_STD(VIDIOC_ENCODER_CMD, vidioc_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
2599 IOCTL_INFO_STD(VIDIOC_TRY_ENCODER_CMD, vidioc_try_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
2600 IOCTL_INFO_STD(VIDIOC_DECODER_CMD, vidioc_decoder_cmd, v4l_print_decoder_cmd, INFO_FL_PRIO),
2601 IOCTL_INFO_STD(VIDIOC_TRY_DECODER_CMD, vidioc_try_decoder_cmd, v4l_print_decoder_cmd, 0),
2602 IOCTL_INFO_FNC(VIDIOC_DBG_S_REGISTER, v4l_dbg_s_register, v4l_print_dbg_register, 0),
2603 IOCTL_INFO_FNC(VIDIOC_DBG_G_REGISTER, v4l_dbg_g_register, v4l_print_dbg_register, 0),
2604 IOCTL_INFO_FNC(VIDIOC_S_HW_FREQ_SEEK, v4l_s_hw_freq_seek, v4l_print_hw_freq_seek, INFO_FL_PRIO),
2605 IOCTL_INFO_STD(VIDIOC_S_DV_TIMINGS, vidioc_s_dv_timings, v4l_print_dv_timings, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_dv_timings, bt.flags)),
2606 IOCTL_INFO_STD(VIDIOC_G_DV_TIMINGS, vidioc_g_dv_timings, v4l_print_dv_timings, 0),
2607 IOCTL_INFO_FNC(VIDIOC_DQEVENT, v4l_dqevent, v4l_print_event, 0),
2608 IOCTL_INFO_FNC(VIDIOC_SUBSCRIBE_EVENT, v4l_subscribe_event, v4l_print_event_subscription, 0),
2609 IOCTL_INFO_FNC(VIDIOC_UNSUBSCRIBE_EVENT, v4l_unsubscribe_event, v4l_print_event_subscription, 0),
2610 IOCTL_INFO_FNC(VIDIOC_CREATE_BUFS, v4l_create_bufs, v4l_print_create_buffers, INFO_FL_PRIO | INFO_FL_QUEUE),
2611 IOCTL_INFO_FNC(VIDIOC_PREPARE_BUF, v4l_prepare_buf, v4l_print_buffer, INFO_FL_QUEUE),
2612 IOCTL_INFO_STD(VIDIOC_ENUM_DV_TIMINGS, vidioc_enum_dv_timings, v4l_print_enum_dv_timings, INFO_FL_CLEAR(v4l2_enum_dv_timings, pad)),
2613 IOCTL_INFO_STD(VIDIOC_QUERY_DV_TIMINGS, vidioc_query_dv_timings, v4l_print_dv_timings, INFO_FL_ALWAYS_COPY),
2614 IOCTL_INFO_STD(VIDIOC_DV_TIMINGS_CAP, vidioc_dv_timings_cap, v4l_print_dv_timings_cap, INFO_FL_CLEAR(v4l2_dv_timings_cap, type)),
2615 IOCTL_INFO_FNC(VIDIOC_ENUM_FREQ_BANDS, v4l_enum_freq_bands, v4l_print_freq_band, 0),
2616 IOCTL_INFO_FNC(VIDIOC_DBG_G_CHIP_INFO, v4l_dbg_g_chip_info, v4l_print_dbg_chip_info, INFO_FL_CLEAR(v4l2_dbg_chip_info, match)),
2617 IOCTL_INFO_FNC(VIDIOC_QUERY_EXT_CTRL, v4l_query_ext_ctrl, v4l_print_query_ext_ctrl, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_query_ext_ctrl, id)),
2619 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
2621 bool v4l2_is_known_ioctl(unsigned int cmd)
2623 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2624 return false;
2625 return v4l2_ioctls[_IOC_NR(cmd)].ioctl == cmd;
2628 struct mutex *v4l2_ioctl_get_lock(struct video_device *vdev, unsigned cmd)
2630 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2631 return vdev->lock;
2632 if (test_bit(_IOC_NR(cmd), vdev->disable_locking))
2633 return NULL;
2634 if (vdev->queue && vdev->queue->lock &&
2635 (v4l2_ioctls[_IOC_NR(cmd)].flags & INFO_FL_QUEUE))
2636 return vdev->queue->lock;
2637 return vdev->lock;
2640 /* Common ioctl debug function. This function can be used by
2641 external ioctl messages as well as internal V4L ioctl */
2642 void v4l_printk_ioctl(const char *prefix, unsigned int cmd)
2644 const char *dir, *type;
2646 if (prefix)
2647 printk(KERN_DEBUG "%s: ", prefix);
2649 switch (_IOC_TYPE(cmd)) {
2650 case 'd':
2651 type = "v4l2_int";
2652 break;
2653 case 'V':
2654 if (_IOC_NR(cmd) >= V4L2_IOCTLS) {
2655 type = "v4l2";
2656 break;
2658 pr_cont("%s", v4l2_ioctls[_IOC_NR(cmd)].name);
2659 return;
2660 default:
2661 type = "unknown";
2662 break;
2665 switch (_IOC_DIR(cmd)) {
2666 case _IOC_NONE: dir = "--"; break;
2667 case _IOC_READ: dir = "r-"; break;
2668 case _IOC_WRITE: dir = "-w"; break;
2669 case _IOC_READ | _IOC_WRITE: dir = "rw"; break;
2670 default: dir = "*ERR*"; break;
2672 pr_cont("%s ioctl '%c', dir=%s, #%d (0x%08x)",
2673 type, _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
2675 EXPORT_SYMBOL(v4l_printk_ioctl);
2677 static long __video_do_ioctl(struct file *file,
2678 unsigned int cmd, void *arg)
2680 struct video_device *vfd = video_devdata(file);
2681 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
2682 bool write_only = false;
2683 struct v4l2_ioctl_info default_info;
2684 const struct v4l2_ioctl_info *info;
2685 void *fh = file->private_data;
2686 struct v4l2_fh *vfh = NULL;
2687 int dev_debug = vfd->dev_debug;
2688 long ret = -ENOTTY;
2690 if (ops == NULL) {
2691 pr_warn("%s: has no ioctl_ops.\n",
2692 video_device_node_name(vfd));
2693 return ret;
2696 if (test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags))
2697 vfh = file->private_data;
2699 if (v4l2_is_known_ioctl(cmd)) {
2700 info = &v4l2_ioctls[_IOC_NR(cmd)];
2702 if (!test_bit(_IOC_NR(cmd), vfd->valid_ioctls) &&
2703 !((info->flags & INFO_FL_CTRL) && vfh && vfh->ctrl_handler))
2704 goto done;
2706 if (vfh && (info->flags & INFO_FL_PRIO)) {
2707 ret = v4l2_prio_check(vfd->prio, vfh->prio);
2708 if (ret)
2709 goto done;
2711 } else {
2712 default_info.ioctl = cmd;
2713 default_info.flags = 0;
2714 default_info.debug = v4l_print_default;
2715 info = &default_info;
2718 write_only = _IOC_DIR(cmd) == _IOC_WRITE;
2719 if (info->flags & INFO_FL_STD) {
2720 typedef int (*vidioc_op)(struct file *file, void *fh, void *p);
2721 const void *p = vfd->ioctl_ops;
2722 const vidioc_op *vidioc = p + info->u.offset;
2724 ret = (*vidioc)(file, fh, arg);
2725 } else if (info->flags & INFO_FL_FUNC) {
2726 ret = info->u.func(ops, file, fh, arg);
2727 } else if (!ops->vidioc_default) {
2728 ret = -ENOTTY;
2729 } else {
2730 ret = ops->vidioc_default(file, fh,
2731 vfh ? v4l2_prio_check(vfd->prio, vfh->prio) >= 0 : 0,
2732 cmd, arg);
2735 done:
2736 if (dev_debug & (V4L2_DEV_DEBUG_IOCTL | V4L2_DEV_DEBUG_IOCTL_ARG)) {
2737 if (!(dev_debug & V4L2_DEV_DEBUG_STREAMING) &&
2738 (cmd == VIDIOC_QBUF || cmd == VIDIOC_DQBUF))
2739 return ret;
2741 v4l_printk_ioctl(video_device_node_name(vfd), cmd);
2742 if (ret < 0)
2743 pr_cont(": error %ld", ret);
2744 if (!(dev_debug & V4L2_DEV_DEBUG_IOCTL_ARG))
2745 pr_cont("\n");
2746 else if (_IOC_DIR(cmd) == _IOC_NONE)
2747 info->debug(arg, write_only);
2748 else {
2749 pr_cont(": ");
2750 info->debug(arg, write_only);
2754 return ret;
2757 static int check_array_args(unsigned int cmd, void *parg, size_t *array_size,
2758 void __user **user_ptr, void ***kernel_ptr)
2760 int ret = 0;
2762 switch (cmd) {
2763 case VIDIOC_PREPARE_BUF:
2764 case VIDIOC_QUERYBUF:
2765 case VIDIOC_QBUF:
2766 case VIDIOC_DQBUF: {
2767 struct v4l2_buffer *buf = parg;
2769 if (V4L2_TYPE_IS_MULTIPLANAR(buf->type) && buf->length > 0) {
2770 if (buf->length > VIDEO_MAX_PLANES) {
2771 ret = -EINVAL;
2772 break;
2774 *user_ptr = (void __user *)buf->m.planes;
2775 *kernel_ptr = (void **)&buf->m.planes;
2776 *array_size = sizeof(struct v4l2_plane) * buf->length;
2777 ret = 1;
2779 break;
2782 case VIDIOC_G_EDID:
2783 case VIDIOC_S_EDID: {
2784 struct v4l2_edid *edid = parg;
2786 if (edid->blocks) {
2787 if (edid->blocks > 256) {
2788 ret = -EINVAL;
2789 break;
2791 *user_ptr = (void __user *)edid->edid;
2792 *kernel_ptr = (void **)&edid->edid;
2793 *array_size = edid->blocks * 128;
2794 ret = 1;
2796 break;
2799 case VIDIOC_S_EXT_CTRLS:
2800 case VIDIOC_G_EXT_CTRLS:
2801 case VIDIOC_TRY_EXT_CTRLS: {
2802 struct v4l2_ext_controls *ctrls = parg;
2804 if (ctrls->count != 0) {
2805 if (ctrls->count > V4L2_CID_MAX_CTRLS) {
2806 ret = -EINVAL;
2807 break;
2809 *user_ptr = (void __user *)ctrls->controls;
2810 *kernel_ptr = (void **)&ctrls->controls;
2811 *array_size = sizeof(struct v4l2_ext_control)
2812 * ctrls->count;
2813 ret = 1;
2815 break;
2819 return ret;
2822 long
2823 video_usercopy(struct file *file, unsigned int cmd, unsigned long arg,
2824 v4l2_kioctl func)
2826 char sbuf[128];
2827 void *mbuf = NULL;
2828 void *parg = (void *)arg;
2829 long err = -EINVAL;
2830 bool has_array_args;
2831 bool always_copy = false;
2832 size_t array_size = 0;
2833 void __user *user_ptr = NULL;
2834 void **kernel_ptr = NULL;
2836 /* Copy arguments into temp kernel buffer */
2837 if (_IOC_DIR(cmd) != _IOC_NONE) {
2838 if (_IOC_SIZE(cmd) <= sizeof(sbuf)) {
2839 parg = sbuf;
2840 } else {
2841 /* too big to allocate from stack */
2842 mbuf = kvmalloc(_IOC_SIZE(cmd), GFP_KERNEL);
2843 if (NULL == mbuf)
2844 return -ENOMEM;
2845 parg = mbuf;
2848 err = -EFAULT;
2849 if (_IOC_DIR(cmd) & _IOC_WRITE) {
2850 unsigned int n = _IOC_SIZE(cmd);
2853 * In some cases, only a few fields are used as input,
2854 * i.e. when the app sets "index" and then the driver
2855 * fills in the rest of the structure for the thing
2856 * with that index. We only need to copy up the first
2857 * non-input field.
2859 if (v4l2_is_known_ioctl(cmd)) {
2860 u32 flags = v4l2_ioctls[_IOC_NR(cmd)].flags;
2862 if (flags & INFO_FL_CLEAR_MASK)
2863 n = (flags & INFO_FL_CLEAR_MASK) >> 16;
2864 always_copy = flags & INFO_FL_ALWAYS_COPY;
2867 if (copy_from_user(parg, (void __user *)arg, n))
2868 goto out;
2870 /* zero out anything we don't copy from userspace */
2871 if (n < _IOC_SIZE(cmd))
2872 memset((u8 *)parg + n, 0, _IOC_SIZE(cmd) - n);
2873 } else {
2874 /* read-only ioctl */
2875 memset(parg, 0, _IOC_SIZE(cmd));
2879 err = check_array_args(cmd, parg, &array_size, &user_ptr, &kernel_ptr);
2880 if (err < 0)
2881 goto out;
2882 has_array_args = err;
2884 if (has_array_args) {
2886 * When adding new types of array args, make sure that the
2887 * parent argument to ioctl (which contains the pointer to the
2888 * array) fits into sbuf (so that mbuf will still remain
2889 * unused up to here).
2891 mbuf = kvmalloc(array_size, GFP_KERNEL);
2892 err = -ENOMEM;
2893 if (NULL == mbuf)
2894 goto out_array_args;
2895 err = -EFAULT;
2896 if (copy_from_user(mbuf, user_ptr, array_size))
2897 goto out_array_args;
2898 *kernel_ptr = mbuf;
2901 /* Handles IOCTL */
2902 err = func(file, cmd, parg);
2903 if (err == -ENOTTY || err == -ENOIOCTLCMD) {
2904 err = -ENOTTY;
2905 goto out;
2908 if (err == 0) {
2909 if (cmd == VIDIOC_DQBUF)
2910 trace_v4l2_dqbuf(video_devdata(file)->minor, parg);
2911 else if (cmd == VIDIOC_QBUF)
2912 trace_v4l2_qbuf(video_devdata(file)->minor, parg);
2915 if (has_array_args) {
2916 *kernel_ptr = (void __force *)user_ptr;
2917 if (copy_to_user(user_ptr, mbuf, array_size))
2918 err = -EFAULT;
2919 goto out_array_args;
2922 * Some ioctls can return an error, but still have valid
2923 * results that must be returned.
2925 if (err < 0 && !always_copy)
2926 goto out;
2928 out_array_args:
2929 /* Copy results into user buffer */
2930 switch (_IOC_DIR(cmd)) {
2931 case _IOC_READ:
2932 case (_IOC_WRITE | _IOC_READ):
2933 if (copy_to_user((void __user *)arg, parg, _IOC_SIZE(cmd)))
2934 err = -EFAULT;
2935 break;
2938 out:
2939 kvfree(mbuf);
2940 return err;
2942 EXPORT_SYMBOL(video_usercopy);
2944 long video_ioctl2(struct file *file,
2945 unsigned int cmd, unsigned long arg)
2947 return video_usercopy(file, cmd, arg, __video_do_ioctl);
2949 EXPORT_SYMBOL(video_ioctl2);