1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Video capture interface for Linux version 2
5 * A generic framework to process V4L2 ioctl commands.
7 * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1)
8 * Mauro Carvalho Chehab <mchehab@kernel.org> (version 2)
11 #include <linux/compat.h>
13 #include <linux/module.h>
14 #include <linux/slab.h>
15 #include <linux/types.h>
16 #include <linux/kernel.h>
17 #include <linux/version.h>
19 #include <linux/videodev2.h>
21 #include <media/media-device.h> /* for media_set_bus_info() */
22 #include <media/v4l2-common.h>
23 #include <media/v4l2-ioctl.h>
24 #include <media/v4l2-ctrls.h>
25 #include <media/v4l2-fh.h>
26 #include <media/v4l2-event.h>
27 #include <media/v4l2-device.h>
28 #include <media/videobuf2-v4l2.h>
29 #include <media/v4l2-mc.h>
30 #include <media/v4l2-mem2mem.h>
32 #include <trace/events/v4l2.h>
34 #define is_valid_ioctl(vfd, cmd) test_bit(_IOC_NR(cmd), (vfd)->valid_ioctls)
41 static const struct std_descr standards[] = {
42 { V4L2_STD_NTSC, "NTSC" },
43 { V4L2_STD_NTSC_M, "NTSC-M" },
44 { V4L2_STD_NTSC_M_JP, "NTSC-M-JP" },
45 { V4L2_STD_NTSC_M_KR, "NTSC-M-KR" },
46 { V4L2_STD_NTSC_443, "NTSC-443" },
47 { V4L2_STD_PAL, "PAL" },
48 { V4L2_STD_PAL_BG, "PAL-BG" },
49 { V4L2_STD_PAL_B, "PAL-B" },
50 { V4L2_STD_PAL_B1, "PAL-B1" },
51 { V4L2_STD_PAL_G, "PAL-G" },
52 { V4L2_STD_PAL_H, "PAL-H" },
53 { V4L2_STD_PAL_I, "PAL-I" },
54 { V4L2_STD_PAL_DK, "PAL-DK" },
55 { V4L2_STD_PAL_D, "PAL-D" },
56 { V4L2_STD_PAL_D1, "PAL-D1" },
57 { V4L2_STD_PAL_K, "PAL-K" },
58 { V4L2_STD_PAL_M, "PAL-M" },
59 { V4L2_STD_PAL_N, "PAL-N" },
60 { V4L2_STD_PAL_Nc, "PAL-Nc" },
61 { V4L2_STD_PAL_60, "PAL-60" },
62 { V4L2_STD_SECAM, "SECAM" },
63 { V4L2_STD_SECAM_B, "SECAM-B" },
64 { V4L2_STD_SECAM_G, "SECAM-G" },
65 { V4L2_STD_SECAM_H, "SECAM-H" },
66 { V4L2_STD_SECAM_DK, "SECAM-DK" },
67 { V4L2_STD_SECAM_D, "SECAM-D" },
68 { V4L2_STD_SECAM_K, "SECAM-K" },
69 { V4L2_STD_SECAM_K1, "SECAM-K1" },
70 { V4L2_STD_SECAM_L, "SECAM-L" },
71 { V4L2_STD_SECAM_LC, "SECAM-Lc" },
75 /* video4linux standard ID conversion to standard name
77 const char *v4l2_norm_to_name(v4l2_std_id id)
82 /* HACK: ppc32 architecture doesn't have __ucmpdi2 function to handle
83 64 bit comparisons. So, on that architecture, with some gcc
84 variants, compilation fails. Currently, the max value is 30bit wide.
88 for (i = 0; standards[i].std; i++)
89 if (myid == standards[i].std)
91 return standards[i].descr;
93 EXPORT_SYMBOL(v4l2_norm_to_name);
95 /* Returns frame period for the given standard */
96 void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod)
98 if (id & V4L2_STD_525_60) {
99 frameperiod->numerator = 1001;
100 frameperiod->denominator = 30000;
102 frameperiod->numerator = 1;
103 frameperiod->denominator = 25;
106 EXPORT_SYMBOL(v4l2_video_std_frame_period);
108 /* Fill in the fields of a v4l2_standard structure according to the
109 'id' and 'transmission' parameters. Returns negative on error. */
110 int v4l2_video_std_construct(struct v4l2_standard *vs,
111 int id, const char *name)
114 v4l2_video_std_frame_period(id, &vs->frameperiod);
115 vs->framelines = (id & V4L2_STD_525_60) ? 525 : 625;
116 strscpy(vs->name, name, sizeof(vs->name));
119 EXPORT_SYMBOL(v4l2_video_std_construct);
121 /* Fill in the fields of a v4l2_standard structure according to the
122 * 'id' and 'vs->index' parameters. Returns negative on error. */
123 int v4l_video_std_enumstd(struct v4l2_standard *vs, v4l2_std_id id)
125 v4l2_std_id curr_id = 0;
126 unsigned int index = vs->index, i, j = 0;
127 const char *descr = "";
129 /* Return -ENODATA if the id for the current input
130 or output is 0, meaning that it doesn't support this API. */
134 /* Return norm array in a canonical way */
135 for (i = 0; i <= index && id; i++) {
136 /* last std value in the standards array is 0, so this
137 while always ends there since (id & 0) == 0. */
138 while ((id & standards[j].std) != standards[j].std)
140 curr_id = standards[j].std;
141 descr = standards[j].descr;
145 if (curr_id != V4L2_STD_PAL &&
146 curr_id != V4L2_STD_SECAM &&
147 curr_id != V4L2_STD_NTSC)
153 v4l2_video_std_construct(vs, curr_id, descr);
157 /* ----------------------------------------------------------------- */
158 /* some arrays for pretty-printing debug messages of enum types */
160 const char *v4l2_field_names[] = {
161 [V4L2_FIELD_ANY] = "any",
162 [V4L2_FIELD_NONE] = "none",
163 [V4L2_FIELD_TOP] = "top",
164 [V4L2_FIELD_BOTTOM] = "bottom",
165 [V4L2_FIELD_INTERLACED] = "interlaced",
166 [V4L2_FIELD_SEQ_TB] = "seq-tb",
167 [V4L2_FIELD_SEQ_BT] = "seq-bt",
168 [V4L2_FIELD_ALTERNATE] = "alternate",
169 [V4L2_FIELD_INTERLACED_TB] = "interlaced-tb",
170 [V4L2_FIELD_INTERLACED_BT] = "interlaced-bt",
172 EXPORT_SYMBOL(v4l2_field_names);
174 const char *v4l2_type_names[] = {
176 [V4L2_BUF_TYPE_VIDEO_CAPTURE] = "vid-cap",
177 [V4L2_BUF_TYPE_VIDEO_OVERLAY] = "vid-overlay",
178 [V4L2_BUF_TYPE_VIDEO_OUTPUT] = "vid-out",
179 [V4L2_BUF_TYPE_VBI_CAPTURE] = "vbi-cap",
180 [V4L2_BUF_TYPE_VBI_OUTPUT] = "vbi-out",
181 [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
182 [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT] = "sliced-vbi-out",
183 [V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY] = "vid-out-overlay",
184 [V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE] = "vid-cap-mplane",
185 [V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE] = "vid-out-mplane",
186 [V4L2_BUF_TYPE_SDR_CAPTURE] = "sdr-cap",
187 [V4L2_BUF_TYPE_SDR_OUTPUT] = "sdr-out",
188 [V4L2_BUF_TYPE_META_CAPTURE] = "meta-cap",
189 [V4L2_BUF_TYPE_META_OUTPUT] = "meta-out",
191 EXPORT_SYMBOL(v4l2_type_names);
193 static const char *v4l2_memory_names[] = {
194 [V4L2_MEMORY_MMAP] = "mmap",
195 [V4L2_MEMORY_USERPTR] = "userptr",
196 [V4L2_MEMORY_OVERLAY] = "overlay",
197 [V4L2_MEMORY_DMABUF] = "dmabuf",
200 #define prt_names(a, arr) (((unsigned)(a)) < ARRAY_SIZE(arr) ? arr[a] : "unknown")
202 /* ------------------------------------------------------------------ */
203 /* debug help functions */
205 static void v4l_print_querycap(const void *arg, bool write_only)
207 const struct v4l2_capability *p = arg;
209 pr_cont("driver=%.*s, card=%.*s, bus=%.*s, version=0x%08x, capabilities=0x%08x, device_caps=0x%08x\n",
210 (int)sizeof(p->driver), p->driver,
211 (int)sizeof(p->card), p->card,
212 (int)sizeof(p->bus_info), p->bus_info,
213 p->version, p->capabilities, p->device_caps);
216 static void v4l_print_enuminput(const void *arg, bool write_only)
218 const struct v4l2_input *p = arg;
220 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, tuner=%u, std=0x%08Lx, status=0x%x, capabilities=0x%x\n",
221 p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
222 p->tuner, (unsigned long long)p->std, p->status,
226 static void v4l_print_enumoutput(const void *arg, bool write_only)
228 const struct v4l2_output *p = arg;
230 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, modulator=%u, std=0x%08Lx, capabilities=0x%x\n",
231 p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
232 p->modulator, (unsigned long long)p->std, p->capabilities);
235 static void v4l_print_audio(const void *arg, bool write_only)
237 const struct v4l2_audio *p = arg;
240 pr_cont("index=%u, mode=0x%x\n", p->index, p->mode);
242 pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
243 p->index, (int)sizeof(p->name), p->name,
244 p->capability, p->mode);
247 static void v4l_print_audioout(const void *arg, bool write_only)
249 const struct v4l2_audioout *p = arg;
252 pr_cont("index=%u\n", p->index);
254 pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
255 p->index, (int)sizeof(p->name), p->name,
256 p->capability, p->mode);
259 static void v4l_print_fmtdesc(const void *arg, bool write_only)
261 const struct v4l2_fmtdesc *p = arg;
263 pr_cont("index=%u, type=%s, flags=0x%x, pixelformat=%p4cc, mbus_code=0x%04x, description='%.*s'\n",
264 p->index, prt_names(p->type, v4l2_type_names),
265 p->flags, &p->pixelformat, p->mbus_code,
266 (int)sizeof(p->description), p->description);
269 static void v4l_print_format(const void *arg, bool write_only)
271 const struct v4l2_format *p = arg;
272 const struct v4l2_pix_format *pix;
273 const struct v4l2_pix_format_mplane *mp;
274 const struct v4l2_vbi_format *vbi;
275 const struct v4l2_sliced_vbi_format *sliced;
276 const struct v4l2_window *win;
277 const struct v4l2_meta_format *meta;
282 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
284 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
285 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
287 pr_cont(", width=%u, height=%u, pixelformat=%p4cc, field=%s, bytesperline=%u, sizeimage=%u, colorspace=%d, flags=0x%x, ycbcr_enc=%u, quantization=%u, xfer_func=%u\n",
288 pix->width, pix->height, &pix->pixelformat,
289 prt_names(pix->field, v4l2_field_names),
290 pix->bytesperline, pix->sizeimage,
291 pix->colorspace, pix->flags, pix->ycbcr_enc,
292 pix->quantization, pix->xfer_func);
294 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
295 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
297 pixelformat = mp->pixelformat;
298 pr_cont(", width=%u, height=%u, format=%p4cc, field=%s, colorspace=%d, num_planes=%u, flags=0x%x, ycbcr_enc=%u, quantization=%u, xfer_func=%u\n",
299 mp->width, mp->height, &pixelformat,
300 prt_names(mp->field, v4l2_field_names),
301 mp->colorspace, mp->num_planes, mp->flags,
302 mp->ycbcr_enc, mp->quantization, mp->xfer_func);
303 planes = min_t(u32, mp->num_planes, VIDEO_MAX_PLANES);
304 for (i = 0; i < planes; i++)
305 printk(KERN_DEBUG "plane %u: bytesperline=%u sizeimage=%u\n", i,
306 mp->plane_fmt[i].bytesperline,
307 mp->plane_fmt[i].sizeimage);
309 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
310 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
312 /* Note: we can't print the clip list here since the clips
313 * pointer is a userspace pointer, not a kernelspace
315 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",
316 win->w.width, win->w.height, win->w.left, win->w.top,
317 prt_names(win->field, v4l2_field_names),
318 win->chromakey, win->clipcount, win->clips,
319 win->bitmap, win->global_alpha);
321 case V4L2_BUF_TYPE_VBI_CAPTURE:
322 case V4L2_BUF_TYPE_VBI_OUTPUT:
324 pr_cont(", sampling_rate=%u, offset=%u, samples_per_line=%u, sample_format=%p4cc, start=%u,%u, count=%u,%u\n",
325 vbi->sampling_rate, vbi->offset,
326 vbi->samples_per_line, &vbi->sample_format,
327 vbi->start[0], vbi->start[1],
328 vbi->count[0], vbi->count[1]);
330 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
331 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
332 sliced = &p->fmt.sliced;
333 pr_cont(", service_set=0x%08x, io_size=%d\n",
334 sliced->service_set, sliced->io_size);
335 for (i = 0; i < 24; i++)
336 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
337 sliced->service_lines[0][i],
338 sliced->service_lines[1][i]);
340 case V4L2_BUF_TYPE_SDR_CAPTURE:
341 case V4L2_BUF_TYPE_SDR_OUTPUT:
342 pixelformat = p->fmt.sdr.pixelformat;
343 pr_cont(", pixelformat=%p4cc\n", &pixelformat);
345 case V4L2_BUF_TYPE_META_CAPTURE:
346 case V4L2_BUF_TYPE_META_OUTPUT:
348 pixelformat = meta->dataformat;
349 pr_cont(", dataformat=%p4cc, buffersize=%u\n",
350 &pixelformat, meta->buffersize);
355 static void v4l_print_framebuffer(const void *arg, bool write_only)
357 const struct v4l2_framebuffer *p = arg;
359 pr_cont("capability=0x%x, flags=0x%x, base=0x%p, width=%u, height=%u, pixelformat=%p4cc, bytesperline=%u, sizeimage=%u, colorspace=%d\n",
360 p->capability, p->flags, p->base, p->fmt.width, p->fmt.height,
361 &p->fmt.pixelformat, p->fmt.bytesperline, p->fmt.sizeimage,
365 static void v4l_print_buftype(const void *arg, bool write_only)
367 pr_cont("type=%s\n", prt_names(*(u32 *)arg, v4l2_type_names));
370 static void v4l_print_modulator(const void *arg, bool write_only)
372 const struct v4l2_modulator *p = arg;
375 pr_cont("index=%u, txsubchans=0x%x\n", p->index, p->txsubchans);
377 pr_cont("index=%u, name=%.*s, capability=0x%x, rangelow=%u, rangehigh=%u, txsubchans=0x%x\n",
378 p->index, (int)sizeof(p->name), p->name, p->capability,
379 p->rangelow, p->rangehigh, p->txsubchans);
382 static void v4l_print_tuner(const void *arg, bool write_only)
384 const struct v4l2_tuner *p = arg;
387 pr_cont("index=%u, audmode=%u\n", p->index, p->audmode);
389 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",
390 p->index, (int)sizeof(p->name), p->name, p->type,
391 p->capability, p->rangelow,
392 p->rangehigh, p->signal, p->afc,
393 p->rxsubchans, p->audmode);
396 static void v4l_print_frequency(const void *arg, bool write_only)
398 const struct v4l2_frequency *p = arg;
400 pr_cont("tuner=%u, type=%u, frequency=%u\n",
401 p->tuner, p->type, p->frequency);
404 static void v4l_print_standard(const void *arg, bool write_only)
406 const struct v4l2_standard *p = arg;
408 pr_cont("index=%u, id=0x%Lx, name=%.*s, fps=%u/%u, framelines=%u\n",
410 (unsigned long long)p->id, (int)sizeof(p->name), p->name,
411 p->frameperiod.numerator,
412 p->frameperiod.denominator,
416 static void v4l_print_std(const void *arg, bool write_only)
418 pr_cont("std=0x%08Lx\n", *(const long long unsigned *)arg);
421 static void v4l_print_hw_freq_seek(const void *arg, bool write_only)
423 const struct v4l2_hw_freq_seek *p = arg;
425 pr_cont("tuner=%u, type=%u, seek_upward=%u, wrap_around=%u, spacing=%u, rangelow=%u, rangehigh=%u\n",
426 p->tuner, p->type, p->seek_upward, p->wrap_around, p->spacing,
427 p->rangelow, p->rangehigh);
430 static void v4l_print_requestbuffers(const void *arg, bool write_only)
432 const struct v4l2_requestbuffers *p = arg;
434 pr_cont("count=%d, type=%s, memory=%s\n",
436 prt_names(p->type, v4l2_type_names),
437 prt_names(p->memory, v4l2_memory_names));
440 static void v4l_print_buffer(const void *arg, bool write_only)
442 const struct v4l2_buffer *p = arg;
443 const struct v4l2_timecode *tc = &p->timecode;
444 const struct v4l2_plane *plane;
447 pr_cont("%02d:%02d:%02d.%06ld index=%d, type=%s, request_fd=%d, flags=0x%08x, field=%s, sequence=%d, memory=%s",
448 (int)p->timestamp.tv_sec / 3600,
449 ((int)p->timestamp.tv_sec / 60) % 60,
450 ((int)p->timestamp.tv_sec % 60),
451 (long)p->timestamp.tv_usec,
453 prt_names(p->type, v4l2_type_names), p->request_fd,
454 p->flags, prt_names(p->field, v4l2_field_names),
455 p->sequence, prt_names(p->memory, v4l2_memory_names));
457 if (V4L2_TYPE_IS_MULTIPLANAR(p->type) && p->m.planes) {
459 for (i = 0; i < p->length; ++i) {
460 plane = &p->m.planes[i];
462 "plane %d: bytesused=%d, data_offset=0x%08x, offset/userptr=0x%lx, length=%d\n",
463 i, plane->bytesused, plane->data_offset,
464 plane->m.userptr, plane->length);
467 pr_cont(", bytesused=%d, offset/userptr=0x%lx, length=%d\n",
468 p->bytesused, p->m.userptr, p->length);
471 printk(KERN_DEBUG "timecode=%02d:%02d:%02d type=%d, flags=0x%08x, frames=%d, userbits=0x%08x\n",
472 tc->hours, tc->minutes, tc->seconds,
473 tc->type, tc->flags, tc->frames, *(__u32 *)tc->userbits);
476 static void v4l_print_exportbuffer(const void *arg, bool write_only)
478 const struct v4l2_exportbuffer *p = arg;
480 pr_cont("fd=%d, type=%s, index=%u, plane=%u, flags=0x%08x\n",
481 p->fd, prt_names(p->type, v4l2_type_names),
482 p->index, p->plane, p->flags);
485 static void v4l_print_create_buffers(const void *arg, bool write_only)
487 const struct v4l2_create_buffers *p = arg;
489 pr_cont("index=%d, count=%d, memory=%s, capabilities=0x%08x, ",
490 p->index, p->count, prt_names(p->memory, v4l2_memory_names),
492 v4l_print_format(&p->format, write_only);
495 static void v4l_print_streamparm(const void *arg, bool write_only)
497 const struct v4l2_streamparm *p = arg;
499 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
501 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
502 p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE) {
503 const struct v4l2_captureparm *c = &p->parm.capture;
505 pr_cont(", capability=0x%x, capturemode=0x%x, timeperframe=%d/%d, extendedmode=%d, readbuffers=%d\n",
506 c->capability, c->capturemode,
507 c->timeperframe.numerator, c->timeperframe.denominator,
508 c->extendedmode, c->readbuffers);
509 } else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT ||
510 p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
511 const struct v4l2_outputparm *c = &p->parm.output;
513 pr_cont(", capability=0x%x, outputmode=0x%x, timeperframe=%d/%d, extendedmode=%d, writebuffers=%d\n",
514 c->capability, c->outputmode,
515 c->timeperframe.numerator, c->timeperframe.denominator,
516 c->extendedmode, c->writebuffers);
522 static void v4l_print_queryctrl(const void *arg, bool write_only)
524 const struct v4l2_queryctrl *p = arg;
526 pr_cont("id=0x%x, type=%d, name=%.*s, min/max=%d/%d, step=%d, default=%d, flags=0x%08x\n",
527 p->id, p->type, (int)sizeof(p->name), p->name,
528 p->minimum, p->maximum,
529 p->step, p->default_value, p->flags);
532 static void v4l_print_query_ext_ctrl(const void *arg, bool write_only)
534 const struct v4l2_query_ext_ctrl *p = arg;
536 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",
537 p->id, p->type, (int)sizeof(p->name), p->name,
538 p->minimum, p->maximum,
539 p->step, p->default_value, p->flags,
540 p->elem_size, p->elems, p->nr_of_dims,
541 p->dims[0], p->dims[1], p->dims[2], p->dims[3]);
544 static void v4l_print_querymenu(const void *arg, bool write_only)
546 const struct v4l2_querymenu *p = arg;
548 pr_cont("id=0x%x, index=%d\n", p->id, p->index);
551 static void v4l_print_control(const void *arg, bool write_only)
553 const struct v4l2_control *p = arg;
554 const char *name = v4l2_ctrl_get_name(p->id);
557 pr_cont("name=%s, ", name);
558 pr_cont("id=0x%x, value=%d\n", p->id, p->value);
561 static void v4l_print_ext_controls(const void *arg, bool write_only)
563 const struct v4l2_ext_controls *p = arg;
566 pr_cont("which=0x%x, count=%d, error_idx=%d, request_fd=%d",
567 p->which, p->count, p->error_idx, p->request_fd);
568 for (i = 0; i < p->count; i++) {
569 unsigned int id = p->controls[i].id;
570 const char *name = v4l2_ctrl_get_name(id);
573 pr_cont(", name=%s", name);
574 if (!p->controls[i].size)
575 pr_cont(", id/val=0x%x/0x%x", id, p->controls[i].value);
577 pr_cont(", id/size=0x%x/%u", id, p->controls[i].size);
582 static void v4l_print_cropcap(const void *arg, bool write_only)
584 const struct v4l2_cropcap *p = arg;
586 pr_cont("type=%s, bounds wxh=%dx%d, x,y=%d,%d, defrect wxh=%dx%d, x,y=%d,%d, pixelaspect %d/%d\n",
587 prt_names(p->type, v4l2_type_names),
588 p->bounds.width, p->bounds.height,
589 p->bounds.left, p->bounds.top,
590 p->defrect.width, p->defrect.height,
591 p->defrect.left, p->defrect.top,
592 p->pixelaspect.numerator, p->pixelaspect.denominator);
595 static void v4l_print_crop(const void *arg, bool write_only)
597 const struct v4l2_crop *p = arg;
599 pr_cont("type=%s, wxh=%dx%d, x,y=%d,%d\n",
600 prt_names(p->type, v4l2_type_names),
601 p->c.width, p->c.height,
602 p->c.left, p->c.top);
605 static void v4l_print_selection(const void *arg, bool write_only)
607 const struct v4l2_selection *p = arg;
609 pr_cont("type=%s, target=%d, flags=0x%x, wxh=%dx%d, x,y=%d,%d\n",
610 prt_names(p->type, v4l2_type_names),
612 p->r.width, p->r.height, p->r.left, p->r.top);
615 static void v4l_print_jpegcompression(const void *arg, bool write_only)
617 const struct v4l2_jpegcompression *p = arg;
619 pr_cont("quality=%d, APPn=%d, APP_len=%d, COM_len=%d, jpeg_markers=0x%x\n",
620 p->quality, p->APPn, p->APP_len,
621 p->COM_len, p->jpeg_markers);
624 static void v4l_print_enc_idx(const void *arg, bool write_only)
626 const struct v4l2_enc_idx *p = arg;
628 pr_cont("entries=%d, entries_cap=%d\n",
629 p->entries, p->entries_cap);
632 static void v4l_print_encoder_cmd(const void *arg, bool write_only)
634 const struct v4l2_encoder_cmd *p = arg;
636 pr_cont("cmd=%d, flags=0x%x\n",
640 static void v4l_print_decoder_cmd(const void *arg, bool write_only)
642 const struct v4l2_decoder_cmd *p = arg;
644 pr_cont("cmd=%d, flags=0x%x\n", p->cmd, p->flags);
646 if (p->cmd == V4L2_DEC_CMD_START)
647 pr_info("speed=%d, format=%u\n",
648 p->start.speed, p->start.format);
649 else if (p->cmd == V4L2_DEC_CMD_STOP)
650 pr_info("pts=%llu\n", p->stop.pts);
653 static void v4l_print_dbg_chip_info(const void *arg, bool write_only)
655 const struct v4l2_dbg_chip_info *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);
662 pr_cont("addr=%u, ", p->match.addr);
663 pr_cont("name=%.*s\n", (int)sizeof(p->name), p->name);
666 static void v4l_print_dbg_register(const void *arg, bool write_only)
668 const struct v4l2_dbg_register *p = arg;
670 pr_cont("type=%u, ", p->match.type);
671 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
672 pr_cont("name=%.*s, ",
673 (int)sizeof(p->match.name), p->match.name);
675 pr_cont("addr=%u, ", p->match.addr);
676 pr_cont("reg=0x%llx, val=0x%llx\n",
680 static void v4l_print_dv_timings(const void *arg, bool write_only)
682 const struct v4l2_dv_timings *p = arg;
685 case V4L2_DV_BT_656_1120:
686 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",
687 p->bt.interlaced, p->bt.pixelclock,
688 p->bt.width, p->bt.height,
689 p->bt.polarities, p->bt.hfrontporch,
690 p->bt.hsync, p->bt.hbackporch,
691 p->bt.vfrontporch, p->bt.vsync,
692 p->bt.vbackporch, p->bt.il_vfrontporch,
693 p->bt.il_vsync, p->bt.il_vbackporch,
694 p->bt.standards, p->bt.flags);
697 pr_cont("type=%d\n", p->type);
702 static void v4l_print_enum_dv_timings(const void *arg, bool write_only)
704 const struct v4l2_enum_dv_timings *p = arg;
706 pr_cont("index=%u, ", p->index);
707 v4l_print_dv_timings(&p->timings, write_only);
710 static void v4l_print_dv_timings_cap(const void *arg, bool write_only)
712 const struct v4l2_dv_timings_cap *p = arg;
715 case V4L2_DV_BT_656_1120:
716 pr_cont("type=bt-656/1120, width=%u-%u, height=%u-%u, pixelclock=%llu-%llu, standards=0x%x, capabilities=0x%x\n",
717 p->bt.min_width, p->bt.max_width,
718 p->bt.min_height, p->bt.max_height,
719 p->bt.min_pixelclock, p->bt.max_pixelclock,
720 p->bt.standards, p->bt.capabilities);
723 pr_cont("type=%u\n", p->type);
728 static void v4l_print_frmsizeenum(const void *arg, bool write_only)
730 const struct v4l2_frmsizeenum *p = arg;
732 pr_cont("index=%u, pixelformat=%p4cc, type=%u",
733 p->index, &p->pixel_format, p->type);
735 case V4L2_FRMSIZE_TYPE_DISCRETE:
736 pr_cont(", wxh=%ux%u\n",
737 p->discrete.width, p->discrete.height);
739 case V4L2_FRMSIZE_TYPE_STEPWISE:
740 pr_cont(", min=%ux%u, max=%ux%u, step=%ux%u\n",
741 p->stepwise.min_width,
742 p->stepwise.min_height,
743 p->stepwise.max_width,
744 p->stepwise.max_height,
745 p->stepwise.step_width,
746 p->stepwise.step_height);
748 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
755 static void v4l_print_frmivalenum(const void *arg, bool write_only)
757 const struct v4l2_frmivalenum *p = arg;
759 pr_cont("index=%u, pixelformat=%p4cc, wxh=%ux%u, type=%u",
760 p->index, &p->pixel_format, p->width, p->height, p->type);
762 case V4L2_FRMIVAL_TYPE_DISCRETE:
763 pr_cont(", fps=%d/%d\n",
764 p->discrete.numerator,
765 p->discrete.denominator);
767 case V4L2_FRMIVAL_TYPE_STEPWISE:
768 pr_cont(", min=%d/%d, max=%d/%d, step=%d/%d\n",
769 p->stepwise.min.numerator,
770 p->stepwise.min.denominator,
771 p->stepwise.max.numerator,
772 p->stepwise.max.denominator,
773 p->stepwise.step.numerator,
774 p->stepwise.step.denominator);
776 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
783 static void v4l_print_event(const void *arg, bool write_only)
785 const struct v4l2_event *p = arg;
786 const struct v4l2_event_ctrl *c;
788 pr_cont("type=0x%x, pending=%u, sequence=%u, id=%u, timestamp=%llu.%9.9llu\n",
789 p->type, p->pending, p->sequence, p->id,
790 p->timestamp.tv_sec, p->timestamp.tv_nsec);
792 case V4L2_EVENT_VSYNC:
793 printk(KERN_DEBUG "field=%s\n",
794 prt_names(p->u.vsync.field, v4l2_field_names));
796 case V4L2_EVENT_CTRL:
798 printk(KERN_DEBUG "changes=0x%x, type=%u, ",
799 c->changes, c->type);
800 if (c->type == V4L2_CTRL_TYPE_INTEGER64)
801 pr_cont("value64=%lld, ", c->value64);
803 pr_cont("value=%d, ", c->value);
804 pr_cont("flags=0x%x, minimum=%d, maximum=%d, step=%d, default_value=%d\n",
805 c->flags, c->minimum, c->maximum,
806 c->step, c->default_value);
808 case V4L2_EVENT_FRAME_SYNC:
809 pr_cont("frame_sequence=%u\n",
810 p->u.frame_sync.frame_sequence);
815 static void v4l_print_event_subscription(const void *arg, bool write_only)
817 const struct v4l2_event_subscription *p = arg;
819 pr_cont("type=0x%x, id=0x%x, flags=0x%x\n",
820 p->type, p->id, p->flags);
823 static void v4l_print_sliced_vbi_cap(const void *arg, bool write_only)
825 const struct v4l2_sliced_vbi_cap *p = arg;
828 pr_cont("type=%s, service_set=0x%08x\n",
829 prt_names(p->type, v4l2_type_names), p->service_set);
830 for (i = 0; i < 24; i++)
831 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
832 p->service_lines[0][i],
833 p->service_lines[1][i]);
836 static void v4l_print_freq_band(const void *arg, bool write_only)
838 const struct v4l2_frequency_band *p = arg;
840 pr_cont("tuner=%u, type=%u, index=%u, capability=0x%x, rangelow=%u, rangehigh=%u, modulation=0x%x\n",
841 p->tuner, p->type, p->index,
842 p->capability, p->rangelow,
843 p->rangehigh, p->modulation);
846 static void v4l_print_edid(const void *arg, bool write_only)
848 const struct v4l2_edid *p = arg;
850 pr_cont("pad=%u, start_block=%u, blocks=%u\n",
851 p->pad, p->start_block, p->blocks);
854 static void v4l_print_u32(const void *arg, bool write_only)
856 pr_cont("value=%u\n", *(const u32 *)arg);
859 static void v4l_print_newline(const void *arg, bool write_only)
864 static void v4l_print_default(const void *arg, bool write_only)
866 pr_cont("driver-specific ioctl\n");
869 static bool check_ext_ctrls(struct v4l2_ext_controls *c, unsigned long ioctl)
873 /* zero the reserved fields */
875 for (i = 0; i < c->count; i++)
876 c->controls[i].reserved2[0] = 0;
879 case V4L2_CID_PRIVATE_BASE:
881 * V4L2_CID_PRIVATE_BASE cannot be used as control class
882 * when using extended controls.
883 * Only when passed in through VIDIOC_G_CTRL and VIDIOC_S_CTRL
884 * is it allowed for backwards compatibility.
886 if (ioctl == VIDIOC_G_CTRL || ioctl == VIDIOC_S_CTRL)
889 case V4L2_CTRL_WHICH_DEF_VAL:
890 /* Default value cannot be changed */
891 if (ioctl == VIDIOC_S_EXT_CTRLS ||
892 ioctl == VIDIOC_TRY_EXT_CTRLS) {
893 c->error_idx = c->count;
897 case V4L2_CTRL_WHICH_CUR_VAL:
899 case V4L2_CTRL_WHICH_REQUEST_VAL:
900 c->error_idx = c->count;
904 /* Check that all controls are from the same control class. */
905 for (i = 0; i < c->count; i++) {
906 if (V4L2_CTRL_ID2WHICH(c->controls[i].id) != c->which) {
907 c->error_idx = ioctl == VIDIOC_TRY_EXT_CTRLS ? i :
915 static int check_fmt(struct file *file, enum v4l2_buf_type type)
917 const u32 vid_caps = V4L2_CAP_VIDEO_CAPTURE |
918 V4L2_CAP_VIDEO_CAPTURE_MPLANE |
919 V4L2_CAP_VIDEO_OUTPUT |
920 V4L2_CAP_VIDEO_OUTPUT_MPLANE |
921 V4L2_CAP_VIDEO_M2M | V4L2_CAP_VIDEO_M2M_MPLANE;
922 const u32 meta_caps = V4L2_CAP_META_CAPTURE |
923 V4L2_CAP_META_OUTPUT;
924 struct video_device *vfd = video_devdata(file);
925 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
926 bool is_vid = vfd->vfl_type == VFL_TYPE_VIDEO &&
927 (vfd->device_caps & vid_caps);
928 bool is_vbi = vfd->vfl_type == VFL_TYPE_VBI;
929 bool is_sdr = vfd->vfl_type == VFL_TYPE_SDR;
930 bool is_tch = vfd->vfl_type == VFL_TYPE_TOUCH;
931 bool is_meta = vfd->vfl_type == VFL_TYPE_VIDEO &&
932 (vfd->device_caps & meta_caps);
933 bool is_rx = vfd->vfl_dir != VFL_DIR_TX;
934 bool is_tx = vfd->vfl_dir != VFL_DIR_RX;
940 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
941 if ((is_vid || is_tch) && is_rx &&
942 (ops->vidioc_g_fmt_vid_cap || ops->vidioc_g_fmt_vid_cap_mplane))
945 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
946 if ((is_vid || is_tch) && is_rx && ops->vidioc_g_fmt_vid_cap_mplane)
949 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
950 if (is_vid && is_rx && ops->vidioc_g_fmt_vid_overlay)
953 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
954 if (is_vid && is_tx &&
955 (ops->vidioc_g_fmt_vid_out || ops->vidioc_g_fmt_vid_out_mplane))
958 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
959 if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_mplane)
962 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
963 if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_overlay)
966 case V4L2_BUF_TYPE_VBI_CAPTURE:
967 if (is_vbi && is_rx && ops->vidioc_g_fmt_vbi_cap)
970 case V4L2_BUF_TYPE_VBI_OUTPUT:
971 if (is_vbi && is_tx && ops->vidioc_g_fmt_vbi_out)
974 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
975 if (is_vbi && is_rx && ops->vidioc_g_fmt_sliced_vbi_cap)
978 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
979 if (is_vbi && is_tx && ops->vidioc_g_fmt_sliced_vbi_out)
982 case V4L2_BUF_TYPE_SDR_CAPTURE:
983 if (is_sdr && is_rx && ops->vidioc_g_fmt_sdr_cap)
986 case V4L2_BUF_TYPE_SDR_OUTPUT:
987 if (is_sdr && is_tx && ops->vidioc_g_fmt_sdr_out)
990 case V4L2_BUF_TYPE_META_CAPTURE:
991 if (is_meta && is_rx && ops->vidioc_g_fmt_meta_cap)
994 case V4L2_BUF_TYPE_META_OUTPUT:
995 if (is_meta && is_tx && ops->vidioc_g_fmt_meta_out)
1004 static void v4l_sanitize_colorspace(u32 pixelformat, u32 *colorspace,
1005 u32 *encoding, u32 *quantization,
1008 bool is_hsv = pixelformat == V4L2_PIX_FMT_HSV24 ||
1009 pixelformat == V4L2_PIX_FMT_HSV32;
1011 if (!v4l2_is_colorspace_valid(*colorspace)) {
1012 *colorspace = V4L2_COLORSPACE_DEFAULT;
1013 *encoding = V4L2_YCBCR_ENC_DEFAULT;
1014 *quantization = V4L2_QUANTIZATION_DEFAULT;
1015 *xfer_func = V4L2_XFER_FUNC_DEFAULT;
1018 if ((!is_hsv && !v4l2_is_ycbcr_enc_valid(*encoding)) ||
1019 (is_hsv && !v4l2_is_hsv_enc_valid(*encoding)))
1020 *encoding = V4L2_YCBCR_ENC_DEFAULT;
1022 if (!v4l2_is_quant_valid(*quantization))
1023 *quantization = V4L2_QUANTIZATION_DEFAULT;
1025 if (!v4l2_is_xfer_func_valid(*xfer_func))
1026 *xfer_func = V4L2_XFER_FUNC_DEFAULT;
1029 static void v4l_sanitize_format(struct v4l2_format *fmt)
1031 unsigned int offset;
1033 /* Make sure num_planes is not bogus */
1034 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE ||
1035 fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
1036 fmt->fmt.pix_mp.num_planes = min_t(u32, fmt->fmt.pix_mp.num_planes,
1040 * The v4l2_pix_format structure has been extended with fields that were
1041 * not previously required to be set to zero by applications. The priv
1042 * field, when set to a magic value, indicates that the extended fields
1043 * are valid. Otherwise they will contain undefined values. To simplify
1044 * the API towards drivers zero the extended fields and set the priv
1045 * field to the magic value when the extended pixel format structure
1046 * isn't used by applications.
1048 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
1049 fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT) {
1050 if (fmt->fmt.pix.priv != V4L2_PIX_FMT_PRIV_MAGIC) {
1051 fmt->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1053 offset = offsetof(struct v4l2_pix_format, priv)
1054 + sizeof(fmt->fmt.pix.priv);
1055 memset(((void *)&fmt->fmt.pix) + offset, 0,
1056 sizeof(fmt->fmt.pix) - offset);
1060 /* Replace invalid colorspace values with defaults. */
1061 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
1062 fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT) {
1063 v4l_sanitize_colorspace(fmt->fmt.pix.pixelformat,
1064 &fmt->fmt.pix.colorspace,
1065 &fmt->fmt.pix.ycbcr_enc,
1066 &fmt->fmt.pix.quantization,
1067 &fmt->fmt.pix.xfer_func);
1068 } else if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE ||
1069 fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
1070 u32 ycbcr_enc = fmt->fmt.pix_mp.ycbcr_enc;
1071 u32 quantization = fmt->fmt.pix_mp.quantization;
1072 u32 xfer_func = fmt->fmt.pix_mp.xfer_func;
1074 v4l_sanitize_colorspace(fmt->fmt.pix_mp.pixelformat,
1075 &fmt->fmt.pix_mp.colorspace, &ycbcr_enc,
1076 &quantization, &xfer_func);
1078 fmt->fmt.pix_mp.ycbcr_enc = ycbcr_enc;
1079 fmt->fmt.pix_mp.quantization = quantization;
1080 fmt->fmt.pix_mp.xfer_func = xfer_func;
1084 static int v4l_querycap(const struct v4l2_ioctl_ops *ops,
1085 struct file *file, void *fh, void *arg)
1087 struct v4l2_capability *cap = (struct v4l2_capability *)arg;
1088 struct video_device *vfd = video_devdata(file);
1091 cap->version = LINUX_VERSION_CODE;
1092 cap->device_caps = vfd->device_caps;
1093 cap->capabilities = vfd->device_caps | V4L2_CAP_DEVICE_CAPS;
1095 media_set_bus_info(cap->bus_info, sizeof(cap->bus_info),
1098 ret = ops->vidioc_querycap(file, fh, cap);
1101 * Drivers must not change device_caps, so check for this and
1102 * warn if this happened.
1104 WARN_ON(cap->device_caps != vfd->device_caps);
1106 * Check that capabilities is a superset of
1107 * vfd->device_caps | V4L2_CAP_DEVICE_CAPS
1109 WARN_ON((cap->capabilities &
1110 (vfd->device_caps | V4L2_CAP_DEVICE_CAPS)) !=
1111 (vfd->device_caps | V4L2_CAP_DEVICE_CAPS));
1112 cap->capabilities |= V4L2_CAP_EXT_PIX_FORMAT;
1113 cap->device_caps |= V4L2_CAP_EXT_PIX_FORMAT;
1118 static int v4l_g_input(const struct v4l2_ioctl_ops *ops,
1119 struct file *file, void *fh, void *arg)
1121 struct video_device *vfd = video_devdata(file);
1123 if (vfd->device_caps & V4L2_CAP_IO_MC) {
1128 return ops->vidioc_g_input(file, fh, arg);
1131 static int v4l_g_output(const struct v4l2_ioctl_ops *ops,
1132 struct file *file, void *fh, void *arg)
1134 struct video_device *vfd = video_devdata(file);
1136 if (vfd->device_caps & V4L2_CAP_IO_MC) {
1141 return ops->vidioc_g_output(file, fh, arg);
1144 static int v4l_s_input(const struct v4l2_ioctl_ops *ops,
1145 struct file *file, void *fh, void *arg)
1147 struct video_device *vfd = video_devdata(file);
1150 ret = v4l_enable_media_source(vfd);
1154 if (vfd->device_caps & V4L2_CAP_IO_MC)
1155 return *(int *)arg ? -EINVAL : 0;
1157 return ops->vidioc_s_input(file, fh, *(unsigned int *)arg);
1160 static int v4l_s_output(const struct v4l2_ioctl_ops *ops,
1161 struct file *file, void *fh, void *arg)
1163 struct video_device *vfd = video_devdata(file);
1165 if (vfd->device_caps & V4L2_CAP_IO_MC)
1166 return *(int *)arg ? -EINVAL : 0;
1168 return ops->vidioc_s_output(file, fh, *(unsigned int *)arg);
1171 static int v4l_g_priority(const struct v4l2_ioctl_ops *ops,
1172 struct file *file, void *fh, void *arg)
1174 struct video_device *vfd;
1177 vfd = video_devdata(file);
1178 *p = v4l2_prio_max(vfd->prio);
1182 static int v4l_s_priority(const struct v4l2_ioctl_ops *ops,
1183 struct file *file, void *fh, void *arg)
1185 struct video_device *vfd;
1186 struct v4l2_fh *vfh;
1189 vfd = video_devdata(file);
1190 if (!test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags))
1192 vfh = file->private_data;
1193 return v4l2_prio_change(vfd->prio, &vfh->prio, *p);
1196 static int v4l_enuminput(const struct v4l2_ioctl_ops *ops,
1197 struct file *file, void *fh, void *arg)
1199 struct video_device *vfd = video_devdata(file);
1200 struct v4l2_input *p = arg;
1203 * We set the flags for CAP_DV_TIMINGS &
1204 * CAP_STD here based on ioctl handler provided by the
1205 * driver. If the driver doesn't support these
1206 * for a specific input, it must override these flags.
1208 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
1209 p->capabilities |= V4L2_IN_CAP_STD;
1211 if (vfd->device_caps & V4L2_CAP_IO_MC) {
1214 strscpy(p->name, vfd->name, sizeof(p->name));
1215 p->type = V4L2_INPUT_TYPE_CAMERA;
1219 return ops->vidioc_enum_input(file, fh, p);
1222 static int v4l_enumoutput(const struct v4l2_ioctl_ops *ops,
1223 struct file *file, void *fh, void *arg)
1225 struct video_device *vfd = video_devdata(file);
1226 struct v4l2_output *p = arg;
1229 * We set the flags for CAP_DV_TIMINGS &
1230 * CAP_STD here based on ioctl handler provided by the
1231 * driver. If the driver doesn't support these
1232 * for a specific output, it must override these flags.
1234 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
1235 p->capabilities |= V4L2_OUT_CAP_STD;
1237 if (vfd->device_caps & V4L2_CAP_IO_MC) {
1240 strscpy(p->name, vfd->name, sizeof(p->name));
1241 p->type = V4L2_OUTPUT_TYPE_ANALOG;
1245 return ops->vidioc_enum_output(file, fh, p);
1248 static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt)
1250 const unsigned sz = sizeof(fmt->description);
1251 const char *descr = NULL;
1255 * We depart from the normal coding style here since the descriptions
1256 * should be aligned so it is easy to see which descriptions will be
1257 * longer than 31 characters (the max length for a description).
1258 * And frankly, this is easier to read anyway.
1260 * Note that gcc will use O(log N) comparisons to find the right case.
1262 switch (fmt->pixelformat) {
1263 /* Max description length mask: descr = "0123456789012345678901234567890" */
1264 case V4L2_PIX_FMT_RGB332: descr = "8-bit RGB 3-3-2"; break;
1265 case V4L2_PIX_FMT_RGB444: descr = "16-bit A/XRGB 4-4-4-4"; break;
1266 case V4L2_PIX_FMT_ARGB444: descr = "16-bit ARGB 4-4-4-4"; break;
1267 case V4L2_PIX_FMT_XRGB444: descr = "16-bit XRGB 4-4-4-4"; break;
1268 case V4L2_PIX_FMT_RGBA444: descr = "16-bit RGBA 4-4-4-4"; break;
1269 case V4L2_PIX_FMT_RGBX444: descr = "16-bit RGBX 4-4-4-4"; break;
1270 case V4L2_PIX_FMT_ABGR444: descr = "16-bit ABGR 4-4-4-4"; break;
1271 case V4L2_PIX_FMT_XBGR444: descr = "16-bit XBGR 4-4-4-4"; break;
1272 case V4L2_PIX_FMT_BGRA444: descr = "16-bit BGRA 4-4-4-4"; break;
1273 case V4L2_PIX_FMT_BGRX444: descr = "16-bit BGRX 4-4-4-4"; break;
1274 case V4L2_PIX_FMT_RGB555: descr = "16-bit A/XRGB 1-5-5-5"; break;
1275 case V4L2_PIX_FMT_ARGB555: descr = "16-bit ARGB 1-5-5-5"; break;
1276 case V4L2_PIX_FMT_XRGB555: descr = "16-bit XRGB 1-5-5-5"; break;
1277 case V4L2_PIX_FMT_ABGR555: descr = "16-bit ABGR 1-5-5-5"; break;
1278 case V4L2_PIX_FMT_XBGR555: descr = "16-bit XBGR 1-5-5-5"; break;
1279 case V4L2_PIX_FMT_RGBA555: descr = "16-bit RGBA 5-5-5-1"; break;
1280 case V4L2_PIX_FMT_RGBX555: descr = "16-bit RGBX 5-5-5-1"; break;
1281 case V4L2_PIX_FMT_BGRA555: descr = "16-bit BGRA 5-5-5-1"; break;
1282 case V4L2_PIX_FMT_BGRX555: descr = "16-bit BGRX 5-5-5-1"; break;
1283 case V4L2_PIX_FMT_RGB565: descr = "16-bit RGB 5-6-5"; break;
1284 case V4L2_PIX_FMT_RGB555X: descr = "16-bit A/XRGB 1-5-5-5 BE"; break;
1285 case V4L2_PIX_FMT_ARGB555X: descr = "16-bit ARGB 1-5-5-5 BE"; break;
1286 case V4L2_PIX_FMT_XRGB555X: descr = "16-bit XRGB 1-5-5-5 BE"; break;
1287 case V4L2_PIX_FMT_RGB565X: descr = "16-bit RGB 5-6-5 BE"; break;
1288 case V4L2_PIX_FMT_BGR666: descr = "18-bit BGRX 6-6-6-14"; break;
1289 case V4L2_PIX_FMT_BGR24: descr = "24-bit BGR 8-8-8"; break;
1290 case V4L2_PIX_FMT_RGB24: descr = "24-bit RGB 8-8-8"; break;
1291 case V4L2_PIX_FMT_BGR32: descr = "32-bit BGRA/X 8-8-8-8"; break;
1292 case V4L2_PIX_FMT_ABGR32: descr = "32-bit BGRA 8-8-8-8"; break;
1293 case V4L2_PIX_FMT_XBGR32: descr = "32-bit BGRX 8-8-8-8"; break;
1294 case V4L2_PIX_FMT_RGB32: descr = "32-bit A/XRGB 8-8-8-8"; break;
1295 case V4L2_PIX_FMT_ARGB32: descr = "32-bit ARGB 8-8-8-8"; break;
1296 case V4L2_PIX_FMT_XRGB32: descr = "32-bit XRGB 8-8-8-8"; break;
1297 case V4L2_PIX_FMT_BGRA32: descr = "32-bit ABGR 8-8-8-8"; break;
1298 case V4L2_PIX_FMT_BGRX32: descr = "32-bit XBGR 8-8-8-8"; break;
1299 case V4L2_PIX_FMT_RGBA32: descr = "32-bit RGBA 8-8-8-8"; break;
1300 case V4L2_PIX_FMT_RGBX32: descr = "32-bit RGBX 8-8-8-8"; break;
1301 case V4L2_PIX_FMT_RGBX1010102: descr = "32-bit RGBX 10-10-10-2"; break;
1302 case V4L2_PIX_FMT_RGBA1010102: descr = "32-bit RGBA 10-10-10-2"; break;
1303 case V4L2_PIX_FMT_ARGB2101010: descr = "32-bit ARGB 2-10-10-10"; break;
1304 case V4L2_PIX_FMT_GREY: descr = "8-bit Greyscale"; break;
1305 case V4L2_PIX_FMT_Y4: descr = "4-bit Greyscale"; break;
1306 case V4L2_PIX_FMT_Y6: descr = "6-bit Greyscale"; break;
1307 case V4L2_PIX_FMT_Y10: descr = "10-bit Greyscale"; break;
1308 case V4L2_PIX_FMT_Y12: descr = "12-bit Greyscale"; break;
1309 case V4L2_PIX_FMT_Y14: descr = "14-bit Greyscale"; break;
1310 case V4L2_PIX_FMT_Y16: descr = "16-bit Greyscale"; break;
1311 case V4L2_PIX_FMT_Y16_BE: descr = "16-bit Greyscale BE"; break;
1312 case V4L2_PIX_FMT_Y10BPACK: descr = "10-bit Greyscale (Packed)"; break;
1313 case V4L2_PIX_FMT_Y10P: descr = "10-bit Greyscale (MIPI Packed)"; break;
1314 case V4L2_PIX_FMT_IPU3_Y10: descr = "10-bit greyscale (IPU3 Packed)"; break;
1315 case V4L2_PIX_FMT_Y8I: descr = "Interleaved 8-bit Greyscale"; break;
1316 case V4L2_PIX_FMT_Y12I: descr = "Interleaved 12-bit Greyscale"; break;
1317 case V4L2_PIX_FMT_Z16: descr = "16-bit Depth"; break;
1318 case V4L2_PIX_FMT_INZI: descr = "Planar 10:16 Greyscale Depth"; break;
1319 case V4L2_PIX_FMT_CNF4: descr = "4-bit Depth Confidence (Packed)"; break;
1320 case V4L2_PIX_FMT_PAL8: descr = "8-bit Palette"; break;
1321 case V4L2_PIX_FMT_UV8: descr = "8-bit Chrominance UV 4-4"; break;
1322 case V4L2_PIX_FMT_YVU410: descr = "Planar YVU 4:1:0"; break;
1323 case V4L2_PIX_FMT_YVU420: descr = "Planar YVU 4:2:0"; break;
1324 case V4L2_PIX_FMT_YUYV: descr = "YUYV 4:2:2"; break;
1325 case V4L2_PIX_FMT_YYUV: descr = "YYUV 4:2:2"; break;
1326 case V4L2_PIX_FMT_YVYU: descr = "YVYU 4:2:2"; break;
1327 case V4L2_PIX_FMT_UYVY: descr = "UYVY 4:2:2"; break;
1328 case V4L2_PIX_FMT_VYUY: descr = "VYUY 4:2:2"; break;
1329 case V4L2_PIX_FMT_YUV422P: descr = "Planar YUV 4:2:2"; break;
1330 case V4L2_PIX_FMT_YUV411P: descr = "Planar YUV 4:1:1"; break;
1331 case V4L2_PIX_FMT_Y41P: descr = "YUV 4:1:1 (Packed)"; break;
1332 case V4L2_PIX_FMT_YUV444: descr = "16-bit A/XYUV 4-4-4-4"; break;
1333 case V4L2_PIX_FMT_YUV555: descr = "16-bit A/XYUV 1-5-5-5"; break;
1334 case V4L2_PIX_FMT_YUV565: descr = "16-bit YUV 5-6-5"; break;
1335 case V4L2_PIX_FMT_YUV24: descr = "24-bit YUV 4:4:4 8-8-8"; break;
1336 case V4L2_PIX_FMT_YUV32: descr = "32-bit A/XYUV 8-8-8-8"; break;
1337 case V4L2_PIX_FMT_AYUV32: descr = "32-bit AYUV 8-8-8-8"; break;
1338 case V4L2_PIX_FMT_XYUV32: descr = "32-bit XYUV 8-8-8-8"; break;
1339 case V4L2_PIX_FMT_VUYA32: descr = "32-bit VUYA 8-8-8-8"; break;
1340 case V4L2_PIX_FMT_VUYX32: descr = "32-bit VUYX 8-8-8-8"; break;
1341 case V4L2_PIX_FMT_YUVA32: descr = "32-bit YUVA 8-8-8-8"; break;
1342 case V4L2_PIX_FMT_YUVX32: descr = "32-bit YUVX 8-8-8-8"; break;
1343 case V4L2_PIX_FMT_YUV410: descr = "Planar YUV 4:1:0"; break;
1344 case V4L2_PIX_FMT_YUV420: descr = "Planar YUV 4:2:0"; break;
1345 case V4L2_PIX_FMT_HI240: descr = "8-bit Dithered RGB (BTTV)"; break;
1346 case V4L2_PIX_FMT_M420: descr = "YUV 4:2:0 (M420)"; break;
1347 case V4L2_PIX_FMT_NV12: descr = "Y/UV 4:2:0"; break;
1348 case V4L2_PIX_FMT_NV21: descr = "Y/VU 4:2:0"; break;
1349 case V4L2_PIX_FMT_NV16: descr = "Y/UV 4:2:2"; break;
1350 case V4L2_PIX_FMT_NV61: descr = "Y/VU 4:2:2"; break;
1351 case V4L2_PIX_FMT_NV24: descr = "Y/UV 4:4:4"; break;
1352 case V4L2_PIX_FMT_NV42: descr = "Y/VU 4:4:4"; break;
1353 case V4L2_PIX_FMT_P010: descr = "10-bit Y/UV 4:2:0"; break;
1354 case V4L2_PIX_FMT_NV12_4L4: descr = "Y/UV 4:2:0 (4x4 Linear)"; break;
1355 case V4L2_PIX_FMT_NV12_16L16: descr = "Y/UV 4:2:0 (16x16 Linear)"; break;
1356 case V4L2_PIX_FMT_NV12_32L32: descr = "Y/UV 4:2:0 (32x32 Linear)"; break;
1357 case V4L2_PIX_FMT_P010_4L4: descr = "10-bit Y/UV 4:2:0 (4x4 Linear)"; break;
1358 case V4L2_PIX_FMT_NV12M: descr = "Y/UV 4:2:0 (N-C)"; break;
1359 case V4L2_PIX_FMT_NV21M: descr = "Y/VU 4:2:0 (N-C)"; break;
1360 case V4L2_PIX_FMT_NV16M: descr = "Y/UV 4:2:2 (N-C)"; break;
1361 case V4L2_PIX_FMT_NV61M: descr = "Y/VU 4:2:2 (N-C)"; break;
1362 case V4L2_PIX_FMT_NV12MT: descr = "Y/UV 4:2:0 (64x32 MB, N-C)"; break;
1363 case V4L2_PIX_FMT_NV12MT_16X16: descr = "Y/UV 4:2:0 (16x16 MB, N-C)"; break;
1364 case V4L2_PIX_FMT_YUV420M: descr = "Planar YUV 4:2:0 (N-C)"; break;
1365 case V4L2_PIX_FMT_YVU420M: descr = "Planar YVU 4:2:0 (N-C)"; break;
1366 case V4L2_PIX_FMT_YUV422M: descr = "Planar YUV 4:2:2 (N-C)"; break;
1367 case V4L2_PIX_FMT_YVU422M: descr = "Planar YVU 4:2:2 (N-C)"; break;
1368 case V4L2_PIX_FMT_YUV444M: descr = "Planar YUV 4:4:4 (N-C)"; break;
1369 case V4L2_PIX_FMT_YVU444M: descr = "Planar YVU 4:4:4 (N-C)"; break;
1370 case V4L2_PIX_FMT_SBGGR8: descr = "8-bit Bayer BGBG/GRGR"; break;
1371 case V4L2_PIX_FMT_SGBRG8: descr = "8-bit Bayer GBGB/RGRG"; break;
1372 case V4L2_PIX_FMT_SGRBG8: descr = "8-bit Bayer GRGR/BGBG"; break;
1373 case V4L2_PIX_FMT_SRGGB8: descr = "8-bit Bayer RGRG/GBGB"; break;
1374 case V4L2_PIX_FMT_SBGGR10: descr = "10-bit Bayer BGBG/GRGR"; break;
1375 case V4L2_PIX_FMT_SGBRG10: descr = "10-bit Bayer GBGB/RGRG"; break;
1376 case V4L2_PIX_FMT_SGRBG10: descr = "10-bit Bayer GRGR/BGBG"; break;
1377 case V4L2_PIX_FMT_SRGGB10: descr = "10-bit Bayer RGRG/GBGB"; break;
1378 case V4L2_PIX_FMT_SBGGR10P: descr = "10-bit Bayer BGBG/GRGR Packed"; break;
1379 case V4L2_PIX_FMT_SGBRG10P: descr = "10-bit Bayer GBGB/RGRG Packed"; break;
1380 case V4L2_PIX_FMT_SGRBG10P: descr = "10-bit Bayer GRGR/BGBG Packed"; break;
1381 case V4L2_PIX_FMT_SRGGB10P: descr = "10-bit Bayer RGRG/GBGB Packed"; break;
1382 case V4L2_PIX_FMT_IPU3_SBGGR10: descr = "10-bit bayer BGGR IPU3 Packed"; break;
1383 case V4L2_PIX_FMT_IPU3_SGBRG10: descr = "10-bit bayer GBRG IPU3 Packed"; break;
1384 case V4L2_PIX_FMT_IPU3_SGRBG10: descr = "10-bit bayer GRBG IPU3 Packed"; break;
1385 case V4L2_PIX_FMT_IPU3_SRGGB10: descr = "10-bit bayer RGGB IPU3 Packed"; break;
1386 case V4L2_PIX_FMT_SBGGR10ALAW8: descr = "8-bit Bayer BGBG/GRGR (A-law)"; break;
1387 case V4L2_PIX_FMT_SGBRG10ALAW8: descr = "8-bit Bayer GBGB/RGRG (A-law)"; break;
1388 case V4L2_PIX_FMT_SGRBG10ALAW8: descr = "8-bit Bayer GRGR/BGBG (A-law)"; break;
1389 case V4L2_PIX_FMT_SRGGB10ALAW8: descr = "8-bit Bayer RGRG/GBGB (A-law)"; break;
1390 case V4L2_PIX_FMT_SBGGR10DPCM8: descr = "8-bit Bayer BGBG/GRGR (DPCM)"; break;
1391 case V4L2_PIX_FMT_SGBRG10DPCM8: descr = "8-bit Bayer GBGB/RGRG (DPCM)"; break;
1392 case V4L2_PIX_FMT_SGRBG10DPCM8: descr = "8-bit Bayer GRGR/BGBG (DPCM)"; break;
1393 case V4L2_PIX_FMT_SRGGB10DPCM8: descr = "8-bit Bayer RGRG/GBGB (DPCM)"; break;
1394 case V4L2_PIX_FMT_SBGGR12: descr = "12-bit Bayer BGBG/GRGR"; break;
1395 case V4L2_PIX_FMT_SGBRG12: descr = "12-bit Bayer GBGB/RGRG"; break;
1396 case V4L2_PIX_FMT_SGRBG12: descr = "12-bit Bayer GRGR/BGBG"; break;
1397 case V4L2_PIX_FMT_SRGGB12: descr = "12-bit Bayer RGRG/GBGB"; break;
1398 case V4L2_PIX_FMT_SBGGR12P: descr = "12-bit Bayer BGBG/GRGR Packed"; break;
1399 case V4L2_PIX_FMT_SGBRG12P: descr = "12-bit Bayer GBGB/RGRG Packed"; break;
1400 case V4L2_PIX_FMT_SGRBG12P: descr = "12-bit Bayer GRGR/BGBG Packed"; break;
1401 case V4L2_PIX_FMT_SRGGB12P: descr = "12-bit Bayer RGRG/GBGB Packed"; break;
1402 case V4L2_PIX_FMT_SBGGR14: descr = "14-bit Bayer BGBG/GRGR"; break;
1403 case V4L2_PIX_FMT_SGBRG14: descr = "14-bit Bayer GBGB/RGRG"; break;
1404 case V4L2_PIX_FMT_SGRBG14: descr = "14-bit Bayer GRGR/BGBG"; break;
1405 case V4L2_PIX_FMT_SRGGB14: descr = "14-bit Bayer RGRG/GBGB"; break;
1406 case V4L2_PIX_FMT_SBGGR14P: descr = "14-bit Bayer BGBG/GRGR Packed"; break;
1407 case V4L2_PIX_FMT_SGBRG14P: descr = "14-bit Bayer GBGB/RGRG Packed"; break;
1408 case V4L2_PIX_FMT_SGRBG14P: descr = "14-bit Bayer GRGR/BGBG Packed"; break;
1409 case V4L2_PIX_FMT_SRGGB14P: descr = "14-bit Bayer RGRG/GBGB Packed"; break;
1410 case V4L2_PIX_FMT_SBGGR16: descr = "16-bit Bayer BGBG/GRGR"; break;
1411 case V4L2_PIX_FMT_SGBRG16: descr = "16-bit Bayer GBGB/RGRG"; break;
1412 case V4L2_PIX_FMT_SGRBG16: descr = "16-bit Bayer GRGR/BGBG"; break;
1413 case V4L2_PIX_FMT_SRGGB16: descr = "16-bit Bayer RGRG/GBGB"; break;
1414 case V4L2_PIX_FMT_SN9C20X_I420: descr = "GSPCA SN9C20X I420"; break;
1415 case V4L2_PIX_FMT_SPCA501: descr = "GSPCA SPCA501"; break;
1416 case V4L2_PIX_FMT_SPCA505: descr = "GSPCA SPCA505"; break;
1417 case V4L2_PIX_FMT_SPCA508: descr = "GSPCA SPCA508"; break;
1418 case V4L2_PIX_FMT_STV0680: descr = "GSPCA STV0680"; break;
1419 case V4L2_PIX_FMT_TM6000: descr = "A/V + VBI Mux Packet"; break;
1420 case V4L2_PIX_FMT_CIT_YYVYUY: descr = "GSPCA CIT YYVYUY"; break;
1421 case V4L2_PIX_FMT_KONICA420: descr = "GSPCA KONICA420"; break;
1422 case V4L2_PIX_FMT_MM21: descr = "Mediatek 8-bit Block Format"; break;
1423 case V4L2_PIX_FMT_HSV24: descr = "24-bit HSV 8-8-8"; break;
1424 case V4L2_PIX_FMT_HSV32: descr = "32-bit XHSV 8-8-8-8"; break;
1425 case V4L2_SDR_FMT_CU8: descr = "Complex U8"; break;
1426 case V4L2_SDR_FMT_CU16LE: descr = "Complex U16LE"; break;
1427 case V4L2_SDR_FMT_CS8: descr = "Complex S8"; break;
1428 case V4L2_SDR_FMT_CS14LE: descr = "Complex S14LE"; break;
1429 case V4L2_SDR_FMT_RU12LE: descr = "Real U12LE"; break;
1430 case V4L2_SDR_FMT_PCU16BE: descr = "Planar Complex U16BE"; break;
1431 case V4L2_SDR_FMT_PCU18BE: descr = "Planar Complex U18BE"; break;
1432 case V4L2_SDR_FMT_PCU20BE: descr = "Planar Complex U20BE"; break;
1433 case V4L2_TCH_FMT_DELTA_TD16: descr = "16-bit Signed Deltas"; break;
1434 case V4L2_TCH_FMT_DELTA_TD08: descr = "8-bit Signed Deltas"; break;
1435 case V4L2_TCH_FMT_TU16: descr = "16-bit Unsigned Touch Data"; break;
1436 case V4L2_TCH_FMT_TU08: descr = "8-bit Unsigned Touch Data"; break;
1437 case V4L2_META_FMT_VSP1_HGO: descr = "R-Car VSP1 1-D Histogram"; break;
1438 case V4L2_META_FMT_VSP1_HGT: descr = "R-Car VSP1 2-D Histogram"; break;
1439 case V4L2_META_FMT_UVC: descr = "UVC Payload Header Metadata"; break;
1440 case V4L2_META_FMT_D4XX: descr = "Intel D4xx UVC Metadata"; break;
1441 case V4L2_META_FMT_VIVID: descr = "Vivid Metadata"; break;
1442 case V4L2_META_FMT_RK_ISP1_PARAMS: descr = "Rockchip ISP1 3A Parameters"; break;
1443 case V4L2_META_FMT_RK_ISP1_STAT_3A: descr = "Rockchip ISP1 3A Statistics"; break;
1444 case V4L2_PIX_FMT_NV12_8L128: descr = "NV12 (8x128 Linear)"; break;
1445 case V4L2_PIX_FMT_NV12M_8L128: descr = "NV12M (8x128 Linear)"; break;
1446 case V4L2_PIX_FMT_NV12_10BE_8L128: descr = "10-bit NV12 (8x128 Linear, BE)"; break;
1447 case V4L2_PIX_FMT_NV12M_10BE_8L128: descr = "10-bit NV12M (8x128 Linear, BE)"; break;
1448 case V4L2_PIX_FMT_Y210: descr = "10-bit YUYV Packed"; break;
1449 case V4L2_PIX_FMT_Y212: descr = "12-bit YUYV Packed"; break;
1450 case V4L2_PIX_FMT_Y216: descr = "16-bit YUYV Packed"; break;
1453 /* Compressed formats */
1454 flags = V4L2_FMT_FLAG_COMPRESSED;
1455 switch (fmt->pixelformat) {
1456 /* Max description length mask: descr = "0123456789012345678901234567890" */
1457 case V4L2_PIX_FMT_MJPEG: descr = "Motion-JPEG"; break;
1458 case V4L2_PIX_FMT_JPEG: descr = "JFIF JPEG"; break;
1459 case V4L2_PIX_FMT_DV: descr = "1394"; break;
1460 case V4L2_PIX_FMT_MPEG: descr = "MPEG-1/2/4"; break;
1461 case V4L2_PIX_FMT_H264: descr = "H.264"; break;
1462 case V4L2_PIX_FMT_H264_NO_SC: descr = "H.264 (No Start Codes)"; break;
1463 case V4L2_PIX_FMT_H264_MVC: descr = "H.264 MVC"; break;
1464 case V4L2_PIX_FMT_H264_SLICE: descr = "H.264 Parsed Slice Data"; break;
1465 case V4L2_PIX_FMT_H263: descr = "H.263"; break;
1466 case V4L2_PIX_FMT_MPEG1: descr = "MPEG-1 ES"; break;
1467 case V4L2_PIX_FMT_MPEG2: descr = "MPEG-2 ES"; break;
1468 case V4L2_PIX_FMT_MPEG2_SLICE: descr = "MPEG-2 Parsed Slice Data"; break;
1469 case V4L2_PIX_FMT_MPEG4: descr = "MPEG-4 Part 2 ES"; break;
1470 case V4L2_PIX_FMT_XVID: descr = "Xvid"; break;
1471 case V4L2_PIX_FMT_VC1_ANNEX_G: descr = "VC-1 (SMPTE 412M Annex G)"; break;
1472 case V4L2_PIX_FMT_VC1_ANNEX_L: descr = "VC-1 (SMPTE 412M Annex L)"; break;
1473 case V4L2_PIX_FMT_VP8: descr = "VP8"; break;
1474 case V4L2_PIX_FMT_VP8_FRAME: descr = "VP8 Frame"; break;
1475 case V4L2_PIX_FMT_VP9: descr = "VP9"; break;
1476 case V4L2_PIX_FMT_VP9_FRAME: descr = "VP9 Frame"; break;
1477 case V4L2_PIX_FMT_HEVC: descr = "HEVC"; break; /* aka H.265 */
1478 case V4L2_PIX_FMT_HEVC_SLICE: descr = "HEVC Parsed Slice Data"; break;
1479 case V4L2_PIX_FMT_FWHT: descr = "FWHT"; break; /* used in vicodec */
1480 case V4L2_PIX_FMT_FWHT_STATELESS: descr = "FWHT Stateless"; break; /* used in vicodec */
1481 case V4L2_PIX_FMT_CPIA1: descr = "GSPCA CPiA YUV"; break;
1482 case V4L2_PIX_FMT_WNVA: descr = "WNVA"; break;
1483 case V4L2_PIX_FMT_SN9C10X: descr = "GSPCA SN9C10X"; break;
1484 case V4L2_PIX_FMT_PWC1: descr = "Raw Philips Webcam Type (Old)"; break;
1485 case V4L2_PIX_FMT_PWC2: descr = "Raw Philips Webcam Type (New)"; break;
1486 case V4L2_PIX_FMT_ET61X251: descr = "GSPCA ET61X251"; break;
1487 case V4L2_PIX_FMT_SPCA561: descr = "GSPCA SPCA561"; break;
1488 case V4L2_PIX_FMT_PAC207: descr = "GSPCA PAC207"; break;
1489 case V4L2_PIX_FMT_MR97310A: descr = "GSPCA MR97310A"; break;
1490 case V4L2_PIX_FMT_JL2005BCD: descr = "GSPCA JL2005BCD"; break;
1491 case V4L2_PIX_FMT_SN9C2028: descr = "GSPCA SN9C2028"; break;
1492 case V4L2_PIX_FMT_SQ905C: descr = "GSPCA SQ905C"; break;
1493 case V4L2_PIX_FMT_PJPG: descr = "GSPCA PJPG"; break;
1494 case V4L2_PIX_FMT_OV511: descr = "GSPCA OV511"; break;
1495 case V4L2_PIX_FMT_OV518: descr = "GSPCA OV518"; break;
1496 case V4L2_PIX_FMT_JPGL: descr = "JPEG Lite"; break;
1497 case V4L2_PIX_FMT_SE401: descr = "GSPCA SE401"; break;
1498 case V4L2_PIX_FMT_S5C_UYVY_JPG: descr = "S5C73MX interleaved UYVY/JPEG"; break;
1499 case V4L2_PIX_FMT_MT21C: descr = "Mediatek Compressed Format"; break;
1500 case V4L2_PIX_FMT_QC08C: descr = "QCOM Compressed 8-bit Format"; break;
1501 case V4L2_PIX_FMT_QC10C: descr = "QCOM Compressed 10-bit Format"; break;
1502 case V4L2_PIX_FMT_AJPG: descr = "Aspeed JPEG"; break;
1504 if (fmt->description[0])
1506 WARN(1, "Unknown pixelformat 0x%08x\n", fmt->pixelformat);
1508 snprintf(fmt->description, sz, "%p4cc",
1515 WARN_ON(strscpy(fmt->description, descr, sz) < 0);
1516 fmt->flags |= flags;
1519 static int v4l_enum_fmt(const struct v4l2_ioctl_ops *ops,
1520 struct file *file, void *fh, void *arg)
1522 struct video_device *vdev = video_devdata(file);
1523 struct v4l2_fmtdesc *p = arg;
1524 int ret = check_fmt(file, p->type);
1532 if (!(vdev->device_caps & V4L2_CAP_IO_MC))
1535 mbus_code = p->mbus_code;
1536 memset_after(p, 0, type);
1537 p->mbus_code = mbus_code;
1540 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1541 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1542 cap_mask = V4L2_CAP_VIDEO_CAPTURE_MPLANE |
1543 V4L2_CAP_VIDEO_M2M_MPLANE;
1544 if (!!(vdev->device_caps & cap_mask) !=
1545 (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE))
1548 if (unlikely(!ops->vidioc_enum_fmt_vid_cap))
1550 ret = ops->vidioc_enum_fmt_vid_cap(file, fh, arg);
1552 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1553 if (unlikely(!ops->vidioc_enum_fmt_vid_overlay))
1555 ret = ops->vidioc_enum_fmt_vid_overlay(file, fh, arg);
1557 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1558 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1559 cap_mask = V4L2_CAP_VIDEO_OUTPUT_MPLANE |
1560 V4L2_CAP_VIDEO_M2M_MPLANE;
1561 if (!!(vdev->device_caps & cap_mask) !=
1562 (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE))
1565 if (unlikely(!ops->vidioc_enum_fmt_vid_out))
1567 ret = ops->vidioc_enum_fmt_vid_out(file, fh, arg);
1569 case V4L2_BUF_TYPE_SDR_CAPTURE:
1570 if (unlikely(!ops->vidioc_enum_fmt_sdr_cap))
1572 ret = ops->vidioc_enum_fmt_sdr_cap(file, fh, arg);
1574 case V4L2_BUF_TYPE_SDR_OUTPUT:
1575 if (unlikely(!ops->vidioc_enum_fmt_sdr_out))
1577 ret = ops->vidioc_enum_fmt_sdr_out(file, fh, arg);
1579 case V4L2_BUF_TYPE_META_CAPTURE:
1580 if (unlikely(!ops->vidioc_enum_fmt_meta_cap))
1582 ret = ops->vidioc_enum_fmt_meta_cap(file, fh, arg);
1584 case V4L2_BUF_TYPE_META_OUTPUT:
1585 if (unlikely(!ops->vidioc_enum_fmt_meta_out))
1587 ret = ops->vidioc_enum_fmt_meta_out(file, fh, arg);
1591 v4l_fill_fmtdesc(p);
1595 static void v4l_pix_format_touch(struct v4l2_pix_format *p)
1598 * The v4l2_pix_format structure contains fields that make no sense for
1599 * touch. Set them to default values in this case.
1602 p->field = V4L2_FIELD_NONE;
1603 p->colorspace = V4L2_COLORSPACE_RAW;
1606 p->quantization = 0;
1610 static int v4l_g_fmt(const struct v4l2_ioctl_ops *ops,
1611 struct file *file, void *fh, void *arg)
1613 struct v4l2_format *p = arg;
1614 struct video_device *vfd = video_devdata(file);
1615 int ret = check_fmt(file, p->type);
1621 * fmt can't be cleared for these overlay types due to the 'clips'
1622 * 'clipcount' and 'bitmap' pointers in struct v4l2_window.
1623 * Those are provided by the user. So handle these two overlay types
1624 * first, and then just do a simple memset for the other types.
1627 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1628 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY: {
1629 struct v4l2_clip *clips = p->fmt.win.clips;
1630 u32 clipcount = p->fmt.win.clipcount;
1631 void __user *bitmap = p->fmt.win.bitmap;
1633 memset(&p->fmt, 0, sizeof(p->fmt));
1634 p->fmt.win.clips = clips;
1635 p->fmt.win.clipcount = clipcount;
1636 p->fmt.win.bitmap = bitmap;
1640 memset(&p->fmt, 0, sizeof(p->fmt));
1645 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1646 if (unlikely(!ops->vidioc_g_fmt_vid_cap))
1648 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1649 ret = ops->vidioc_g_fmt_vid_cap(file, fh, arg);
1650 /* just in case the driver zeroed it again */
1651 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1652 if (vfd->vfl_type == VFL_TYPE_TOUCH)
1653 v4l_pix_format_touch(&p->fmt.pix);
1655 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1656 return ops->vidioc_g_fmt_vid_cap_mplane(file, fh, arg);
1657 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1658 return ops->vidioc_g_fmt_vid_overlay(file, fh, arg);
1659 case V4L2_BUF_TYPE_VBI_CAPTURE:
1660 return ops->vidioc_g_fmt_vbi_cap(file, fh, arg);
1661 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1662 return ops->vidioc_g_fmt_sliced_vbi_cap(file, fh, arg);
1663 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1664 if (unlikely(!ops->vidioc_g_fmt_vid_out))
1666 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1667 ret = ops->vidioc_g_fmt_vid_out(file, fh, arg);
1668 /* just in case the driver zeroed it again */
1669 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1671 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1672 return ops->vidioc_g_fmt_vid_out_mplane(file, fh, arg);
1673 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1674 return ops->vidioc_g_fmt_vid_out_overlay(file, fh, arg);
1675 case V4L2_BUF_TYPE_VBI_OUTPUT:
1676 return ops->vidioc_g_fmt_vbi_out(file, fh, arg);
1677 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1678 return ops->vidioc_g_fmt_sliced_vbi_out(file, fh, arg);
1679 case V4L2_BUF_TYPE_SDR_CAPTURE:
1680 return ops->vidioc_g_fmt_sdr_cap(file, fh, arg);
1681 case V4L2_BUF_TYPE_SDR_OUTPUT:
1682 return ops->vidioc_g_fmt_sdr_out(file, fh, arg);
1683 case V4L2_BUF_TYPE_META_CAPTURE:
1684 return ops->vidioc_g_fmt_meta_cap(file, fh, arg);
1685 case V4L2_BUF_TYPE_META_OUTPUT:
1686 return ops->vidioc_g_fmt_meta_out(file, fh, arg);
1691 static int v4l_s_fmt(const struct v4l2_ioctl_ops *ops,
1692 struct file *file, void *fh, void *arg)
1694 struct v4l2_format *p = arg;
1695 struct video_device *vfd = video_devdata(file);
1696 int ret = check_fmt(file, p->type);
1702 ret = v4l_enable_media_source(vfd);
1705 v4l_sanitize_format(p);
1708 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1709 if (unlikely(!ops->vidioc_s_fmt_vid_cap))
1711 memset_after(p, 0, fmt.pix);
1712 ret = ops->vidioc_s_fmt_vid_cap(file, fh, arg);
1713 /* just in case the driver zeroed it again */
1714 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1715 if (vfd->vfl_type == VFL_TYPE_TOUCH)
1716 v4l_pix_format_touch(&p->fmt.pix);
1718 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1719 if (unlikely(!ops->vidioc_s_fmt_vid_cap_mplane))
1721 memset_after(p, 0, fmt.pix_mp.xfer_func);
1722 for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
1723 memset_after(&p->fmt.pix_mp.plane_fmt[i],
1725 return ops->vidioc_s_fmt_vid_cap_mplane(file, fh, arg);
1726 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1727 if (unlikely(!ops->vidioc_s_fmt_vid_overlay))
1729 memset_after(p, 0, fmt.win);
1730 return ops->vidioc_s_fmt_vid_overlay(file, fh, arg);
1731 case V4L2_BUF_TYPE_VBI_CAPTURE:
1732 if (unlikely(!ops->vidioc_s_fmt_vbi_cap))
1734 memset_after(p, 0, fmt.vbi.flags);
1735 return ops->vidioc_s_fmt_vbi_cap(file, fh, arg);
1736 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1737 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_cap))
1739 memset_after(p, 0, fmt.sliced.io_size);
1740 return ops->vidioc_s_fmt_sliced_vbi_cap(file, fh, arg);
1741 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1742 if (unlikely(!ops->vidioc_s_fmt_vid_out))
1744 memset_after(p, 0, fmt.pix);
1745 ret = ops->vidioc_s_fmt_vid_out(file, fh, arg);
1746 /* just in case the driver zeroed it again */
1747 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1749 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1750 if (unlikely(!ops->vidioc_s_fmt_vid_out_mplane))
1752 memset_after(p, 0, fmt.pix_mp.xfer_func);
1753 for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
1754 memset_after(&p->fmt.pix_mp.plane_fmt[i],
1756 return ops->vidioc_s_fmt_vid_out_mplane(file, fh, arg);
1757 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1758 if (unlikely(!ops->vidioc_s_fmt_vid_out_overlay))
1760 memset_after(p, 0, fmt.win);
1761 return ops->vidioc_s_fmt_vid_out_overlay(file, fh, arg);
1762 case V4L2_BUF_TYPE_VBI_OUTPUT:
1763 if (unlikely(!ops->vidioc_s_fmt_vbi_out))
1765 memset_after(p, 0, fmt.vbi.flags);
1766 return ops->vidioc_s_fmt_vbi_out(file, fh, arg);
1767 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1768 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_out))
1770 memset_after(p, 0, fmt.sliced.io_size);
1771 return ops->vidioc_s_fmt_sliced_vbi_out(file, fh, arg);
1772 case V4L2_BUF_TYPE_SDR_CAPTURE:
1773 if (unlikely(!ops->vidioc_s_fmt_sdr_cap))
1775 memset_after(p, 0, fmt.sdr.buffersize);
1776 return ops->vidioc_s_fmt_sdr_cap(file, fh, arg);
1777 case V4L2_BUF_TYPE_SDR_OUTPUT:
1778 if (unlikely(!ops->vidioc_s_fmt_sdr_out))
1780 memset_after(p, 0, fmt.sdr.buffersize);
1781 return ops->vidioc_s_fmt_sdr_out(file, fh, arg);
1782 case V4L2_BUF_TYPE_META_CAPTURE:
1783 if (unlikely(!ops->vidioc_s_fmt_meta_cap))
1785 memset_after(p, 0, fmt.meta);
1786 return ops->vidioc_s_fmt_meta_cap(file, fh, arg);
1787 case V4L2_BUF_TYPE_META_OUTPUT:
1788 if (unlikely(!ops->vidioc_s_fmt_meta_out))
1790 memset_after(p, 0, fmt.meta);
1791 return ops->vidioc_s_fmt_meta_out(file, fh, arg);
1796 static int v4l_try_fmt(const struct v4l2_ioctl_ops *ops,
1797 struct file *file, void *fh, void *arg)
1799 struct v4l2_format *p = arg;
1800 struct video_device *vfd = video_devdata(file);
1801 int ret = check_fmt(file, p->type);
1807 v4l_sanitize_format(p);
1810 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1811 if (unlikely(!ops->vidioc_try_fmt_vid_cap))
1813 memset_after(p, 0, fmt.pix);
1814 ret = ops->vidioc_try_fmt_vid_cap(file, fh, arg);
1815 /* just in case the driver zeroed it again */
1816 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1817 if (vfd->vfl_type == VFL_TYPE_TOUCH)
1818 v4l_pix_format_touch(&p->fmt.pix);
1820 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1821 if (unlikely(!ops->vidioc_try_fmt_vid_cap_mplane))
1823 memset_after(p, 0, fmt.pix_mp.xfer_func);
1824 for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
1825 memset_after(&p->fmt.pix_mp.plane_fmt[i],
1827 return ops->vidioc_try_fmt_vid_cap_mplane(file, fh, arg);
1828 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1829 if (unlikely(!ops->vidioc_try_fmt_vid_overlay))
1831 memset_after(p, 0, fmt.win);
1832 return ops->vidioc_try_fmt_vid_overlay(file, fh, arg);
1833 case V4L2_BUF_TYPE_VBI_CAPTURE:
1834 if (unlikely(!ops->vidioc_try_fmt_vbi_cap))
1836 memset_after(p, 0, fmt.vbi.flags);
1837 return ops->vidioc_try_fmt_vbi_cap(file, fh, arg);
1838 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1839 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_cap))
1841 memset_after(p, 0, fmt.sliced.io_size);
1842 return ops->vidioc_try_fmt_sliced_vbi_cap(file, fh, arg);
1843 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1844 if (unlikely(!ops->vidioc_try_fmt_vid_out))
1846 memset_after(p, 0, fmt.pix);
1847 ret = ops->vidioc_try_fmt_vid_out(file, fh, arg);
1848 /* just in case the driver zeroed it again */
1849 p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
1851 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1852 if (unlikely(!ops->vidioc_try_fmt_vid_out_mplane))
1854 memset_after(p, 0, fmt.pix_mp.xfer_func);
1855 for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
1856 memset_after(&p->fmt.pix_mp.plane_fmt[i],
1858 return ops->vidioc_try_fmt_vid_out_mplane(file, fh, arg);
1859 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1860 if (unlikely(!ops->vidioc_try_fmt_vid_out_overlay))
1862 memset_after(p, 0, fmt.win);
1863 return ops->vidioc_try_fmt_vid_out_overlay(file, fh, arg);
1864 case V4L2_BUF_TYPE_VBI_OUTPUT:
1865 if (unlikely(!ops->vidioc_try_fmt_vbi_out))
1867 memset_after(p, 0, fmt.vbi.flags);
1868 return ops->vidioc_try_fmt_vbi_out(file, fh, arg);
1869 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1870 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_out))
1872 memset_after(p, 0, fmt.sliced.io_size);
1873 return ops->vidioc_try_fmt_sliced_vbi_out(file, fh, arg);
1874 case V4L2_BUF_TYPE_SDR_CAPTURE:
1875 if (unlikely(!ops->vidioc_try_fmt_sdr_cap))
1877 memset_after(p, 0, fmt.sdr.buffersize);
1878 return ops->vidioc_try_fmt_sdr_cap(file, fh, arg);
1879 case V4L2_BUF_TYPE_SDR_OUTPUT:
1880 if (unlikely(!ops->vidioc_try_fmt_sdr_out))
1882 memset_after(p, 0, fmt.sdr.buffersize);
1883 return ops->vidioc_try_fmt_sdr_out(file, fh, arg);
1884 case V4L2_BUF_TYPE_META_CAPTURE:
1885 if (unlikely(!ops->vidioc_try_fmt_meta_cap))
1887 memset_after(p, 0, fmt.meta);
1888 return ops->vidioc_try_fmt_meta_cap(file, fh, arg);
1889 case V4L2_BUF_TYPE_META_OUTPUT:
1890 if (unlikely(!ops->vidioc_try_fmt_meta_out))
1892 memset_after(p, 0, fmt.meta);
1893 return ops->vidioc_try_fmt_meta_out(file, fh, arg);
1898 static int v4l_streamon(const struct v4l2_ioctl_ops *ops,
1899 struct file *file, void *fh, void *arg)
1901 return ops->vidioc_streamon(file, fh, *(unsigned int *)arg);
1904 static int v4l_streamoff(const struct v4l2_ioctl_ops *ops,
1905 struct file *file, void *fh, void *arg)
1907 return ops->vidioc_streamoff(file, fh, *(unsigned int *)arg);
1910 static int v4l_g_tuner(const struct v4l2_ioctl_ops *ops,
1911 struct file *file, void *fh, void *arg)
1913 struct video_device *vfd = video_devdata(file);
1914 struct v4l2_tuner *p = arg;
1917 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1918 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1919 err = ops->vidioc_g_tuner(file, fh, p);
1921 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1925 static int v4l_s_tuner(const struct v4l2_ioctl_ops *ops,
1926 struct file *file, void *fh, void *arg)
1928 struct video_device *vfd = video_devdata(file);
1929 struct v4l2_tuner *p = arg;
1932 ret = v4l_enable_media_source(vfd);
1935 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1936 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1937 return ops->vidioc_s_tuner(file, fh, p);
1940 static int v4l_g_modulator(const struct v4l2_ioctl_ops *ops,
1941 struct file *file, void *fh, void *arg)
1943 struct video_device *vfd = video_devdata(file);
1944 struct v4l2_modulator *p = arg;
1947 if (vfd->vfl_type == VFL_TYPE_RADIO)
1948 p->type = V4L2_TUNER_RADIO;
1950 err = ops->vidioc_g_modulator(file, fh, p);
1952 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1956 static int v4l_s_modulator(const struct v4l2_ioctl_ops *ops,
1957 struct file *file, void *fh, void *arg)
1959 struct video_device *vfd = video_devdata(file);
1960 struct v4l2_modulator *p = arg;
1962 if (vfd->vfl_type == VFL_TYPE_RADIO)
1963 p->type = V4L2_TUNER_RADIO;
1965 return ops->vidioc_s_modulator(file, fh, p);
1968 static int v4l_g_frequency(const struct v4l2_ioctl_ops *ops,
1969 struct file *file, void *fh, void *arg)
1971 struct video_device *vfd = video_devdata(file);
1972 struct v4l2_frequency *p = arg;
1974 if (vfd->vfl_type == VFL_TYPE_SDR)
1975 p->type = V4L2_TUNER_SDR;
1977 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1978 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1979 return ops->vidioc_g_frequency(file, fh, p);
1982 static int v4l_s_frequency(const struct v4l2_ioctl_ops *ops,
1983 struct file *file, void *fh, void *arg)
1985 struct video_device *vfd = video_devdata(file);
1986 const struct v4l2_frequency *p = arg;
1987 enum v4l2_tuner_type type;
1990 ret = v4l_enable_media_source(vfd);
1993 if (vfd->vfl_type == VFL_TYPE_SDR) {
1994 if (p->type != V4L2_TUNER_SDR && p->type != V4L2_TUNER_RF)
1997 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1998 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1999 if (type != p->type)
2002 return ops->vidioc_s_frequency(file, fh, p);
2005 static int v4l_enumstd(const struct v4l2_ioctl_ops *ops,
2006 struct file *file, void *fh, void *arg)
2008 struct video_device *vfd = video_devdata(file);
2009 struct v4l2_standard *p = arg;
2011 return v4l_video_std_enumstd(p, vfd->tvnorms);
2014 static int v4l_s_std(const struct v4l2_ioctl_ops *ops,
2015 struct file *file, void *fh, void *arg)
2017 struct video_device *vfd = video_devdata(file);
2018 v4l2_std_id id = *(v4l2_std_id *)arg, norm;
2021 ret = v4l_enable_media_source(vfd);
2024 norm = id & vfd->tvnorms;
2025 if (vfd->tvnorms && !norm) /* Check if std is supported */
2028 /* Calls the specific handler */
2029 return ops->vidioc_s_std(file, fh, norm);
2032 static int v4l_querystd(const struct v4l2_ioctl_ops *ops,
2033 struct file *file, void *fh, void *arg)
2035 struct video_device *vfd = video_devdata(file);
2036 v4l2_std_id *p = arg;
2039 ret = v4l_enable_media_source(vfd);
2043 * If no signal is detected, then the driver should return
2044 * V4L2_STD_UNKNOWN. Otherwise it should return tvnorms with
2045 * any standards that do not apply removed.
2047 * This means that tuners, audio and video decoders can join
2048 * their efforts to improve the standards detection.
2051 return ops->vidioc_querystd(file, fh, arg);
2054 static int v4l_s_hw_freq_seek(const struct v4l2_ioctl_ops *ops,
2055 struct file *file, void *fh, void *arg)
2057 struct video_device *vfd = video_devdata(file);
2058 struct v4l2_hw_freq_seek *p = arg;
2059 enum v4l2_tuner_type type;
2062 ret = v4l_enable_media_source(vfd);
2065 /* s_hw_freq_seek is not supported for SDR for now */
2066 if (vfd->vfl_type == VFL_TYPE_SDR)
2069 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
2070 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
2071 if (p->type != type)
2073 return ops->vidioc_s_hw_freq_seek(file, fh, p);
2076 static int v4l_overlay(const struct v4l2_ioctl_ops *ops,
2077 struct file *file, void *fh, void *arg)
2079 return ops->vidioc_overlay(file, fh, *(unsigned int *)arg);
2082 static int v4l_reqbufs(const struct v4l2_ioctl_ops *ops,
2083 struct file *file, void *fh, void *arg)
2085 struct v4l2_requestbuffers *p = arg;
2086 int ret = check_fmt(file, p->type);
2091 memset_after(p, 0, flags);
2093 return ops->vidioc_reqbufs(file, fh, p);
2096 static int v4l_querybuf(const struct v4l2_ioctl_ops *ops,
2097 struct file *file, void *fh, void *arg)
2099 struct v4l2_buffer *p = arg;
2100 int ret = check_fmt(file, p->type);
2102 return ret ? ret : ops->vidioc_querybuf(file, fh, p);
2105 static int v4l_qbuf(const struct v4l2_ioctl_ops *ops,
2106 struct file *file, void *fh, void *arg)
2108 struct v4l2_buffer *p = arg;
2109 int ret = check_fmt(file, p->type);
2111 return ret ? ret : ops->vidioc_qbuf(file, fh, p);
2114 static int v4l_dqbuf(const struct v4l2_ioctl_ops *ops,
2115 struct file *file, void *fh, void *arg)
2117 struct v4l2_buffer *p = arg;
2118 int ret = check_fmt(file, p->type);
2120 return ret ? ret : ops->vidioc_dqbuf(file, fh, p);
2123 static int v4l_create_bufs(const struct v4l2_ioctl_ops *ops,
2124 struct file *file, void *fh, void *arg)
2126 struct v4l2_create_buffers *create = arg;
2127 int ret = check_fmt(file, create->format.type);
2132 memset_after(create, 0, flags);
2134 v4l_sanitize_format(&create->format);
2136 ret = ops->vidioc_create_bufs(file, fh, create);
2138 if (create->format.type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
2139 create->format.type == V4L2_BUF_TYPE_VIDEO_OUTPUT)
2140 create->format.fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
2145 static int v4l_prepare_buf(const struct v4l2_ioctl_ops *ops,
2146 struct file *file, void *fh, void *arg)
2148 struct v4l2_buffer *b = arg;
2149 int ret = check_fmt(file, b->type);
2151 return ret ? ret : ops->vidioc_prepare_buf(file, fh, b);
2154 static int v4l_g_parm(const struct v4l2_ioctl_ops *ops,
2155 struct file *file, void *fh, void *arg)
2157 struct video_device *vfd = video_devdata(file);
2158 struct v4l2_streamparm *p = arg;
2160 int ret = check_fmt(file, p->type);
2164 if (ops->vidioc_g_parm)
2165 return ops->vidioc_g_parm(file, fh, p);
2166 if (p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
2167 p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2169 if (vfd->device_caps & V4L2_CAP_READWRITE)
2170 p->parm.capture.readbuffers = 2;
2171 ret = ops->vidioc_g_std(file, fh, &std);
2173 v4l2_video_std_frame_period(std, &p->parm.capture.timeperframe);
2177 static int v4l_s_parm(const struct v4l2_ioctl_ops *ops,
2178 struct file *file, void *fh, void *arg)
2180 struct v4l2_streamparm *p = arg;
2181 int ret = check_fmt(file, p->type);
2186 /* Note: extendedmode is never used in drivers */
2187 if (V4L2_TYPE_IS_OUTPUT(p->type)) {
2188 memset(p->parm.output.reserved, 0,
2189 sizeof(p->parm.output.reserved));
2190 p->parm.output.extendedmode = 0;
2191 p->parm.output.outputmode &= V4L2_MODE_HIGHQUALITY;
2193 memset(p->parm.capture.reserved, 0,
2194 sizeof(p->parm.capture.reserved));
2195 p->parm.capture.extendedmode = 0;
2196 p->parm.capture.capturemode &= V4L2_MODE_HIGHQUALITY;
2198 return ops->vidioc_s_parm(file, fh, p);
2201 static int v4l_queryctrl(const struct v4l2_ioctl_ops *ops,
2202 struct file *file, void *fh, void *arg)
2204 struct video_device *vfd = video_devdata(file);
2205 struct v4l2_queryctrl *p = arg;
2206 struct v4l2_fh *vfh =
2207 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2209 if (vfh && vfh->ctrl_handler)
2210 return v4l2_queryctrl(vfh->ctrl_handler, p);
2211 if (vfd->ctrl_handler)
2212 return v4l2_queryctrl(vfd->ctrl_handler, p);
2213 if (ops->vidioc_queryctrl)
2214 return ops->vidioc_queryctrl(file, fh, p);
2218 static int v4l_query_ext_ctrl(const struct v4l2_ioctl_ops *ops,
2219 struct file *file, void *fh, void *arg)
2221 struct video_device *vfd = video_devdata(file);
2222 struct v4l2_query_ext_ctrl *p = arg;
2223 struct v4l2_fh *vfh =
2224 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2226 if (vfh && vfh->ctrl_handler)
2227 return v4l2_query_ext_ctrl(vfh->ctrl_handler, p);
2228 if (vfd->ctrl_handler)
2229 return v4l2_query_ext_ctrl(vfd->ctrl_handler, p);
2230 if (ops->vidioc_query_ext_ctrl)
2231 return ops->vidioc_query_ext_ctrl(file, fh, p);
2235 static int v4l_querymenu(const struct v4l2_ioctl_ops *ops,
2236 struct file *file, void *fh, void *arg)
2238 struct video_device *vfd = video_devdata(file);
2239 struct v4l2_querymenu *p = arg;
2240 struct v4l2_fh *vfh =
2241 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2243 if (vfh && vfh->ctrl_handler)
2244 return v4l2_querymenu(vfh->ctrl_handler, p);
2245 if (vfd->ctrl_handler)
2246 return v4l2_querymenu(vfd->ctrl_handler, p);
2247 if (ops->vidioc_querymenu)
2248 return ops->vidioc_querymenu(file, fh, p);
2252 static int v4l_g_ctrl(const struct v4l2_ioctl_ops *ops,
2253 struct file *file, void *fh, void *arg)
2255 struct video_device *vfd = video_devdata(file);
2256 struct v4l2_control *p = arg;
2257 struct v4l2_fh *vfh =
2258 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2259 struct v4l2_ext_controls ctrls;
2260 struct v4l2_ext_control ctrl;
2262 if (vfh && vfh->ctrl_handler)
2263 return v4l2_g_ctrl(vfh->ctrl_handler, p);
2264 if (vfd->ctrl_handler)
2265 return v4l2_g_ctrl(vfd->ctrl_handler, p);
2266 if (ops->vidioc_g_ctrl)
2267 return ops->vidioc_g_ctrl(file, fh, p);
2268 if (ops->vidioc_g_ext_ctrls == NULL)
2271 ctrls.which = V4L2_CTRL_ID2WHICH(p->id);
2273 ctrls.controls = &ctrl;
2275 ctrl.value = p->value;
2276 if (check_ext_ctrls(&ctrls, VIDIOC_G_CTRL)) {
2277 int ret = ops->vidioc_g_ext_ctrls(file, fh, &ctrls);
2280 p->value = ctrl.value;
2286 static int v4l_s_ctrl(const struct v4l2_ioctl_ops *ops,
2287 struct file *file, void *fh, void *arg)
2289 struct video_device *vfd = video_devdata(file);
2290 struct v4l2_control *p = arg;
2291 struct v4l2_fh *vfh =
2292 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2293 struct v4l2_ext_controls ctrls;
2294 struct v4l2_ext_control ctrl;
2297 if (vfh && vfh->ctrl_handler)
2298 return v4l2_s_ctrl(vfh, vfh->ctrl_handler, p);
2299 if (vfd->ctrl_handler)
2300 return v4l2_s_ctrl(NULL, vfd->ctrl_handler, p);
2301 if (ops->vidioc_s_ctrl)
2302 return ops->vidioc_s_ctrl(file, fh, p);
2303 if (ops->vidioc_s_ext_ctrls == NULL)
2306 ctrls.which = V4L2_CTRL_ID2WHICH(p->id);
2308 ctrls.controls = &ctrl;
2310 ctrl.value = p->value;
2311 if (!check_ext_ctrls(&ctrls, VIDIOC_S_CTRL))
2313 ret = ops->vidioc_s_ext_ctrls(file, fh, &ctrls);
2314 p->value = ctrl.value;
2318 static int v4l_g_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2319 struct file *file, void *fh, void *arg)
2321 struct video_device *vfd = video_devdata(file);
2322 struct v4l2_ext_controls *p = arg;
2323 struct v4l2_fh *vfh =
2324 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2326 p->error_idx = p->count;
2327 if (vfh && vfh->ctrl_handler)
2328 return v4l2_g_ext_ctrls(vfh->ctrl_handler,
2329 vfd, vfd->v4l2_dev->mdev, p);
2330 if (vfd->ctrl_handler)
2331 return v4l2_g_ext_ctrls(vfd->ctrl_handler,
2332 vfd, vfd->v4l2_dev->mdev, p);
2333 if (ops->vidioc_g_ext_ctrls == NULL)
2335 return check_ext_ctrls(p, VIDIOC_G_EXT_CTRLS) ?
2336 ops->vidioc_g_ext_ctrls(file, fh, p) : -EINVAL;
2339 static int v4l_s_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2340 struct file *file, void *fh, void *arg)
2342 struct video_device *vfd = video_devdata(file);
2343 struct v4l2_ext_controls *p = arg;
2344 struct v4l2_fh *vfh =
2345 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2347 p->error_idx = p->count;
2348 if (vfh && vfh->ctrl_handler)
2349 return v4l2_s_ext_ctrls(vfh, vfh->ctrl_handler,
2350 vfd, vfd->v4l2_dev->mdev, p);
2351 if (vfd->ctrl_handler)
2352 return v4l2_s_ext_ctrls(NULL, vfd->ctrl_handler,
2353 vfd, vfd->v4l2_dev->mdev, p);
2354 if (ops->vidioc_s_ext_ctrls == NULL)
2356 return check_ext_ctrls(p, VIDIOC_S_EXT_CTRLS) ?
2357 ops->vidioc_s_ext_ctrls(file, fh, p) : -EINVAL;
2360 static int v4l_try_ext_ctrls(const struct v4l2_ioctl_ops *ops,
2361 struct file *file, void *fh, void *arg)
2363 struct video_device *vfd = video_devdata(file);
2364 struct v4l2_ext_controls *p = arg;
2365 struct v4l2_fh *vfh =
2366 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
2368 p->error_idx = p->count;
2369 if (vfh && vfh->ctrl_handler)
2370 return v4l2_try_ext_ctrls(vfh->ctrl_handler,
2371 vfd, vfd->v4l2_dev->mdev, p);
2372 if (vfd->ctrl_handler)
2373 return v4l2_try_ext_ctrls(vfd->ctrl_handler,
2374 vfd, vfd->v4l2_dev->mdev, p);
2375 if (ops->vidioc_try_ext_ctrls == NULL)
2377 return check_ext_ctrls(p, VIDIOC_TRY_EXT_CTRLS) ?
2378 ops->vidioc_try_ext_ctrls(file, fh, p) : -EINVAL;
2382 * The selection API specified originally that the _MPLANE buffer types
2383 * shouldn't be used. The reasons for this are lost in the mists of time
2384 * (or just really crappy memories). Regardless, this is really annoying
2385 * for userspace. So to keep things simple we map _MPLANE buffer types
2386 * to their 'regular' counterparts before calling the driver. And we
2387 * restore it afterwards. This way applications can use either buffer
2388 * type and drivers don't need to check for both.
2390 static int v4l_g_selection(const struct v4l2_ioctl_ops *ops,
2391 struct file *file, void *fh, void *arg)
2393 struct v4l2_selection *p = arg;
2394 u32 old_type = p->type;
2397 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2398 p->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2399 else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
2400 p->type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
2401 ret = ops->vidioc_g_selection(file, fh, p);
2406 static int v4l_s_selection(const struct v4l2_ioctl_ops *ops,
2407 struct file *file, void *fh, void *arg)
2409 struct v4l2_selection *p = arg;
2410 u32 old_type = p->type;
2413 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2414 p->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2415 else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
2416 p->type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
2417 ret = ops->vidioc_s_selection(file, fh, p);
2422 static int v4l_g_crop(const struct v4l2_ioctl_ops *ops,
2423 struct file *file, void *fh, void *arg)
2425 struct video_device *vfd = video_devdata(file);
2426 struct v4l2_crop *p = arg;
2427 struct v4l2_selection s = {
2432 /* simulate capture crop using selection api */
2434 /* crop means compose for output devices */
2435 if (V4L2_TYPE_IS_OUTPUT(p->type))
2436 s.target = V4L2_SEL_TGT_COMPOSE;
2438 s.target = V4L2_SEL_TGT_CROP;
2440 if (test_bit(V4L2_FL_QUIRK_INVERTED_CROP, &vfd->flags))
2441 s.target = s.target == V4L2_SEL_TGT_COMPOSE ?
2442 V4L2_SEL_TGT_CROP : V4L2_SEL_TGT_COMPOSE;
2444 ret = v4l_g_selection(ops, file, fh, &s);
2446 /* copying results to old structure on success */
2452 static int v4l_s_crop(const struct v4l2_ioctl_ops *ops,
2453 struct file *file, void *fh, void *arg)
2455 struct video_device *vfd = video_devdata(file);
2456 struct v4l2_crop *p = arg;
2457 struct v4l2_selection s = {
2462 /* simulate capture crop using selection api */
2464 /* crop means compose for output devices */
2465 if (V4L2_TYPE_IS_OUTPUT(p->type))
2466 s.target = V4L2_SEL_TGT_COMPOSE;
2468 s.target = V4L2_SEL_TGT_CROP;
2470 if (test_bit(V4L2_FL_QUIRK_INVERTED_CROP, &vfd->flags))
2471 s.target = s.target == V4L2_SEL_TGT_COMPOSE ?
2472 V4L2_SEL_TGT_CROP : V4L2_SEL_TGT_COMPOSE;
2474 return v4l_s_selection(ops, file, fh, &s);
2477 static int v4l_cropcap(const struct v4l2_ioctl_ops *ops,
2478 struct file *file, void *fh, void *arg)
2480 struct video_device *vfd = video_devdata(file);
2481 struct v4l2_cropcap *p = arg;
2482 struct v4l2_selection s = { .type = p->type };
2485 /* setting trivial pixelaspect */
2486 p->pixelaspect.numerator = 1;
2487 p->pixelaspect.denominator = 1;
2489 if (s.type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
2490 s.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2491 else if (s.type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
2492 s.type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
2495 * The determine_valid_ioctls() call already should ensure
2496 * that this can never happen, but just in case...
2498 if (WARN_ON(!ops->vidioc_g_selection))
2501 if (ops->vidioc_g_pixelaspect)
2502 ret = ops->vidioc_g_pixelaspect(file, fh, s.type,
2506 * Ignore ENOTTY or ENOIOCTLCMD error returns, just use the
2507 * square pixel aspect ratio in that case.
2509 if (ret && ret != -ENOTTY && ret != -ENOIOCTLCMD)
2512 /* Use g_selection() to fill in the bounds and defrect rectangles */
2514 /* obtaining bounds */
2515 if (V4L2_TYPE_IS_OUTPUT(p->type))
2516 s.target = V4L2_SEL_TGT_COMPOSE_BOUNDS;
2518 s.target = V4L2_SEL_TGT_CROP_BOUNDS;
2520 if (test_bit(V4L2_FL_QUIRK_INVERTED_CROP, &vfd->flags))
2521 s.target = s.target == V4L2_SEL_TGT_COMPOSE_BOUNDS ?
2522 V4L2_SEL_TGT_CROP_BOUNDS : V4L2_SEL_TGT_COMPOSE_BOUNDS;
2524 ret = v4l_g_selection(ops, file, fh, &s);
2529 /* obtaining defrect */
2530 if (s.target == V4L2_SEL_TGT_COMPOSE_BOUNDS)
2531 s.target = V4L2_SEL_TGT_COMPOSE_DEFAULT;
2533 s.target = V4L2_SEL_TGT_CROP_DEFAULT;
2535 ret = v4l_g_selection(ops, file, fh, &s);
2543 static int v4l_log_status(const struct v4l2_ioctl_ops *ops,
2544 struct file *file, void *fh, void *arg)
2546 struct video_device *vfd = video_devdata(file);
2550 pr_info("%s: ================= START STATUS =================\n",
2551 vfd->v4l2_dev->name);
2552 ret = ops->vidioc_log_status(file, fh);
2554 pr_info("%s: ================== END STATUS ==================\n",
2555 vfd->v4l2_dev->name);
2559 static int v4l_dbg_g_register(const struct v4l2_ioctl_ops *ops,
2560 struct file *file, void *fh, void *arg)
2562 #ifdef CONFIG_VIDEO_ADV_DEBUG
2563 struct v4l2_dbg_register *p = arg;
2564 struct video_device *vfd = video_devdata(file);
2565 struct v4l2_subdev *sd;
2568 if (!capable(CAP_SYS_ADMIN))
2570 if (p->match.type == V4L2_CHIP_MATCH_SUBDEV) {
2571 if (vfd->v4l2_dev == NULL)
2573 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev)
2574 if (p->match.addr == idx++)
2575 return v4l2_subdev_call(sd, core, g_register, p);
2578 if (ops->vidioc_g_register && p->match.type == V4L2_CHIP_MATCH_BRIDGE &&
2579 (ops->vidioc_g_chip_info || p->match.addr == 0))
2580 return ops->vidioc_g_register(file, fh, p);
2587 static int v4l_dbg_s_register(const struct v4l2_ioctl_ops *ops,
2588 struct file *file, void *fh, void *arg)
2590 #ifdef CONFIG_VIDEO_ADV_DEBUG
2591 const struct v4l2_dbg_register *p = arg;
2592 struct video_device *vfd = video_devdata(file);
2593 struct v4l2_subdev *sd;
2596 if (!capable(CAP_SYS_ADMIN))
2598 if (p->match.type == V4L2_CHIP_MATCH_SUBDEV) {
2599 if (vfd->v4l2_dev == NULL)
2601 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev)
2602 if (p->match.addr == idx++)
2603 return v4l2_subdev_call(sd, core, s_register, p);
2606 if (ops->vidioc_s_register && p->match.type == V4L2_CHIP_MATCH_BRIDGE &&
2607 (ops->vidioc_g_chip_info || p->match.addr == 0))
2608 return ops->vidioc_s_register(file, fh, p);
2615 static int v4l_dbg_g_chip_info(const struct v4l2_ioctl_ops *ops,
2616 struct file *file, void *fh, void *arg)
2618 #ifdef CONFIG_VIDEO_ADV_DEBUG
2619 struct video_device *vfd = video_devdata(file);
2620 struct v4l2_dbg_chip_info *p = arg;
2621 struct v4l2_subdev *sd;
2624 switch (p->match.type) {
2625 case V4L2_CHIP_MATCH_BRIDGE:
2626 if (ops->vidioc_s_register)
2627 p->flags |= V4L2_CHIP_FL_WRITABLE;
2628 if (ops->vidioc_g_register)
2629 p->flags |= V4L2_CHIP_FL_READABLE;
2630 strscpy(p->name, vfd->v4l2_dev->name, sizeof(p->name));
2631 if (ops->vidioc_g_chip_info)
2632 return ops->vidioc_g_chip_info(file, fh, arg);
2637 case V4L2_CHIP_MATCH_SUBDEV:
2638 if (vfd->v4l2_dev == NULL)
2640 v4l2_device_for_each_subdev(sd, vfd->v4l2_dev) {
2641 if (p->match.addr != idx++)
2643 if (sd->ops->core && sd->ops->core->s_register)
2644 p->flags |= V4L2_CHIP_FL_WRITABLE;
2645 if (sd->ops->core && sd->ops->core->g_register)
2646 p->flags |= V4L2_CHIP_FL_READABLE;
2647 strscpy(p->name, sd->name, sizeof(p->name));
2658 static int v4l_dqevent(const struct v4l2_ioctl_ops *ops,
2659 struct file *file, void *fh, void *arg)
2661 return v4l2_event_dequeue(fh, arg, file->f_flags & O_NONBLOCK);
2664 static int v4l_subscribe_event(const struct v4l2_ioctl_ops *ops,
2665 struct file *file, void *fh, void *arg)
2667 return ops->vidioc_subscribe_event(fh, arg);
2670 static int v4l_unsubscribe_event(const struct v4l2_ioctl_ops *ops,
2671 struct file *file, void *fh, void *arg)
2673 return ops->vidioc_unsubscribe_event(fh, arg);
2676 static int v4l_g_sliced_vbi_cap(const struct v4l2_ioctl_ops *ops,
2677 struct file *file, void *fh, void *arg)
2679 struct v4l2_sliced_vbi_cap *p = arg;
2680 int ret = check_fmt(file, p->type);
2685 /* Clear up to type, everything after type is zeroed already */
2686 memset(p, 0, offsetof(struct v4l2_sliced_vbi_cap, type));
2688 return ops->vidioc_g_sliced_vbi_cap(file, fh, p);
2691 static int v4l_enum_freq_bands(const struct v4l2_ioctl_ops *ops,
2692 struct file *file, void *fh, void *arg)
2694 struct video_device *vfd = video_devdata(file);
2695 struct v4l2_frequency_band *p = arg;
2696 enum v4l2_tuner_type type;
2699 if (vfd->vfl_type == VFL_TYPE_SDR) {
2700 if (p->type != V4L2_TUNER_SDR && p->type != V4L2_TUNER_RF)
2704 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
2705 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
2706 if (type != p->type)
2709 if (ops->vidioc_enum_freq_bands) {
2710 err = ops->vidioc_enum_freq_bands(file, fh, p);
2714 if (is_valid_ioctl(vfd, VIDIOC_G_TUNER)) {
2715 struct v4l2_tuner t = {
2722 err = ops->vidioc_g_tuner(file, fh, &t);
2725 p->capability = t.capability | V4L2_TUNER_CAP_FREQ_BANDS;
2726 p->rangelow = t.rangelow;
2727 p->rangehigh = t.rangehigh;
2728 p->modulation = (type == V4L2_TUNER_RADIO) ?
2729 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
2732 if (is_valid_ioctl(vfd, VIDIOC_G_MODULATOR)) {
2733 struct v4l2_modulator m = {
2737 if (type != V4L2_TUNER_RADIO)
2741 err = ops->vidioc_g_modulator(file, fh, &m);
2744 p->capability = m.capability | V4L2_TUNER_CAP_FREQ_BANDS;
2745 p->rangelow = m.rangelow;
2746 p->rangehigh = m.rangehigh;
2747 p->modulation = (type == V4L2_TUNER_RADIO) ?
2748 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
2754 struct v4l2_ioctl_info {
2757 const char * const name;
2758 int (*func)(const struct v4l2_ioctl_ops *ops, struct file *file,
2760 void (*debug)(const void *arg, bool write_only);
2763 /* This control needs a priority check */
2764 #define INFO_FL_PRIO (1 << 0)
2765 /* This control can be valid if the filehandle passes a control handler. */
2766 #define INFO_FL_CTRL (1 << 1)
2768 #define INFO_FL_QUEUE (1 << 2)
2769 /* Always copy back result, even on error */
2770 #define INFO_FL_ALWAYS_COPY (1 << 3)
2771 /* Zero struct from after the field to the end */
2772 #define INFO_FL_CLEAR(v4l2_struct, field) \
2773 ((offsetof(struct v4l2_struct, field) + \
2774 sizeof_field(struct v4l2_struct, field)) << 16)
2775 #define INFO_FL_CLEAR_MASK (_IOC_SIZEMASK << 16)
2777 #define DEFINE_V4L_STUB_FUNC(_vidioc) \
2778 static int v4l_stub_ ## _vidioc( \
2779 const struct v4l2_ioctl_ops *ops, \
2780 struct file *file, void *fh, void *p) \
2782 return ops->vidioc_ ## _vidioc(file, fh, p); \
2785 #define IOCTL_INFO(_ioctl, _func, _debug, _flags) \
2786 [_IOC_NR(_ioctl)] = { \
2794 DEFINE_V4L_STUB_FUNC(g_fbuf)
2795 DEFINE_V4L_STUB_FUNC(s_fbuf)
2796 DEFINE_V4L_STUB_FUNC(expbuf)
2797 DEFINE_V4L_STUB_FUNC(g_std)
2798 DEFINE_V4L_STUB_FUNC(g_audio)
2799 DEFINE_V4L_STUB_FUNC(s_audio)
2800 DEFINE_V4L_STUB_FUNC(g_edid)
2801 DEFINE_V4L_STUB_FUNC(s_edid)
2802 DEFINE_V4L_STUB_FUNC(g_audout)
2803 DEFINE_V4L_STUB_FUNC(s_audout)
2804 DEFINE_V4L_STUB_FUNC(g_jpegcomp)
2805 DEFINE_V4L_STUB_FUNC(s_jpegcomp)
2806 DEFINE_V4L_STUB_FUNC(enumaudio)
2807 DEFINE_V4L_STUB_FUNC(enumaudout)
2808 DEFINE_V4L_STUB_FUNC(enum_framesizes)
2809 DEFINE_V4L_STUB_FUNC(enum_frameintervals)
2810 DEFINE_V4L_STUB_FUNC(g_enc_index)
2811 DEFINE_V4L_STUB_FUNC(encoder_cmd)
2812 DEFINE_V4L_STUB_FUNC(try_encoder_cmd)
2813 DEFINE_V4L_STUB_FUNC(decoder_cmd)
2814 DEFINE_V4L_STUB_FUNC(try_decoder_cmd)
2815 DEFINE_V4L_STUB_FUNC(s_dv_timings)
2816 DEFINE_V4L_STUB_FUNC(g_dv_timings)
2817 DEFINE_V4L_STUB_FUNC(enum_dv_timings)
2818 DEFINE_V4L_STUB_FUNC(query_dv_timings)
2819 DEFINE_V4L_STUB_FUNC(dv_timings_cap)
2821 static const struct v4l2_ioctl_info v4l2_ioctls[] = {
2822 IOCTL_INFO(VIDIOC_QUERYCAP, v4l_querycap, v4l_print_querycap, 0),
2823 IOCTL_INFO(VIDIOC_ENUM_FMT, v4l_enum_fmt, v4l_print_fmtdesc, 0),
2824 IOCTL_INFO(VIDIOC_G_FMT, v4l_g_fmt, v4l_print_format, 0),
2825 IOCTL_INFO(VIDIOC_S_FMT, v4l_s_fmt, v4l_print_format, INFO_FL_PRIO),
2826 IOCTL_INFO(VIDIOC_REQBUFS, v4l_reqbufs, v4l_print_requestbuffers, INFO_FL_PRIO | INFO_FL_QUEUE),
2827 IOCTL_INFO(VIDIOC_QUERYBUF, v4l_querybuf, v4l_print_buffer, INFO_FL_QUEUE | INFO_FL_CLEAR(v4l2_buffer, length)),
2828 IOCTL_INFO(VIDIOC_G_FBUF, v4l_stub_g_fbuf, v4l_print_framebuffer, 0),
2829 IOCTL_INFO(VIDIOC_S_FBUF, v4l_stub_s_fbuf, v4l_print_framebuffer, INFO_FL_PRIO),
2830 IOCTL_INFO(VIDIOC_OVERLAY, v4l_overlay, v4l_print_u32, INFO_FL_PRIO),
2831 IOCTL_INFO(VIDIOC_QBUF, v4l_qbuf, v4l_print_buffer, INFO_FL_QUEUE),
2832 IOCTL_INFO(VIDIOC_EXPBUF, v4l_stub_expbuf, v4l_print_exportbuffer, INFO_FL_QUEUE | INFO_FL_CLEAR(v4l2_exportbuffer, flags)),
2833 IOCTL_INFO(VIDIOC_DQBUF, v4l_dqbuf, v4l_print_buffer, INFO_FL_QUEUE),
2834 IOCTL_INFO(VIDIOC_STREAMON, v4l_streamon, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
2835 IOCTL_INFO(VIDIOC_STREAMOFF, v4l_streamoff, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
2836 IOCTL_INFO(VIDIOC_G_PARM, v4l_g_parm, v4l_print_streamparm, INFO_FL_CLEAR(v4l2_streamparm, type)),
2837 IOCTL_INFO(VIDIOC_S_PARM, v4l_s_parm, v4l_print_streamparm, INFO_FL_PRIO),
2838 IOCTL_INFO(VIDIOC_G_STD, v4l_stub_g_std, v4l_print_std, 0),
2839 IOCTL_INFO(VIDIOC_S_STD, v4l_s_std, v4l_print_std, INFO_FL_PRIO),
2840 IOCTL_INFO(VIDIOC_ENUMSTD, v4l_enumstd, v4l_print_standard, INFO_FL_CLEAR(v4l2_standard, index)),
2841 IOCTL_INFO(VIDIOC_ENUMINPUT, v4l_enuminput, v4l_print_enuminput, INFO_FL_CLEAR(v4l2_input, index)),
2842 IOCTL_INFO(VIDIOC_G_CTRL, v4l_g_ctrl, v4l_print_control, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_control, id)),
2843 IOCTL_INFO(VIDIOC_S_CTRL, v4l_s_ctrl, v4l_print_control, INFO_FL_PRIO | INFO_FL_CTRL),
2844 IOCTL_INFO(VIDIOC_G_TUNER, v4l_g_tuner, v4l_print_tuner, INFO_FL_CLEAR(v4l2_tuner, index)),
2845 IOCTL_INFO(VIDIOC_S_TUNER, v4l_s_tuner, v4l_print_tuner, INFO_FL_PRIO),
2846 IOCTL_INFO(VIDIOC_G_AUDIO, v4l_stub_g_audio, v4l_print_audio, 0),
2847 IOCTL_INFO(VIDIOC_S_AUDIO, v4l_stub_s_audio, v4l_print_audio, INFO_FL_PRIO),
2848 IOCTL_INFO(VIDIOC_QUERYCTRL, v4l_queryctrl, v4l_print_queryctrl, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_queryctrl, id)),
2849 IOCTL_INFO(VIDIOC_QUERYMENU, v4l_querymenu, v4l_print_querymenu, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_querymenu, index)),
2850 IOCTL_INFO(VIDIOC_G_INPUT, v4l_g_input, v4l_print_u32, 0),
2851 IOCTL_INFO(VIDIOC_S_INPUT, v4l_s_input, v4l_print_u32, INFO_FL_PRIO),
2852 IOCTL_INFO(VIDIOC_G_EDID, v4l_stub_g_edid, v4l_print_edid, INFO_FL_ALWAYS_COPY),
2853 IOCTL_INFO(VIDIOC_S_EDID, v4l_stub_s_edid, v4l_print_edid, INFO_FL_PRIO | INFO_FL_ALWAYS_COPY),
2854 IOCTL_INFO(VIDIOC_G_OUTPUT, v4l_g_output, v4l_print_u32, 0),
2855 IOCTL_INFO(VIDIOC_S_OUTPUT, v4l_s_output, v4l_print_u32, INFO_FL_PRIO),
2856 IOCTL_INFO(VIDIOC_ENUMOUTPUT, v4l_enumoutput, v4l_print_enumoutput, INFO_FL_CLEAR(v4l2_output, index)),
2857 IOCTL_INFO(VIDIOC_G_AUDOUT, v4l_stub_g_audout, v4l_print_audioout, 0),
2858 IOCTL_INFO(VIDIOC_S_AUDOUT, v4l_stub_s_audout, v4l_print_audioout, INFO_FL_PRIO),
2859 IOCTL_INFO(VIDIOC_G_MODULATOR, v4l_g_modulator, v4l_print_modulator, INFO_FL_CLEAR(v4l2_modulator, index)),
2860 IOCTL_INFO(VIDIOC_S_MODULATOR, v4l_s_modulator, v4l_print_modulator, INFO_FL_PRIO),
2861 IOCTL_INFO(VIDIOC_G_FREQUENCY, v4l_g_frequency, v4l_print_frequency, INFO_FL_CLEAR(v4l2_frequency, tuner)),
2862 IOCTL_INFO(VIDIOC_S_FREQUENCY, v4l_s_frequency, v4l_print_frequency, INFO_FL_PRIO),
2863 IOCTL_INFO(VIDIOC_CROPCAP, v4l_cropcap, v4l_print_cropcap, INFO_FL_CLEAR(v4l2_cropcap, type)),
2864 IOCTL_INFO(VIDIOC_G_CROP, v4l_g_crop, v4l_print_crop, INFO_FL_CLEAR(v4l2_crop, type)),
2865 IOCTL_INFO(VIDIOC_S_CROP, v4l_s_crop, v4l_print_crop, INFO_FL_PRIO),
2866 IOCTL_INFO(VIDIOC_G_SELECTION, v4l_g_selection, v4l_print_selection, INFO_FL_CLEAR(v4l2_selection, r)),
2867 IOCTL_INFO(VIDIOC_S_SELECTION, v4l_s_selection, v4l_print_selection, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_selection, r)),
2868 IOCTL_INFO(VIDIOC_G_JPEGCOMP, v4l_stub_g_jpegcomp, v4l_print_jpegcompression, 0),
2869 IOCTL_INFO(VIDIOC_S_JPEGCOMP, v4l_stub_s_jpegcomp, v4l_print_jpegcompression, INFO_FL_PRIO),
2870 IOCTL_INFO(VIDIOC_QUERYSTD, v4l_querystd, v4l_print_std, 0),
2871 IOCTL_INFO(VIDIOC_TRY_FMT, v4l_try_fmt, v4l_print_format, 0),
2872 IOCTL_INFO(VIDIOC_ENUMAUDIO, v4l_stub_enumaudio, v4l_print_audio, INFO_FL_CLEAR(v4l2_audio, index)),
2873 IOCTL_INFO(VIDIOC_ENUMAUDOUT, v4l_stub_enumaudout, v4l_print_audioout, INFO_FL_CLEAR(v4l2_audioout, index)),
2874 IOCTL_INFO(VIDIOC_G_PRIORITY, v4l_g_priority, v4l_print_u32, 0),
2875 IOCTL_INFO(VIDIOC_S_PRIORITY, v4l_s_priority, v4l_print_u32, INFO_FL_PRIO),
2876 IOCTL_INFO(VIDIOC_G_SLICED_VBI_CAP, v4l_g_sliced_vbi_cap, v4l_print_sliced_vbi_cap, INFO_FL_CLEAR(v4l2_sliced_vbi_cap, type)),
2877 IOCTL_INFO(VIDIOC_LOG_STATUS, v4l_log_status, v4l_print_newline, 0),
2878 IOCTL_INFO(VIDIOC_G_EXT_CTRLS, v4l_g_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL | INFO_FL_ALWAYS_COPY),
2879 IOCTL_INFO(VIDIOC_S_EXT_CTRLS, v4l_s_ext_ctrls, v4l_print_ext_controls, INFO_FL_PRIO | INFO_FL_CTRL | INFO_FL_ALWAYS_COPY),
2880 IOCTL_INFO(VIDIOC_TRY_EXT_CTRLS, v4l_try_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL | INFO_FL_ALWAYS_COPY),
2881 IOCTL_INFO(VIDIOC_ENUM_FRAMESIZES, v4l_stub_enum_framesizes, v4l_print_frmsizeenum, INFO_FL_CLEAR(v4l2_frmsizeenum, pixel_format)),
2882 IOCTL_INFO(VIDIOC_ENUM_FRAMEINTERVALS, v4l_stub_enum_frameintervals, v4l_print_frmivalenum, INFO_FL_CLEAR(v4l2_frmivalenum, height)),
2883 IOCTL_INFO(VIDIOC_G_ENC_INDEX, v4l_stub_g_enc_index, v4l_print_enc_idx, 0),
2884 IOCTL_INFO(VIDIOC_ENCODER_CMD, v4l_stub_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
2885 IOCTL_INFO(VIDIOC_TRY_ENCODER_CMD, v4l_stub_try_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
2886 IOCTL_INFO(VIDIOC_DECODER_CMD, v4l_stub_decoder_cmd, v4l_print_decoder_cmd, INFO_FL_PRIO),
2887 IOCTL_INFO(VIDIOC_TRY_DECODER_CMD, v4l_stub_try_decoder_cmd, v4l_print_decoder_cmd, 0),
2888 IOCTL_INFO(VIDIOC_DBG_S_REGISTER, v4l_dbg_s_register, v4l_print_dbg_register, 0),
2889 IOCTL_INFO(VIDIOC_DBG_G_REGISTER, v4l_dbg_g_register, v4l_print_dbg_register, 0),
2890 IOCTL_INFO(VIDIOC_S_HW_FREQ_SEEK, v4l_s_hw_freq_seek, v4l_print_hw_freq_seek, INFO_FL_PRIO),
2891 IOCTL_INFO(VIDIOC_S_DV_TIMINGS, v4l_stub_s_dv_timings, v4l_print_dv_timings, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_dv_timings, bt.flags)),
2892 IOCTL_INFO(VIDIOC_G_DV_TIMINGS, v4l_stub_g_dv_timings, v4l_print_dv_timings, 0),
2893 IOCTL_INFO(VIDIOC_DQEVENT, v4l_dqevent, v4l_print_event, 0),
2894 IOCTL_INFO(VIDIOC_SUBSCRIBE_EVENT, v4l_subscribe_event, v4l_print_event_subscription, 0),
2895 IOCTL_INFO(VIDIOC_UNSUBSCRIBE_EVENT, v4l_unsubscribe_event, v4l_print_event_subscription, 0),
2896 IOCTL_INFO(VIDIOC_CREATE_BUFS, v4l_create_bufs, v4l_print_create_buffers, INFO_FL_PRIO | INFO_FL_QUEUE),
2897 IOCTL_INFO(VIDIOC_PREPARE_BUF, v4l_prepare_buf, v4l_print_buffer, INFO_FL_QUEUE),
2898 IOCTL_INFO(VIDIOC_ENUM_DV_TIMINGS, v4l_stub_enum_dv_timings, v4l_print_enum_dv_timings, INFO_FL_CLEAR(v4l2_enum_dv_timings, pad)),
2899 IOCTL_INFO(VIDIOC_QUERY_DV_TIMINGS, v4l_stub_query_dv_timings, v4l_print_dv_timings, INFO_FL_ALWAYS_COPY),
2900 IOCTL_INFO(VIDIOC_DV_TIMINGS_CAP, v4l_stub_dv_timings_cap, v4l_print_dv_timings_cap, INFO_FL_CLEAR(v4l2_dv_timings_cap, pad)),
2901 IOCTL_INFO(VIDIOC_ENUM_FREQ_BANDS, v4l_enum_freq_bands, v4l_print_freq_band, 0),
2902 IOCTL_INFO(VIDIOC_DBG_G_CHIP_INFO, v4l_dbg_g_chip_info, v4l_print_dbg_chip_info, INFO_FL_CLEAR(v4l2_dbg_chip_info, match)),
2903 IOCTL_INFO(VIDIOC_QUERY_EXT_CTRL, v4l_query_ext_ctrl, v4l_print_query_ext_ctrl, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_query_ext_ctrl, id)),
2905 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
2907 static bool v4l2_is_known_ioctl(unsigned int cmd)
2909 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2911 return v4l2_ioctls[_IOC_NR(cmd)].ioctl == cmd;
2914 static struct mutex *v4l2_ioctl_get_lock(struct video_device *vdev,
2915 struct v4l2_fh *vfh, unsigned int cmd,
2918 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2920 if (vfh && vfh->m2m_ctx &&
2921 (v4l2_ioctls[_IOC_NR(cmd)].flags & INFO_FL_QUEUE)) {
2922 if (vfh->m2m_ctx->q_lock)
2923 return vfh->m2m_ctx->q_lock;
2925 if (vdev->queue && vdev->queue->lock &&
2926 (v4l2_ioctls[_IOC_NR(cmd)].flags & INFO_FL_QUEUE))
2927 return vdev->queue->lock;
2931 /* Common ioctl debug function. This function can be used by
2932 external ioctl messages as well as internal V4L ioctl */
2933 void v4l_printk_ioctl(const char *prefix, unsigned int cmd)
2935 const char *dir, *type;
2938 printk(KERN_DEBUG "%s: ", prefix);
2940 switch (_IOC_TYPE(cmd)) {
2945 if (_IOC_NR(cmd) >= V4L2_IOCTLS) {
2949 pr_cont("%s", v4l2_ioctls[_IOC_NR(cmd)].name);
2956 switch (_IOC_DIR(cmd)) {
2957 case _IOC_NONE: dir = "--"; break;
2958 case _IOC_READ: dir = "r-"; break;
2959 case _IOC_WRITE: dir = "-w"; break;
2960 case _IOC_READ | _IOC_WRITE: dir = "rw"; break;
2961 default: dir = "*ERR*"; break;
2963 pr_cont("%s ioctl '%c', dir=%s, #%d (0x%08x)",
2964 type, _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
2966 EXPORT_SYMBOL(v4l_printk_ioctl);
2968 static long __video_do_ioctl(struct file *file,
2969 unsigned int cmd, void *arg)
2971 struct video_device *vfd = video_devdata(file);
2972 struct mutex *req_queue_lock = NULL;
2973 struct mutex *lock; /* ioctl serialization mutex */
2974 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
2975 bool write_only = false;
2976 struct v4l2_ioctl_info default_info;
2977 const struct v4l2_ioctl_info *info;
2978 void *fh = file->private_data;
2979 struct v4l2_fh *vfh = NULL;
2980 int dev_debug = vfd->dev_debug;
2984 pr_warn("%s: has no ioctl_ops.\n",
2985 video_device_node_name(vfd));
2989 if (test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags))
2990 vfh = file->private_data;
2993 * We need to serialize streamon/off with queueing new requests.
2994 * These ioctls may trigger the cancellation of a streaming
2995 * operation, and that should not be mixed with queueing a new
2996 * request at the same time.
2998 if (v4l2_device_supports_requests(vfd->v4l2_dev) &&
2999 (cmd == VIDIOC_STREAMON || cmd == VIDIOC_STREAMOFF)) {
3000 req_queue_lock = &vfd->v4l2_dev->mdev->req_queue_mutex;
3002 if (mutex_lock_interruptible(req_queue_lock))
3003 return -ERESTARTSYS;
3006 lock = v4l2_ioctl_get_lock(vfd, vfh, cmd, arg);
3008 if (lock && mutex_lock_interruptible(lock)) {
3010 mutex_unlock(req_queue_lock);
3011 return -ERESTARTSYS;
3014 if (!video_is_registered(vfd)) {
3019 if (v4l2_is_known_ioctl(cmd)) {
3020 info = &v4l2_ioctls[_IOC_NR(cmd)];
3022 if (!test_bit(_IOC_NR(cmd), vfd->valid_ioctls) &&
3023 !((info->flags & INFO_FL_CTRL) && vfh && vfh->ctrl_handler))
3026 if (vfh && (info->flags & INFO_FL_PRIO)) {
3027 ret = v4l2_prio_check(vfd->prio, vfh->prio);
3032 default_info.ioctl = cmd;
3033 default_info.flags = 0;
3034 default_info.debug = v4l_print_default;
3035 info = &default_info;
3038 write_only = _IOC_DIR(cmd) == _IOC_WRITE;
3039 if (info != &default_info) {
3040 ret = info->func(ops, file, fh, arg);
3041 } else if (!ops->vidioc_default) {
3044 ret = ops->vidioc_default(file, fh,
3045 vfh ? v4l2_prio_check(vfd->prio, vfh->prio) >= 0 : 0,
3050 if (dev_debug & (V4L2_DEV_DEBUG_IOCTL | V4L2_DEV_DEBUG_IOCTL_ARG)) {
3051 if (!(dev_debug & V4L2_DEV_DEBUG_STREAMING) &&
3052 (cmd == VIDIOC_QBUF || cmd == VIDIOC_DQBUF))
3055 v4l_printk_ioctl(video_device_node_name(vfd), cmd);
3057 pr_cont(": error %ld", ret);
3058 if (!(dev_debug & V4L2_DEV_DEBUG_IOCTL_ARG))
3060 else if (_IOC_DIR(cmd) == _IOC_NONE)
3061 info->debug(arg, write_only);
3064 info->debug(arg, write_only);
3072 mutex_unlock(req_queue_lock);
3076 static int check_array_args(unsigned int cmd, void *parg, size_t *array_size,
3077 void __user **user_ptr, void ***kernel_ptr)
3082 case VIDIOC_PREPARE_BUF:
3083 case VIDIOC_QUERYBUF:
3085 case VIDIOC_DQBUF: {
3086 struct v4l2_buffer *buf = parg;
3088 if (V4L2_TYPE_IS_MULTIPLANAR(buf->type) && buf->length > 0) {
3089 if (buf->length > VIDEO_MAX_PLANES) {
3093 *user_ptr = (void __user *)buf->m.planes;
3094 *kernel_ptr = (void **)&buf->m.planes;
3095 *array_size = sizeof(struct v4l2_plane) * buf->length;
3102 case VIDIOC_S_EDID: {
3103 struct v4l2_edid *edid = parg;
3106 if (edid->blocks > 256) {
3110 *user_ptr = (void __user *)edid->edid;
3111 *kernel_ptr = (void **)&edid->edid;
3112 *array_size = edid->blocks * 128;
3118 case VIDIOC_S_EXT_CTRLS:
3119 case VIDIOC_G_EXT_CTRLS:
3120 case VIDIOC_TRY_EXT_CTRLS: {
3121 struct v4l2_ext_controls *ctrls = parg;
3123 if (ctrls->count != 0) {
3124 if (ctrls->count > V4L2_CID_MAX_CTRLS) {
3128 *user_ptr = (void __user *)ctrls->controls;
3129 *kernel_ptr = (void **)&ctrls->controls;
3130 *array_size = sizeof(struct v4l2_ext_control)
3138 case VIDIOC_TRY_FMT: {
3139 struct v4l2_format *fmt = parg;
3141 if (fmt->type != V4L2_BUF_TYPE_VIDEO_OVERLAY &&
3142 fmt->type != V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY)
3144 if (fmt->fmt.win.clipcount > 2048)
3146 if (!fmt->fmt.win.clipcount)
3149 *user_ptr = (void __user *)fmt->fmt.win.clips;
3150 *kernel_ptr = (void **)&fmt->fmt.win.clips;
3151 *array_size = sizeof(struct v4l2_clip)
3152 * fmt->fmt.win.clipcount;
3162 static unsigned int video_translate_cmd(unsigned int cmd)
3164 #if !defined(CONFIG_64BIT) && defined(CONFIG_COMPAT_32BIT_TIME)
3166 case VIDIOC_DQEVENT_TIME32:
3167 return VIDIOC_DQEVENT;
3168 case VIDIOC_QUERYBUF_TIME32:
3169 return VIDIOC_QUERYBUF;
3170 case VIDIOC_QBUF_TIME32:
3172 case VIDIOC_DQBUF_TIME32:
3173 return VIDIOC_DQBUF;
3174 case VIDIOC_PREPARE_BUF_TIME32:
3175 return VIDIOC_PREPARE_BUF;
3178 if (in_compat_syscall())
3179 return v4l2_compat_translate_cmd(cmd);
3184 static int video_get_user(void __user *arg, void *parg,
3185 unsigned int real_cmd, unsigned int cmd,
3188 unsigned int n = _IOC_SIZE(real_cmd);
3191 if (!(_IOC_DIR(cmd) & _IOC_WRITE)) {
3192 /* read-only ioctl */
3198 * In some cases, only a few fields are used as input,
3199 * i.e. when the app sets "index" and then the driver
3200 * fills in the rest of the structure for the thing
3201 * with that index. We only need to copy up the first
3204 if (v4l2_is_known_ioctl(real_cmd)) {
3205 u32 flags = v4l2_ioctls[_IOC_NR(real_cmd)].flags;
3207 if (flags & INFO_FL_CLEAR_MASK)
3208 n = (flags & INFO_FL_CLEAR_MASK) >> 16;
3209 *always_copy = flags & INFO_FL_ALWAYS_COPY;
3212 if (cmd == real_cmd) {
3213 if (copy_from_user(parg, (void __user *)arg, n))
3215 } else if (in_compat_syscall()) {
3217 err = v4l2_compat_get_user(arg, parg, cmd);
3220 #if !defined(CONFIG_64BIT) && defined(CONFIG_COMPAT_32BIT_TIME)
3222 case VIDIOC_QUERYBUF_TIME32:
3223 case VIDIOC_QBUF_TIME32:
3224 case VIDIOC_DQBUF_TIME32:
3225 case VIDIOC_PREPARE_BUF_TIME32: {
3226 struct v4l2_buffer_time32 vb32;
3227 struct v4l2_buffer *vb = parg;
3229 if (copy_from_user(&vb32, arg, sizeof(vb32)))
3232 *vb = (struct v4l2_buffer) {
3233 .index = vb32.index,
3235 .bytesused = vb32.bytesused,
3236 .flags = vb32.flags,
3237 .field = vb32.field,
3238 .timestamp.tv_sec = vb32.timestamp.tv_sec,
3239 .timestamp.tv_usec = vb32.timestamp.tv_usec,
3240 .timecode = vb32.timecode,
3241 .sequence = vb32.sequence,
3242 .memory = vb32.memory,
3243 .m.userptr = vb32.m.userptr,
3244 .length = vb32.length,
3245 .request_fd = vb32.request_fd,
3253 /* zero out anything we don't copy from userspace */
3254 if (!err && n < _IOC_SIZE(real_cmd))
3255 memset((u8 *)parg + n, 0, _IOC_SIZE(real_cmd) - n);
3259 static int video_put_user(void __user *arg, void *parg,
3260 unsigned int real_cmd, unsigned int cmd)
3262 if (!(_IOC_DIR(cmd) & _IOC_READ))
3265 if (cmd == real_cmd) {
3266 /* Copy results into user buffer */
3267 if (copy_to_user(arg, parg, _IOC_SIZE(cmd)))
3272 if (in_compat_syscall())
3273 return v4l2_compat_put_user(arg, parg, cmd);
3275 #if !defined(CONFIG_64BIT) && defined(CONFIG_COMPAT_32BIT_TIME)
3277 case VIDIOC_DQEVENT_TIME32: {
3278 struct v4l2_event *ev = parg;
3279 struct v4l2_event_time32 ev32;
3281 memset(&ev32, 0, sizeof(ev32));
3283 ev32.type = ev->type;
3284 ev32.pending = ev->pending;
3285 ev32.sequence = ev->sequence;
3286 ev32.timestamp.tv_sec = ev->timestamp.tv_sec;
3287 ev32.timestamp.tv_nsec = ev->timestamp.tv_nsec;
3290 memcpy(&ev32.u, &ev->u, sizeof(ev->u));
3291 memcpy(&ev32.reserved, &ev->reserved, sizeof(ev->reserved));
3293 if (copy_to_user(arg, &ev32, sizeof(ev32)))
3297 case VIDIOC_QUERYBUF_TIME32:
3298 case VIDIOC_QBUF_TIME32:
3299 case VIDIOC_DQBUF_TIME32:
3300 case VIDIOC_PREPARE_BUF_TIME32: {
3301 struct v4l2_buffer *vb = parg;
3302 struct v4l2_buffer_time32 vb32;
3304 memset(&vb32, 0, sizeof(vb32));
3306 vb32.index = vb->index;
3307 vb32.type = vb->type;
3308 vb32.bytesused = vb->bytesused;
3309 vb32.flags = vb->flags;
3310 vb32.field = vb->field;
3311 vb32.timestamp.tv_sec = vb->timestamp.tv_sec;
3312 vb32.timestamp.tv_usec = vb->timestamp.tv_usec;
3313 vb32.timecode = vb->timecode;
3314 vb32.sequence = vb->sequence;
3315 vb32.memory = vb->memory;
3316 vb32.m.userptr = vb->m.userptr;
3317 vb32.length = vb->length;
3318 vb32.request_fd = vb->request_fd;
3320 if (copy_to_user(arg, &vb32, sizeof(vb32)))
3331 video_usercopy(struct file *file, unsigned int orig_cmd, unsigned long arg,
3335 void *mbuf = NULL, *array_buf = NULL;
3336 void *parg = (void *)arg;
3338 bool has_array_args;
3339 bool always_copy = false;
3340 size_t array_size = 0;
3341 void __user *user_ptr = NULL;
3342 void **kernel_ptr = NULL;
3343 unsigned int cmd = video_translate_cmd(orig_cmd);
3344 const size_t ioc_size = _IOC_SIZE(cmd);
3346 /* Copy arguments into temp kernel buffer */
3347 if (_IOC_DIR(cmd) != _IOC_NONE) {
3348 if (ioc_size <= sizeof(sbuf)) {
3351 /* too big to allocate from stack */
3352 mbuf = kmalloc(ioc_size, GFP_KERNEL);
3358 err = video_get_user((void __user *)arg, parg, cmd,
3359 orig_cmd, &always_copy);
3364 err = check_array_args(cmd, parg, &array_size, &user_ptr, &kernel_ptr);
3367 has_array_args = err;
3369 if (has_array_args) {
3370 array_buf = kvmalloc(array_size, GFP_KERNEL);
3372 if (array_buf == NULL)
3374 if (in_compat_syscall())
3375 err = v4l2_compat_get_array_args(file, array_buf,
3376 user_ptr, array_size,
3379 err = copy_from_user(array_buf, user_ptr, array_size) ?
3383 *kernel_ptr = array_buf;
3387 err = func(file, cmd, parg);
3388 if (err == -ENOTTY || err == -ENOIOCTLCMD) {
3394 if (cmd == VIDIOC_DQBUF)
3395 trace_v4l2_dqbuf(video_devdata(file)->minor, parg);
3396 else if (cmd == VIDIOC_QBUF)
3397 trace_v4l2_qbuf(video_devdata(file)->minor, parg);
3401 * Some ioctls can return an error, but still have valid
3402 * results that must be returned.
3404 if (err < 0 && !always_copy)
3407 if (has_array_args) {
3408 *kernel_ptr = (void __force *)user_ptr;
3409 if (in_compat_syscall()) {
3412 put_err = v4l2_compat_put_array_args(file, user_ptr,
3418 } else if (copy_to_user(user_ptr, array_buf, array_size)) {
3423 if (video_put_user((void __user *)arg, parg, cmd, orig_cmd))
3431 long video_ioctl2(struct file *file,
3432 unsigned int cmd, unsigned long arg)
3434 return video_usercopy(file, cmd, arg, __video_do_ioctl);
3436 EXPORT_SYMBOL(video_ioctl2);