2 * Video capture interface for Linux version 2
4 * A generic framework to process V4L2 ioctl commands.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
11 * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1)
12 * Mauro Carvalho Chehab <mchehab@infradead.org> (version 2)
15 #include <linux/module.h>
16 #include <linux/slab.h>
17 #include <linux/types.h>
18 #include <linux/kernel.h>
19 #include <linux/version.h>
21 #include <linux/videodev2.h>
23 #include <media/v4l2-common.h>
24 #include <media/v4l2-ioctl.h>
25 #include <media/v4l2-ctrls.h>
26 #include <media/v4l2-fh.h>
27 #include <media/v4l2-event.h>
28 #include <media/v4l2-device.h>
29 #include <media/v4l2-chip-ident.h>
30 #include <media/videobuf2-core.h>
32 /* Zero out the end of the struct pointed to by p. Everything after, but
33 * not including, the specified field is cleared. */
34 #define CLEAR_AFTER_FIELD(p, field) \
35 memset((u8 *)(p) + offsetof(typeof(*(p)), field) + sizeof((p)->field), \
36 0, sizeof(*(p)) - offsetof(typeof(*(p)), field) - sizeof((p)->field))
43 static const struct std_descr standards[] = {
44 { V4L2_STD_NTSC, "NTSC" },
45 { V4L2_STD_NTSC_M, "NTSC-M" },
46 { V4L2_STD_NTSC_M_JP, "NTSC-M-JP" },
47 { V4L2_STD_NTSC_M_KR, "NTSC-M-KR" },
48 { V4L2_STD_NTSC_443, "NTSC-443" },
49 { V4L2_STD_PAL, "PAL" },
50 { V4L2_STD_PAL_BG, "PAL-BG" },
51 { V4L2_STD_PAL_B, "PAL-B" },
52 { V4L2_STD_PAL_B1, "PAL-B1" },
53 { V4L2_STD_PAL_G, "PAL-G" },
54 { V4L2_STD_PAL_H, "PAL-H" },
55 { V4L2_STD_PAL_I, "PAL-I" },
56 { V4L2_STD_PAL_DK, "PAL-DK" },
57 { V4L2_STD_PAL_D, "PAL-D" },
58 { V4L2_STD_PAL_D1, "PAL-D1" },
59 { V4L2_STD_PAL_K, "PAL-K" },
60 { V4L2_STD_PAL_M, "PAL-M" },
61 { V4L2_STD_PAL_N, "PAL-N" },
62 { V4L2_STD_PAL_Nc, "PAL-Nc" },
63 { V4L2_STD_PAL_60, "PAL-60" },
64 { V4L2_STD_SECAM, "SECAM" },
65 { V4L2_STD_SECAM_B, "SECAM-B" },
66 { V4L2_STD_SECAM_G, "SECAM-G" },
67 { V4L2_STD_SECAM_H, "SECAM-H" },
68 { V4L2_STD_SECAM_DK, "SECAM-DK" },
69 { V4L2_STD_SECAM_D, "SECAM-D" },
70 { V4L2_STD_SECAM_K, "SECAM-K" },
71 { V4L2_STD_SECAM_K1, "SECAM-K1" },
72 { V4L2_STD_SECAM_L, "SECAM-L" },
73 { V4L2_STD_SECAM_LC, "SECAM-Lc" },
77 /* video4linux standard ID conversion to standard name
79 const char *v4l2_norm_to_name(v4l2_std_id id)
84 /* HACK: ppc32 architecture doesn't have __ucmpdi2 function to handle
85 64 bit comparations. So, on that architecture, with some gcc
86 variants, compilation fails. Currently, the max value is 30bit wide.
90 for (i = 0; standards[i].std; i++)
91 if (myid == standards[i].std)
93 return standards[i].descr;
95 EXPORT_SYMBOL(v4l2_norm_to_name);
97 /* Returns frame period for the given standard */
98 void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod)
100 if (id & V4L2_STD_525_60) {
101 frameperiod->numerator = 1001;
102 frameperiod->denominator = 30000;
104 frameperiod->numerator = 1;
105 frameperiod->denominator = 25;
108 EXPORT_SYMBOL(v4l2_video_std_frame_period);
110 /* Fill in the fields of a v4l2_standard structure according to the
111 'id' and 'transmission' parameters. Returns negative on error. */
112 int v4l2_video_std_construct(struct v4l2_standard *vs,
113 int id, const char *name)
116 v4l2_video_std_frame_period(id, &vs->frameperiod);
117 vs->framelines = (id & V4L2_STD_525_60) ? 525 : 625;
118 strlcpy(vs->name, name, sizeof(vs->name));
121 EXPORT_SYMBOL(v4l2_video_std_construct);
123 /* ----------------------------------------------------------------- */
124 /* some arrays for pretty-printing debug messages of enum types */
126 const char *v4l2_field_names[] = {
127 [V4L2_FIELD_ANY] = "any",
128 [V4L2_FIELD_NONE] = "none",
129 [V4L2_FIELD_TOP] = "top",
130 [V4L2_FIELD_BOTTOM] = "bottom",
131 [V4L2_FIELD_INTERLACED] = "interlaced",
132 [V4L2_FIELD_SEQ_TB] = "seq-tb",
133 [V4L2_FIELD_SEQ_BT] = "seq-bt",
134 [V4L2_FIELD_ALTERNATE] = "alternate",
135 [V4L2_FIELD_INTERLACED_TB] = "interlaced-tb",
136 [V4L2_FIELD_INTERLACED_BT] = "interlaced-bt",
138 EXPORT_SYMBOL(v4l2_field_names);
140 const char *v4l2_type_names[] = {
141 [V4L2_BUF_TYPE_VIDEO_CAPTURE] = "vid-cap",
142 [V4L2_BUF_TYPE_VIDEO_OVERLAY] = "vid-overlay",
143 [V4L2_BUF_TYPE_VIDEO_OUTPUT] = "vid-out",
144 [V4L2_BUF_TYPE_VBI_CAPTURE] = "vbi-cap",
145 [V4L2_BUF_TYPE_VBI_OUTPUT] = "vbi-out",
146 [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
147 [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT] = "sliced-vbi-out",
148 [V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY] = "vid-out-overlay",
149 [V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE] = "vid-cap-mplane",
150 [V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE] = "vid-out-mplane",
152 EXPORT_SYMBOL(v4l2_type_names);
154 static const char *v4l2_memory_names[] = {
155 [V4L2_MEMORY_MMAP] = "mmap",
156 [V4L2_MEMORY_USERPTR] = "userptr",
157 [V4L2_MEMORY_OVERLAY] = "overlay",
160 #define prt_names(a, arr) ((((a) >= 0) && ((a) < ARRAY_SIZE(arr))) ? \
163 /* ------------------------------------------------------------------ */
164 /* debug help functions */
166 static void v4l_print_querycap(const void *arg, bool write_only)
168 const struct v4l2_capability *p = arg;
170 pr_cont("driver=%s, card=%s, bus=%s, version=0x%08x, "
171 "capabilities=0x%08x, device_caps=0x%08x\n",
172 p->driver, p->card, p->bus_info,
173 p->version, p->capabilities, p->device_caps);
176 static void v4l_print_enuminput(const void *arg, bool write_only)
178 const struct v4l2_input *p = arg;
180 pr_cont("index=%u, name=%s, type=%u, audioset=0x%x, tuner=%u, "
181 "std=0x%08Lx, status=0x%x, capabilities=0x%x\n",
182 p->index, p->name, p->type, p->audioset, p->tuner,
183 (unsigned long long)p->std, p->status, p->capabilities);
186 static void v4l_print_enumoutput(const void *arg, bool write_only)
188 const struct v4l2_output *p = arg;
190 pr_cont("index=%u, name=%s, type=%u, audioset=0x%x, "
191 "modulator=%u, std=0x%08Lx, capabilities=0x%x\n",
192 p->index, p->name, p->type, p->audioset, p->modulator,
193 (unsigned long long)p->std, p->capabilities);
196 static void v4l_print_audio(const void *arg, bool write_only)
198 const struct v4l2_audio *p = arg;
201 pr_cont("index=%u, mode=0x%x\n", p->index, p->mode);
203 pr_cont("index=%u, name=%s, capability=0x%x, mode=0x%x\n",
204 p->index, p->name, p->capability, p->mode);
207 static void v4l_print_audioout(const void *arg, bool write_only)
209 const struct v4l2_audioout *p = arg;
212 pr_cont("index=%u\n", p->index);
214 pr_cont("index=%u, name=%s, capability=0x%x, mode=0x%x\n",
215 p->index, p->name, p->capability, p->mode);
218 static void v4l_print_fmtdesc(const void *arg, bool write_only)
220 const struct v4l2_fmtdesc *p = arg;
222 pr_cont("index=%u, type=%s, flags=0x%x, pixelformat=%c%c%c%c, description='%s'\n",
223 p->index, prt_names(p->type, v4l2_type_names),
224 p->flags, (p->pixelformat & 0xff),
225 (p->pixelformat >> 8) & 0xff,
226 (p->pixelformat >> 16) & 0xff,
227 (p->pixelformat >> 24) & 0xff,
231 static void v4l_print_format(const void *arg, bool write_only)
233 const struct v4l2_format *p = arg;
234 const struct v4l2_pix_format *pix;
235 const struct v4l2_pix_format_mplane *mp;
236 const struct v4l2_vbi_format *vbi;
237 const struct v4l2_sliced_vbi_format *sliced;
238 const struct v4l2_window *win;
239 const struct v4l2_clip *clip;
242 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
244 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
245 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
247 pr_cont(", width=%u, height=%u, "
248 "pixelformat=%c%c%c%c, field=%s, "
249 "bytesperline=%u sizeimage=%u, colorspace=%d\n",
250 pix->width, pix->height,
251 (pix->pixelformat & 0xff),
252 (pix->pixelformat >> 8) & 0xff,
253 (pix->pixelformat >> 16) & 0xff,
254 (pix->pixelformat >> 24) & 0xff,
255 prt_names(pix->field, v4l2_field_names),
256 pix->bytesperline, pix->sizeimage,
259 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
260 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
262 pr_cont(", width=%u, height=%u, "
263 "format=%c%c%c%c, field=%s, "
264 "colorspace=%d, num_planes=%u\n",
265 mp->width, mp->height,
266 (mp->pixelformat & 0xff),
267 (mp->pixelformat >> 8) & 0xff,
268 (mp->pixelformat >> 16) & 0xff,
269 (mp->pixelformat >> 24) & 0xff,
270 prt_names(mp->field, v4l2_field_names),
271 mp->colorspace, mp->num_planes);
272 for (i = 0; i < mp->num_planes; i++)
273 printk(KERN_DEBUG "plane %u: bytesperline=%u sizeimage=%u\n", i,
274 mp->plane_fmt[i].bytesperline,
275 mp->plane_fmt[i].sizeimage);
277 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
278 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
280 pr_cont(", wxh=%dx%d, x,y=%d,%d, field=%s, "
281 "chromakey=0x%08x, bitmap=%p, "
282 "global_alpha=0x%02x\n",
283 win->w.width, win->w.height,
284 win->w.left, win->w.top,
285 prt_names(win->field, v4l2_field_names),
286 win->chromakey, win->bitmap, win->global_alpha);
288 for (i = 0; i < win->clipcount; i++) {
289 printk(KERN_DEBUG "clip %u: wxh=%dx%d, x,y=%d,%d\n",
290 i, clip->c.width, clip->c.height,
291 clip->c.left, clip->c.top);
295 case V4L2_BUF_TYPE_VBI_CAPTURE:
296 case V4L2_BUF_TYPE_VBI_OUTPUT:
298 pr_cont(", sampling_rate=%u, offset=%u, samples_per_line=%u, "
299 "sample_format=%c%c%c%c, start=%u,%u, count=%u,%u\n",
300 vbi->sampling_rate, vbi->offset,
301 vbi->samples_per_line,
302 (vbi->sample_format & 0xff),
303 (vbi->sample_format >> 8) & 0xff,
304 (vbi->sample_format >> 16) & 0xff,
305 (vbi->sample_format >> 24) & 0xff,
306 vbi->start[0], vbi->start[1],
307 vbi->count[0], vbi->count[1]);
309 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
310 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
311 sliced = &p->fmt.sliced;
312 pr_cont(", service_set=0x%08x, io_size=%d\n",
313 sliced->service_set, sliced->io_size);
314 for (i = 0; i < 24; i++)
315 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
316 sliced->service_lines[0][i],
317 sliced->service_lines[1][i]);
319 case V4L2_BUF_TYPE_PRIVATE:
325 static void v4l_print_framebuffer(const void *arg, bool write_only)
327 const struct v4l2_framebuffer *p = arg;
329 pr_cont("capability=0x%x, flags=0x%x, base=0x%p, width=%u, "
330 "height=%u, pixelformat=%c%c%c%c, "
331 "bytesperline=%u sizeimage=%u, colorspace=%d\n",
332 p->capability, p->flags, p->base,
333 p->fmt.width, p->fmt.height,
334 (p->fmt.pixelformat & 0xff),
335 (p->fmt.pixelformat >> 8) & 0xff,
336 (p->fmt.pixelformat >> 16) & 0xff,
337 (p->fmt.pixelformat >> 24) & 0xff,
338 p->fmt.bytesperline, p->fmt.sizeimage,
342 static void v4l_print_buftype(const void *arg, bool write_only)
344 pr_cont("type=%s\n", prt_names(*(u32 *)arg, v4l2_type_names));
347 static void v4l_print_modulator(const void *arg, bool write_only)
349 const struct v4l2_modulator *p = arg;
352 pr_cont("index=%u, txsubchans=0x%x", p->index, p->txsubchans);
354 pr_cont("index=%u, name=%s, capability=0x%x, "
355 "rangelow=%u, rangehigh=%u, txsubchans=0x%x\n",
356 p->index, p->name, p->capability,
357 p->rangelow, p->rangehigh, p->txsubchans);
360 static void v4l_print_tuner(const void *arg, bool write_only)
362 const struct v4l2_tuner *p = arg;
365 pr_cont("index=%u, audmode=%u\n", p->index, p->audmode);
367 pr_cont("index=%u, name=%s, type=%u, capability=0x%x, "
368 "rangelow=%u, rangehigh=%u, signal=%u, afc=%d, "
369 "rxsubchans=0x%x, audmode=%u\n",
370 p->index, p->name, p->type,
371 p->capability, p->rangelow,
372 p->rangehigh, p->signal, p->afc,
373 p->rxsubchans, p->audmode);
376 static void v4l_print_frequency(const void *arg, bool write_only)
378 const struct v4l2_frequency *p = arg;
380 pr_cont("tuner=%u, type=%u, frequency=%u\n",
381 p->tuner, p->type, p->frequency);
384 static void v4l_print_standard(const void *arg, bool write_only)
386 const struct v4l2_standard *p = arg;
388 pr_cont("index=%u, id=0x%Lx, name=%s, fps=%u/%u, "
389 "framelines=%u\n", p->index,
390 (unsigned long long)p->id, p->name,
391 p->frameperiod.numerator,
392 p->frameperiod.denominator,
396 static void v4l_print_std(const void *arg, bool write_only)
398 pr_cont("std=0x%08Lx\n", *(const long long unsigned *)arg);
401 static void v4l_print_hw_freq_seek(const void *arg, bool write_only)
403 const struct v4l2_hw_freq_seek *p = arg;
405 pr_cont("tuner=%u, type=%u, seek_upward=%u, wrap_around=%u, spacing=%u\n",
406 p->tuner, p->type, p->seek_upward, p->wrap_around, p->spacing);
409 static void v4l_print_requestbuffers(const void *arg, bool write_only)
411 const struct v4l2_requestbuffers *p = arg;
413 pr_cont("count=%d, type=%s, memory=%s\n",
415 prt_names(p->type, v4l2_type_names),
416 prt_names(p->memory, v4l2_memory_names));
419 static void v4l_print_buffer(const void *arg, bool write_only)
421 const struct v4l2_buffer *p = arg;
422 const struct v4l2_timecode *tc = &p->timecode;
423 const struct v4l2_plane *plane;
426 pr_cont("%02ld:%02d:%02d.%08ld index=%d, type=%s, "
427 "flags=0x%08x, field=%s, sequence=%d, memory=%s",
428 p->timestamp.tv_sec / 3600,
429 (int)(p->timestamp.tv_sec / 60) % 60,
430 (int)(p->timestamp.tv_sec % 60),
431 (long)p->timestamp.tv_usec,
433 prt_names(p->type, v4l2_type_names),
434 p->flags, prt_names(p->field, v4l2_field_names),
435 p->sequence, prt_names(p->memory, v4l2_memory_names));
437 if (V4L2_TYPE_IS_MULTIPLANAR(p->type) && p->m.planes) {
439 for (i = 0; i < p->length; ++i) {
440 plane = &p->m.planes[i];
442 "plane %d: bytesused=%d, data_offset=0x%08x "
443 "offset/userptr=0x%lx, length=%d\n",
444 i, plane->bytesused, plane->data_offset,
445 plane->m.userptr, plane->length);
448 pr_cont("bytesused=%d, offset/userptr=0x%lx, length=%d\n",
449 p->bytesused, p->m.userptr, p->length);
452 printk(KERN_DEBUG "timecode=%02d:%02d:%02d type=%d, "
453 "flags=0x%08x, frames=%d, userbits=0x%08x\n",
454 tc->hours, tc->minutes, tc->seconds,
455 tc->type, tc->flags, tc->frames, *(__u32 *)tc->userbits);
458 static void v4l_print_create_buffers(const void *arg, bool write_only)
460 const struct v4l2_create_buffers *p = arg;
462 pr_cont("index=%d, count=%d, memory=%s, ",
464 prt_names(p->memory, v4l2_memory_names));
465 v4l_print_format(&p->format, write_only);
468 static void v4l_print_streamparm(const void *arg, bool write_only)
470 const struct v4l2_streamparm *p = arg;
472 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
474 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
475 p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE) {
476 const struct v4l2_captureparm *c = &p->parm.capture;
478 pr_cont(", capability=0x%x, capturemode=0x%x, timeperframe=%d/%d, "
479 "extendedmode=%d, readbuffers=%d\n",
480 c->capability, c->capturemode,
481 c->timeperframe.numerator, c->timeperframe.denominator,
482 c->extendedmode, c->readbuffers);
483 } else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT ||
484 p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
485 const struct v4l2_outputparm *c = &p->parm.output;
487 pr_cont(", capability=0x%x, outputmode=0x%x, timeperframe=%d/%d, "
488 "extendedmode=%d, writebuffers=%d\n",
489 c->capability, c->outputmode,
490 c->timeperframe.numerator, c->timeperframe.denominator,
491 c->extendedmode, c->writebuffers);
495 static void v4l_print_queryctrl(const void *arg, bool write_only)
497 const struct v4l2_queryctrl *p = arg;
499 pr_cont("id=0x%x, type=%d, name=%s, min/max=%d/%d, "
500 "step=%d, default=%d, flags=0x%08x\n",
501 p->id, p->type, p->name,
502 p->minimum, p->maximum,
503 p->step, p->default_value, p->flags);
506 static void v4l_print_querymenu(const void *arg, bool write_only)
508 const struct v4l2_querymenu *p = arg;
510 pr_cont("id=0x%x, index=%d\n", p->id, p->index);
513 static void v4l_print_control(const void *arg, bool write_only)
515 const struct v4l2_control *p = arg;
517 pr_cont("id=0x%x, value=%d\n", p->id, p->value);
520 static void v4l_print_ext_controls(const void *arg, bool write_only)
522 const struct v4l2_ext_controls *p = arg;
525 pr_cont("class=0x%x, count=%d, error_idx=%d",
526 p->ctrl_class, p->count, p->error_idx);
527 for (i = 0; i < p->count; i++) {
528 if (p->controls[i].size)
529 pr_cont(", id/val=0x%x/0x%x",
530 p->controls[i].id, p->controls[i].value);
532 pr_cont(", id/size=0x%x/%u",
533 p->controls[i].id, p->controls[i].size);
538 static void v4l_print_cropcap(const void *arg, bool write_only)
540 const struct v4l2_cropcap *p = arg;
542 pr_cont("type=%s, bounds wxh=%dx%d, x,y=%d,%d, "
543 "defrect wxh=%dx%d, x,y=%d,%d\n, "
544 "pixelaspect %d/%d\n",
545 prt_names(p->type, v4l2_type_names),
546 p->bounds.width, p->bounds.height,
547 p->bounds.left, p->bounds.top,
548 p->defrect.width, p->defrect.height,
549 p->defrect.left, p->defrect.top,
550 p->pixelaspect.numerator, p->pixelaspect.denominator);
553 static void v4l_print_crop(const void *arg, bool write_only)
555 const struct v4l2_crop *p = arg;
557 pr_cont("type=%s, wxh=%dx%d, x,y=%d,%d\n",
558 prt_names(p->type, v4l2_type_names),
559 p->c.width, p->c.height,
560 p->c.left, p->c.top);
563 static void v4l_print_selection(const void *arg, bool write_only)
565 const struct v4l2_selection *p = arg;
567 pr_cont("type=%s, target=%d, flags=0x%x, wxh=%dx%d, x,y=%d,%d\n",
568 prt_names(p->type, v4l2_type_names),
570 p->r.width, p->r.height, p->r.left, p->r.top);
573 static void v4l_print_jpegcompression(const void *arg, bool write_only)
575 const struct v4l2_jpegcompression *p = arg;
577 pr_cont("quality=%d, APPn=%d, APP_len=%d, "
578 "COM_len=%d, jpeg_markers=0x%x\n",
579 p->quality, p->APPn, p->APP_len,
580 p->COM_len, p->jpeg_markers);
583 static void v4l_print_enc_idx(const void *arg, bool write_only)
585 const struct v4l2_enc_idx *p = arg;
587 pr_cont("entries=%d, entries_cap=%d\n",
588 p->entries, p->entries_cap);
591 static void v4l_print_encoder_cmd(const void *arg, bool write_only)
593 const struct v4l2_encoder_cmd *p = arg;
595 pr_cont("cmd=%d, flags=0x%x\n",
599 static void v4l_print_decoder_cmd(const void *arg, bool write_only)
601 const struct v4l2_decoder_cmd *p = arg;
603 pr_cont("cmd=%d, flags=0x%x\n", p->cmd, p->flags);
605 if (p->cmd == V4L2_DEC_CMD_START)
606 pr_info("speed=%d, format=%u\n",
607 p->start.speed, p->start.format);
608 else if (p->cmd == V4L2_DEC_CMD_STOP)
609 pr_info("pts=%llu\n", p->stop.pts);
612 static void v4l_print_dbg_chip_ident(const void *arg, bool write_only)
614 const struct v4l2_dbg_chip_ident *p = arg;
616 pr_cont("type=%u, ", p->match.type);
617 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
618 pr_cont("name=%s, ", p->match.name);
620 pr_cont("addr=%u, ", p->match.addr);
621 pr_cont("chip_ident=%u, revision=0x%x\n",
622 p->ident, p->revision);
625 static void v4l_print_dbg_register(const void *arg, bool write_only)
627 const struct v4l2_dbg_register *p = arg;
629 pr_cont("type=%u, ", p->match.type);
630 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
631 pr_cont("name=%s, ", p->match.name);
633 pr_cont("addr=%u, ", p->match.addr);
634 pr_cont("reg=0x%llx, val=0x%llx\n",
638 static void v4l_print_dv_enum_presets(const void *arg, bool write_only)
640 const struct v4l2_dv_enum_preset *p = arg;
642 pr_cont("index=%u, preset=%u, name=%s, width=%u, height=%u\n",
643 p->index, p->preset, p->name, p->width, p->height);
646 static void v4l_print_dv_preset(const void *arg, bool write_only)
648 const struct v4l2_dv_preset *p = arg;
650 pr_cont("preset=%u\n", p->preset);
653 static void v4l_print_dv_timings(const void *arg, bool write_only)
655 const struct v4l2_dv_timings *p = arg;
658 case V4L2_DV_BT_656_1120:
659 pr_cont("type=bt-656/1120, interlaced=%u, "
661 "width=%u, height=%u, polarities=0x%x, "
662 "hfrontporch=%u, hsync=%u, "
663 "hbackporch=%u, vfrontporch=%u, "
664 "vsync=%u, vbackporch=%u, "
665 "il_vfrontporch=%u, il_vsync=%u, "
666 "il_vbackporch=%u, standards=0x%x, flags=0x%x\n",
667 p->bt.interlaced, p->bt.pixelclock,
668 p->bt.width, p->bt.height,
669 p->bt.polarities, p->bt.hfrontporch,
670 p->bt.hsync, p->bt.hbackporch,
671 p->bt.vfrontporch, p->bt.vsync,
672 p->bt.vbackporch, p->bt.il_vfrontporch,
673 p->bt.il_vsync, p->bt.il_vbackporch,
674 p->bt.standards, p->bt.flags);
677 pr_cont("type=%d\n", p->type);
682 static void v4l_print_enum_dv_timings(const void *arg, bool write_only)
684 const struct v4l2_enum_dv_timings *p = arg;
686 pr_cont("index=%u, ", p->index);
687 v4l_print_dv_timings(&p->timings, write_only);
690 static void v4l_print_dv_timings_cap(const void *arg, bool write_only)
692 const struct v4l2_dv_timings_cap *p = arg;
695 case V4L2_DV_BT_656_1120:
696 pr_cont("type=bt-656/1120, width=%u-%u, height=%u-%u, "
697 "pixelclock=%llu-%llu, standards=0x%x, capabilities=0x%x\n",
698 p->bt.min_width, p->bt.max_width,
699 p->bt.min_height, p->bt.max_height,
700 p->bt.min_pixelclock, p->bt.max_pixelclock,
701 p->bt.standards, p->bt.capabilities);
704 pr_cont("type=%u\n", p->type);
709 static void v4l_print_frmsizeenum(const void *arg, bool write_only)
711 const struct v4l2_frmsizeenum *p = arg;
713 pr_cont("index=%u, pixelformat=%c%c%c%c, type=%u",
715 (p->pixel_format & 0xff),
716 (p->pixel_format >> 8) & 0xff,
717 (p->pixel_format >> 16) & 0xff,
718 (p->pixel_format >> 24) & 0xff,
721 case V4L2_FRMSIZE_TYPE_DISCRETE:
722 pr_cont(" wxh=%ux%u\n",
723 p->discrete.width, p->discrete.height);
725 case V4L2_FRMSIZE_TYPE_STEPWISE:
726 pr_cont(" min=%ux%u, max=%ux%u, step=%ux%u\n",
727 p->stepwise.min_width, p->stepwise.min_height,
728 p->stepwise.step_width, p->stepwise.step_height,
729 p->stepwise.max_width, p->stepwise.max_height);
731 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
739 static void v4l_print_frmivalenum(const void *arg, bool write_only)
741 const struct v4l2_frmivalenum *p = arg;
743 pr_cont("index=%u, pixelformat=%c%c%c%c, wxh=%ux%u, type=%u",
745 (p->pixel_format & 0xff),
746 (p->pixel_format >> 8) & 0xff,
747 (p->pixel_format >> 16) & 0xff,
748 (p->pixel_format >> 24) & 0xff,
749 p->width, p->height, p->type);
751 case V4L2_FRMIVAL_TYPE_DISCRETE:
752 pr_cont(" fps=%d/%d\n",
753 p->discrete.numerator,
754 p->discrete.denominator);
756 case V4L2_FRMIVAL_TYPE_STEPWISE:
757 pr_cont(" min=%d/%d, max=%d/%d, step=%d/%d\n",
758 p->stepwise.min.numerator,
759 p->stepwise.min.denominator,
760 p->stepwise.max.numerator,
761 p->stepwise.max.denominator,
762 p->stepwise.step.numerator,
763 p->stepwise.step.denominator);
765 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
773 static void v4l_print_event(const void *arg, bool write_only)
775 const struct v4l2_event *p = arg;
776 const struct v4l2_event_ctrl *c;
778 pr_cont("type=0x%x, pending=%u, sequence=%u, id=%u, "
779 "timestamp=%lu.%9.9lu\n",
780 p->type, p->pending, p->sequence, p->id,
781 p->timestamp.tv_sec, p->timestamp.tv_nsec);
783 case V4L2_EVENT_VSYNC:
784 printk(KERN_DEBUG "field=%s\n",
785 prt_names(p->u.vsync.field, v4l2_field_names));
787 case V4L2_EVENT_CTRL:
789 printk(KERN_DEBUG "changes=0x%x, type=%u, ",
790 c->changes, c->type);
791 if (c->type == V4L2_CTRL_TYPE_INTEGER64)
792 pr_cont("value64=%lld, ", c->value64);
794 pr_cont("value=%d, ", c->value);
795 pr_cont("flags=0x%x, minimum=%d, maximum=%d, step=%d,"
796 " default_value=%d\n",
797 c->flags, c->minimum, c->maximum,
798 c->step, c->default_value);
800 case V4L2_EVENT_FRAME_SYNC:
801 pr_cont("frame_sequence=%u\n",
802 p->u.frame_sync.frame_sequence);
807 static void v4l_print_event_subscription(const void *arg, bool write_only)
809 const struct v4l2_event_subscription *p = arg;
811 pr_cont("type=0x%x, id=0x%x, flags=0x%x\n",
812 p->type, p->id, p->flags);
815 static void v4l_print_sliced_vbi_cap(const void *arg, bool write_only)
817 const struct v4l2_sliced_vbi_cap *p = arg;
820 pr_cont("type=%s, service_set=0x%08x\n",
821 prt_names(p->type, v4l2_type_names), p->service_set);
822 for (i = 0; i < 24; i++)
823 printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
824 p->service_lines[0][i],
825 p->service_lines[1][i]);
828 static void v4l_print_freq_band(const void *arg, bool write_only)
830 const struct v4l2_frequency_band *p = arg;
832 pr_cont("tuner=%u, type=%u, index=%u, capability=0x%x, "
833 "rangelow=%u, rangehigh=%u, modulation=0x%x\n",
834 p->tuner, p->type, p->index,
835 p->capability, p->rangelow,
836 p->rangehigh, p->modulation);
839 static void v4l_print_u32(const void *arg, bool write_only)
841 pr_cont("value=%u\n", *(const u32 *)arg);
844 static void v4l_print_newline(const void *arg, bool write_only)
849 static void v4l_print_default(const void *arg, bool write_only)
851 pr_cont("driver-specific ioctl\n");
854 static int check_ext_ctrls(struct v4l2_ext_controls *c, int allow_priv)
858 /* zero the reserved fields */
859 c->reserved[0] = c->reserved[1] = 0;
860 for (i = 0; i < c->count; i++)
861 c->controls[i].reserved2[0] = 0;
863 /* V4L2_CID_PRIVATE_BASE cannot be used as control class
864 when using extended controls.
865 Only when passed in through VIDIOC_G_CTRL and VIDIOC_S_CTRL
866 is it allowed for backwards compatibility.
868 if (!allow_priv && c->ctrl_class == V4L2_CID_PRIVATE_BASE)
870 /* Check that all controls are from the same control class. */
871 for (i = 0; i < c->count; i++) {
872 if (V4L2_CTRL_ID2CLASS(c->controls[i].id) != c->ctrl_class) {
880 static int check_fmt(const struct v4l2_ioctl_ops *ops, enum v4l2_buf_type type)
886 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
887 if (ops->vidioc_g_fmt_vid_cap ||
888 ops->vidioc_g_fmt_vid_cap_mplane)
891 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
892 if (ops->vidioc_g_fmt_vid_cap_mplane)
895 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
896 if (ops->vidioc_g_fmt_vid_overlay)
899 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
900 if (ops->vidioc_g_fmt_vid_out ||
901 ops->vidioc_g_fmt_vid_out_mplane)
904 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
905 if (ops->vidioc_g_fmt_vid_out_mplane)
908 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
909 if (ops->vidioc_g_fmt_vid_out_overlay)
912 case V4L2_BUF_TYPE_VBI_CAPTURE:
913 if (ops->vidioc_g_fmt_vbi_cap)
916 case V4L2_BUF_TYPE_VBI_OUTPUT:
917 if (ops->vidioc_g_fmt_vbi_out)
920 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
921 if (ops->vidioc_g_fmt_sliced_vbi_cap)
924 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
925 if (ops->vidioc_g_fmt_sliced_vbi_out)
928 case V4L2_BUF_TYPE_PRIVATE:
929 if (ops->vidioc_g_fmt_type_private)
936 static int v4l_querycap(const struct v4l2_ioctl_ops *ops,
937 struct file *file, void *fh, void *arg)
939 struct v4l2_capability *cap = (struct v4l2_capability *)arg;
941 cap->version = LINUX_VERSION_CODE;
942 return ops->vidioc_querycap(file, fh, cap);
945 static int v4l_s_input(const struct v4l2_ioctl_ops *ops,
946 struct file *file, void *fh, void *arg)
948 return ops->vidioc_s_input(file, fh, *(unsigned int *)arg);
951 static int v4l_s_output(const struct v4l2_ioctl_ops *ops,
952 struct file *file, void *fh, void *arg)
954 return ops->vidioc_s_output(file, fh, *(unsigned int *)arg);
957 static int v4l_g_priority(const struct v4l2_ioctl_ops *ops,
958 struct file *file, void *fh, void *arg)
960 struct video_device *vfd;
963 if (ops->vidioc_g_priority)
964 return ops->vidioc_g_priority(file, fh, arg);
965 vfd = video_devdata(file);
966 *p = v4l2_prio_max(&vfd->v4l2_dev->prio);
970 static int v4l_s_priority(const struct v4l2_ioctl_ops *ops,
971 struct file *file, void *fh, void *arg)
973 struct video_device *vfd;
977 if (ops->vidioc_s_priority)
978 return ops->vidioc_s_priority(file, fh, *p);
979 vfd = video_devdata(file);
980 vfh = file->private_data;
981 return v4l2_prio_change(&vfd->v4l2_dev->prio, &vfh->prio, *p);
984 static int v4l_enuminput(const struct v4l2_ioctl_ops *ops,
985 struct file *file, void *fh, void *arg)
987 struct v4l2_input *p = arg;
990 * We set the flags for CAP_PRESETS, CAP_CUSTOM_TIMINGS &
991 * CAP_STD here based on ioctl handler provided by the
992 * driver. If the driver doesn't support these
993 * for a specific input, it must override these flags.
995 if (ops->vidioc_s_std)
996 p->capabilities |= V4L2_IN_CAP_STD;
997 if (ops->vidioc_s_dv_preset)
998 p->capabilities |= V4L2_IN_CAP_PRESETS;
999 if (ops->vidioc_s_dv_timings)
1000 p->capabilities |= V4L2_IN_CAP_CUSTOM_TIMINGS;
1002 return ops->vidioc_enum_input(file, fh, p);
1005 static int v4l_enumoutput(const struct v4l2_ioctl_ops *ops,
1006 struct file *file, void *fh, void *arg)
1008 struct v4l2_output *p = arg;
1011 * We set the flags for CAP_PRESETS, CAP_CUSTOM_TIMINGS &
1012 * CAP_STD here based on ioctl handler provided by the
1013 * driver. If the driver doesn't support these
1014 * for a specific output, it must override these flags.
1016 if (ops->vidioc_s_std)
1017 p->capabilities |= V4L2_OUT_CAP_STD;
1018 if (ops->vidioc_s_dv_preset)
1019 p->capabilities |= V4L2_OUT_CAP_PRESETS;
1020 if (ops->vidioc_s_dv_timings)
1021 p->capabilities |= V4L2_OUT_CAP_CUSTOM_TIMINGS;
1023 return ops->vidioc_enum_output(file, fh, p);
1026 static int v4l_enum_fmt(const struct v4l2_ioctl_ops *ops,
1027 struct file *file, void *fh, void *arg)
1029 struct v4l2_fmtdesc *p = arg;
1032 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1033 if (unlikely(!ops->vidioc_enum_fmt_vid_cap))
1035 return ops->vidioc_enum_fmt_vid_cap(file, fh, arg);
1036 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1037 if (unlikely(!ops->vidioc_enum_fmt_vid_cap_mplane))
1039 return ops->vidioc_enum_fmt_vid_cap_mplane(file, fh, arg);
1040 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1041 if (unlikely(!ops->vidioc_enum_fmt_vid_overlay))
1043 return ops->vidioc_enum_fmt_vid_overlay(file, fh, arg);
1044 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1045 if (unlikely(!ops->vidioc_enum_fmt_vid_out))
1047 return ops->vidioc_enum_fmt_vid_out(file, fh, arg);
1048 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1049 if (unlikely(!ops->vidioc_enum_fmt_vid_out_mplane))
1051 return ops->vidioc_enum_fmt_vid_out_mplane(file, fh, arg);
1052 case V4L2_BUF_TYPE_PRIVATE:
1053 if (unlikely(!ops->vidioc_enum_fmt_type_private))
1055 return ops->vidioc_enum_fmt_type_private(file, fh, arg);
1060 static int v4l_g_fmt(const struct v4l2_ioctl_ops *ops,
1061 struct file *file, void *fh, void *arg)
1063 struct v4l2_format *p = arg;
1066 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1067 if (unlikely(!ops->vidioc_g_fmt_vid_cap))
1069 return ops->vidioc_g_fmt_vid_cap(file, fh, arg);
1070 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1071 if (unlikely(!ops->vidioc_g_fmt_vid_cap_mplane))
1073 return ops->vidioc_g_fmt_vid_cap_mplane(file, fh, arg);
1074 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1075 if (unlikely(!ops->vidioc_g_fmt_vid_overlay))
1077 return ops->vidioc_g_fmt_vid_overlay(file, fh, arg);
1078 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1079 if (unlikely(!ops->vidioc_g_fmt_vid_out))
1081 return ops->vidioc_g_fmt_vid_out(file, fh, arg);
1082 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1083 if (unlikely(!ops->vidioc_g_fmt_vid_out_mplane))
1085 return ops->vidioc_g_fmt_vid_out_mplane(file, fh, arg);
1086 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1087 if (unlikely(!ops->vidioc_g_fmt_vid_out_overlay))
1089 return ops->vidioc_g_fmt_vid_out_overlay(file, fh, arg);
1090 case V4L2_BUF_TYPE_VBI_CAPTURE:
1091 if (unlikely(!ops->vidioc_g_fmt_vbi_cap))
1093 return ops->vidioc_g_fmt_vbi_cap(file, fh, arg);
1094 case V4L2_BUF_TYPE_VBI_OUTPUT:
1095 if (unlikely(!ops->vidioc_g_fmt_vbi_out))
1097 return ops->vidioc_g_fmt_vbi_out(file, fh, arg);
1098 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1099 if (unlikely(!ops->vidioc_g_fmt_sliced_vbi_cap))
1101 return ops->vidioc_g_fmt_sliced_vbi_cap(file, fh, arg);
1102 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1103 if (unlikely(!ops->vidioc_g_fmt_sliced_vbi_out))
1105 return ops->vidioc_g_fmt_sliced_vbi_out(file, fh, arg);
1106 case V4L2_BUF_TYPE_PRIVATE:
1107 if (unlikely(!ops->vidioc_g_fmt_type_private))
1109 return ops->vidioc_g_fmt_type_private(file, fh, arg);
1114 static int v4l_s_fmt(const struct v4l2_ioctl_ops *ops,
1115 struct file *file, void *fh, void *arg)
1117 struct v4l2_format *p = arg;
1120 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1121 if (unlikely(!ops->vidioc_s_fmt_vid_cap))
1123 CLEAR_AFTER_FIELD(p, fmt.pix);
1124 return ops->vidioc_s_fmt_vid_cap(file, fh, arg);
1125 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1126 if (unlikely(!ops->vidioc_s_fmt_vid_cap_mplane))
1128 CLEAR_AFTER_FIELD(p, fmt.pix_mp);
1129 return ops->vidioc_s_fmt_vid_cap_mplane(file, fh, arg);
1130 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1131 if (unlikely(!ops->vidioc_s_fmt_vid_overlay))
1133 CLEAR_AFTER_FIELD(p, fmt.win);
1134 return ops->vidioc_s_fmt_vid_overlay(file, fh, arg);
1135 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1136 if (unlikely(!ops->vidioc_s_fmt_vid_out))
1138 CLEAR_AFTER_FIELD(p, fmt.pix);
1139 return ops->vidioc_s_fmt_vid_out(file, fh, arg);
1140 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1141 if (unlikely(!ops->vidioc_s_fmt_vid_out_mplane))
1143 CLEAR_AFTER_FIELD(p, fmt.pix_mp);
1144 return ops->vidioc_s_fmt_vid_out_mplane(file, fh, arg);
1145 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1146 if (unlikely(!ops->vidioc_s_fmt_vid_out_overlay))
1148 CLEAR_AFTER_FIELD(p, fmt.win);
1149 return ops->vidioc_s_fmt_vid_out_overlay(file, fh, arg);
1150 case V4L2_BUF_TYPE_VBI_CAPTURE:
1151 if (unlikely(!ops->vidioc_s_fmt_vbi_cap))
1153 CLEAR_AFTER_FIELD(p, fmt.vbi);
1154 return ops->vidioc_s_fmt_vbi_cap(file, fh, arg);
1155 case V4L2_BUF_TYPE_VBI_OUTPUT:
1156 if (unlikely(!ops->vidioc_s_fmt_vbi_out))
1158 CLEAR_AFTER_FIELD(p, fmt.vbi);
1159 return ops->vidioc_s_fmt_vbi_out(file, fh, arg);
1160 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1161 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_cap))
1163 CLEAR_AFTER_FIELD(p, fmt.sliced);
1164 return ops->vidioc_s_fmt_sliced_vbi_cap(file, fh, arg);
1165 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1166 if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_out))
1168 CLEAR_AFTER_FIELD(p, fmt.sliced);
1169 return ops->vidioc_s_fmt_sliced_vbi_out(file, fh, arg);
1170 case V4L2_BUF_TYPE_PRIVATE:
1171 if (unlikely(!ops->vidioc_s_fmt_type_private))
1173 return ops->vidioc_s_fmt_type_private(file, fh, arg);
1178 static int v4l_try_fmt(const struct v4l2_ioctl_ops *ops,
1179 struct file *file, void *fh, void *arg)
1181 struct v4l2_format *p = arg;
1184 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1185 if (unlikely(!ops->vidioc_try_fmt_vid_cap))
1187 CLEAR_AFTER_FIELD(p, fmt.pix);
1188 return ops->vidioc_try_fmt_vid_cap(file, fh, arg);
1189 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1190 if (unlikely(!ops->vidioc_try_fmt_vid_cap_mplane))
1192 CLEAR_AFTER_FIELD(p, fmt.pix_mp);
1193 return ops->vidioc_try_fmt_vid_cap_mplane(file, fh, arg);
1194 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1195 if (unlikely(!ops->vidioc_try_fmt_vid_overlay))
1197 CLEAR_AFTER_FIELD(p, fmt.win);
1198 return ops->vidioc_try_fmt_vid_overlay(file, fh, arg);
1199 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1200 if (unlikely(!ops->vidioc_try_fmt_vid_out))
1202 CLEAR_AFTER_FIELD(p, fmt.pix);
1203 return ops->vidioc_try_fmt_vid_out(file, fh, arg);
1204 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1205 if (unlikely(!ops->vidioc_try_fmt_vid_out_mplane))
1207 CLEAR_AFTER_FIELD(p, fmt.pix_mp);
1208 return ops->vidioc_try_fmt_vid_out_mplane(file, fh, arg);
1209 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
1210 if (unlikely(!ops->vidioc_try_fmt_vid_out_overlay))
1212 CLEAR_AFTER_FIELD(p, fmt.win);
1213 return ops->vidioc_try_fmt_vid_out_overlay(file, fh, arg);
1214 case V4L2_BUF_TYPE_VBI_CAPTURE:
1215 if (unlikely(!ops->vidioc_try_fmt_vbi_cap))
1217 CLEAR_AFTER_FIELD(p, fmt.vbi);
1218 return ops->vidioc_try_fmt_vbi_cap(file, fh, arg);
1219 case V4L2_BUF_TYPE_VBI_OUTPUT:
1220 if (unlikely(!ops->vidioc_try_fmt_vbi_out))
1222 CLEAR_AFTER_FIELD(p, fmt.vbi);
1223 return ops->vidioc_try_fmt_vbi_out(file, fh, arg);
1224 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
1225 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_cap))
1227 CLEAR_AFTER_FIELD(p, fmt.sliced);
1228 return ops->vidioc_try_fmt_sliced_vbi_cap(file, fh, arg);
1229 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
1230 if (unlikely(!ops->vidioc_try_fmt_sliced_vbi_out))
1232 CLEAR_AFTER_FIELD(p, fmt.sliced);
1233 return ops->vidioc_try_fmt_sliced_vbi_out(file, fh, arg);
1234 case V4L2_BUF_TYPE_PRIVATE:
1235 if (unlikely(!ops->vidioc_try_fmt_type_private))
1237 return ops->vidioc_try_fmt_type_private(file, fh, arg);
1242 static int v4l_streamon(const struct v4l2_ioctl_ops *ops,
1243 struct file *file, void *fh, void *arg)
1245 return ops->vidioc_streamon(file, fh, *(unsigned int *)arg);
1248 static int v4l_streamoff(const struct v4l2_ioctl_ops *ops,
1249 struct file *file, void *fh, void *arg)
1251 return ops->vidioc_streamoff(file, fh, *(unsigned int *)arg);
1254 static int v4l_g_tuner(const struct v4l2_ioctl_ops *ops,
1255 struct file *file, void *fh, void *arg)
1257 struct video_device *vfd = video_devdata(file);
1258 struct v4l2_tuner *p = arg;
1261 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1262 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1263 err = ops->vidioc_g_tuner(file, fh, p);
1265 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1269 static int v4l_s_tuner(const struct v4l2_ioctl_ops *ops,
1270 struct file *file, void *fh, void *arg)
1272 struct video_device *vfd = video_devdata(file);
1273 struct v4l2_tuner *p = arg;
1275 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1276 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1277 return ops->vidioc_s_tuner(file, fh, p);
1280 static int v4l_g_modulator(const struct v4l2_ioctl_ops *ops,
1281 struct file *file, void *fh, void *arg)
1283 struct v4l2_modulator *p = arg;
1286 err = ops->vidioc_g_modulator(file, fh, p);
1288 p->capability |= V4L2_TUNER_CAP_FREQ_BANDS;
1292 static int v4l_g_frequency(const struct v4l2_ioctl_ops *ops,
1293 struct file *file, void *fh, void *arg)
1295 struct video_device *vfd = video_devdata(file);
1296 struct v4l2_frequency *p = arg;
1298 p->type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1299 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1300 return ops->vidioc_g_frequency(file, fh, p);
1303 static int v4l_s_frequency(const struct v4l2_ioctl_ops *ops,
1304 struct file *file, void *fh, void *arg)
1306 struct video_device *vfd = video_devdata(file);
1307 struct v4l2_frequency *p = arg;
1308 enum v4l2_tuner_type type;
1310 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1311 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1312 if (p->type != type)
1314 return ops->vidioc_s_frequency(file, fh, p);
1317 static int v4l_enumstd(const struct v4l2_ioctl_ops *ops,
1318 struct file *file, void *fh, void *arg)
1320 struct video_device *vfd = video_devdata(file);
1321 struct v4l2_standard *p = arg;
1322 v4l2_std_id id = vfd->tvnorms, curr_id = 0;
1323 unsigned int index = p->index, i, j = 0;
1324 const char *descr = "";
1326 /* Return norm array in a canonical way */
1327 for (i = 0; i <= index && id; i++) {
1328 /* last std value in the standards array is 0, so this
1329 while always ends there since (id & 0) == 0. */
1330 while ((id & standards[j].std) != standards[j].std)
1332 curr_id = standards[j].std;
1333 descr = standards[j].descr;
1337 if (curr_id != V4L2_STD_PAL &&
1338 curr_id != V4L2_STD_SECAM &&
1339 curr_id != V4L2_STD_NTSC)
1345 v4l2_video_std_construct(p, curr_id, descr);
1349 static int v4l_g_std(const struct v4l2_ioctl_ops *ops,
1350 struct file *file, void *fh, void *arg)
1352 struct video_device *vfd = video_devdata(file);
1353 v4l2_std_id *id = arg;
1355 /* Calls the specific handler */
1356 if (ops->vidioc_g_std)
1357 return ops->vidioc_g_std(file, fh, arg);
1358 if (vfd->current_norm) {
1359 *id = vfd->current_norm;
1365 static int v4l_s_std(const struct v4l2_ioctl_ops *ops,
1366 struct file *file, void *fh, void *arg)
1368 struct video_device *vfd = video_devdata(file);
1369 v4l2_std_id *id = arg, norm;
1372 norm = (*id) & vfd->tvnorms;
1373 if (vfd->tvnorms && !norm) /* Check if std is supported */
1376 /* Calls the specific handler */
1377 ret = ops->vidioc_s_std(file, fh, &norm);
1379 /* Updates standard information */
1381 vfd->current_norm = norm;
1385 static int v4l_querystd(const struct v4l2_ioctl_ops *ops,
1386 struct file *file, void *fh, void *arg)
1388 struct video_device *vfd = video_devdata(file);
1389 v4l2_std_id *p = arg;
1392 * If nothing detected, it should return all supported
1394 * Drivers just need to mask the std argument, in order
1395 * to remove the standards that don't apply from the mask.
1396 * This means that tuners, audio and video decoders can join
1397 * their efforts to improve the standards detection.
1400 return ops->vidioc_querystd(file, fh, arg);
1403 static int v4l_s_hw_freq_seek(const struct v4l2_ioctl_ops *ops,
1404 struct file *file, void *fh, void *arg)
1406 struct video_device *vfd = video_devdata(file);
1407 struct v4l2_hw_freq_seek *p = arg;
1408 enum v4l2_tuner_type type;
1410 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1411 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1412 if (p->type != type)
1414 return ops->vidioc_s_hw_freq_seek(file, fh, p);
1417 static int v4l_reqbufs(const struct v4l2_ioctl_ops *ops,
1418 struct file *file, void *fh, void *arg)
1420 struct v4l2_requestbuffers *p = arg;
1421 int ret = check_fmt(ops, p->type);
1426 if (p->type < V4L2_BUF_TYPE_PRIVATE)
1427 CLEAR_AFTER_FIELD(p, memory);
1429 return ops->vidioc_reqbufs(file, fh, p);
1432 static int v4l_querybuf(const struct v4l2_ioctl_ops *ops,
1433 struct file *file, void *fh, void *arg)
1435 struct v4l2_buffer *p = arg;
1436 int ret = check_fmt(ops, p->type);
1438 return ret ? ret : ops->vidioc_querybuf(file, fh, p);
1441 static int v4l_qbuf(const struct v4l2_ioctl_ops *ops,
1442 struct file *file, void *fh, void *arg)
1444 struct v4l2_buffer *p = arg;
1445 int ret = check_fmt(ops, p->type);
1447 return ret ? ret : ops->vidioc_qbuf(file, fh, p);
1450 static int v4l_dqbuf(const struct v4l2_ioctl_ops *ops,
1451 struct file *file, void *fh, void *arg)
1453 struct v4l2_buffer *p = arg;
1454 int ret = check_fmt(ops, p->type);
1456 return ret ? ret : ops->vidioc_dqbuf(file, fh, p);
1459 static int v4l_create_bufs(const struct v4l2_ioctl_ops *ops,
1460 struct file *file, void *fh, void *arg)
1462 struct v4l2_create_buffers *create = arg;
1463 int ret = check_fmt(ops, create->format.type);
1465 return ret ? ret : ops->vidioc_create_bufs(file, fh, create);
1468 static int v4l_prepare_buf(const struct v4l2_ioctl_ops *ops,
1469 struct file *file, void *fh, void *arg)
1471 struct v4l2_buffer *b = arg;
1472 int ret = check_fmt(ops, b->type);
1474 return ret ? ret : ops->vidioc_prepare_buf(file, fh, b);
1477 static int v4l_g_parm(const struct v4l2_ioctl_ops *ops,
1478 struct file *file, void *fh, void *arg)
1480 struct video_device *vfd = video_devdata(file);
1481 struct v4l2_streamparm *p = arg;
1483 int ret = check_fmt(ops, p->type);
1487 if (ops->vidioc_g_parm)
1488 return ops->vidioc_g_parm(file, fh, p);
1489 std = vfd->current_norm;
1490 if (p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
1491 p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE)
1493 p->parm.capture.readbuffers = 2;
1494 if (ops->vidioc_g_std)
1495 ret = ops->vidioc_g_std(file, fh, &std);
1497 v4l2_video_std_frame_period(std,
1498 &p->parm.capture.timeperframe);
1502 static int v4l_s_parm(const struct v4l2_ioctl_ops *ops,
1503 struct file *file, void *fh, void *arg)
1505 struct v4l2_streamparm *p = arg;
1506 int ret = check_fmt(ops, p->type);
1508 return ret ? ret : ops->vidioc_s_parm(file, fh, p);
1511 static int v4l_queryctrl(const struct v4l2_ioctl_ops *ops,
1512 struct file *file, void *fh, void *arg)
1514 struct video_device *vfd = video_devdata(file);
1515 struct v4l2_queryctrl *p = arg;
1516 struct v4l2_fh *vfh =
1517 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1519 if (vfh && vfh->ctrl_handler)
1520 return v4l2_queryctrl(vfh->ctrl_handler, p);
1521 if (vfd->ctrl_handler)
1522 return v4l2_queryctrl(vfd->ctrl_handler, p);
1523 if (ops->vidioc_queryctrl)
1524 return ops->vidioc_queryctrl(file, fh, p);
1528 static int v4l_querymenu(const struct v4l2_ioctl_ops *ops,
1529 struct file *file, void *fh, void *arg)
1531 struct video_device *vfd = video_devdata(file);
1532 struct v4l2_querymenu *p = arg;
1533 struct v4l2_fh *vfh =
1534 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1536 if (vfh && vfh->ctrl_handler)
1537 return v4l2_querymenu(vfh->ctrl_handler, p);
1538 if (vfd->ctrl_handler)
1539 return v4l2_querymenu(vfd->ctrl_handler, p);
1540 if (ops->vidioc_querymenu)
1541 return ops->vidioc_querymenu(file, fh, p);
1545 static int v4l_g_ctrl(const struct v4l2_ioctl_ops *ops,
1546 struct file *file, void *fh, void *arg)
1548 struct video_device *vfd = video_devdata(file);
1549 struct v4l2_control *p = arg;
1550 struct v4l2_fh *vfh =
1551 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1552 struct v4l2_ext_controls ctrls;
1553 struct v4l2_ext_control ctrl;
1555 if (vfh && vfh->ctrl_handler)
1556 return v4l2_g_ctrl(vfh->ctrl_handler, p);
1557 if (vfd->ctrl_handler)
1558 return v4l2_g_ctrl(vfd->ctrl_handler, p);
1559 if (ops->vidioc_g_ctrl)
1560 return ops->vidioc_g_ctrl(file, fh, p);
1561 if (ops->vidioc_g_ext_ctrls == NULL)
1564 ctrls.ctrl_class = V4L2_CTRL_ID2CLASS(p->id);
1566 ctrls.controls = &ctrl;
1568 ctrl.value = p->value;
1569 if (check_ext_ctrls(&ctrls, 1)) {
1570 int ret = ops->vidioc_g_ext_ctrls(file, fh, &ctrls);
1573 p->value = ctrl.value;
1579 static int v4l_s_ctrl(const struct v4l2_ioctl_ops *ops,
1580 struct file *file, void *fh, void *arg)
1582 struct video_device *vfd = video_devdata(file);
1583 struct v4l2_control *p = arg;
1584 struct v4l2_fh *vfh =
1585 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1586 struct v4l2_ext_controls ctrls;
1587 struct v4l2_ext_control ctrl;
1589 if (vfh && vfh->ctrl_handler)
1590 return v4l2_s_ctrl(vfh, vfh->ctrl_handler, p);
1591 if (vfd->ctrl_handler)
1592 return v4l2_s_ctrl(NULL, vfd->ctrl_handler, p);
1593 if (ops->vidioc_s_ctrl)
1594 return ops->vidioc_s_ctrl(file, fh, p);
1595 if (ops->vidioc_s_ext_ctrls == NULL)
1598 ctrls.ctrl_class = V4L2_CTRL_ID2CLASS(p->id);
1600 ctrls.controls = &ctrl;
1602 ctrl.value = p->value;
1603 if (check_ext_ctrls(&ctrls, 1))
1604 return ops->vidioc_s_ext_ctrls(file, fh, &ctrls);
1608 static int v4l_g_ext_ctrls(const struct v4l2_ioctl_ops *ops,
1609 struct file *file, void *fh, void *arg)
1611 struct video_device *vfd = video_devdata(file);
1612 struct v4l2_ext_controls *p = arg;
1613 struct v4l2_fh *vfh =
1614 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1616 p->error_idx = p->count;
1617 if (vfh && vfh->ctrl_handler)
1618 return v4l2_g_ext_ctrls(vfh->ctrl_handler, p);
1619 if (vfd->ctrl_handler)
1620 return v4l2_g_ext_ctrls(vfd->ctrl_handler, p);
1621 if (ops->vidioc_g_ext_ctrls == NULL)
1623 return check_ext_ctrls(p, 0) ? ops->vidioc_g_ext_ctrls(file, fh, p) :
1627 static int v4l_s_ext_ctrls(const struct v4l2_ioctl_ops *ops,
1628 struct file *file, void *fh, void *arg)
1630 struct video_device *vfd = video_devdata(file);
1631 struct v4l2_ext_controls *p = arg;
1632 struct v4l2_fh *vfh =
1633 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1635 p->error_idx = p->count;
1636 if (vfh && vfh->ctrl_handler)
1637 return v4l2_s_ext_ctrls(vfh, vfh->ctrl_handler, p);
1638 if (vfd->ctrl_handler)
1639 return v4l2_s_ext_ctrls(NULL, vfd->ctrl_handler, p);
1640 if (ops->vidioc_s_ext_ctrls == NULL)
1642 return check_ext_ctrls(p, 0) ? ops->vidioc_s_ext_ctrls(file, fh, p) :
1646 static int v4l_try_ext_ctrls(const struct v4l2_ioctl_ops *ops,
1647 struct file *file, void *fh, void *arg)
1649 struct video_device *vfd = video_devdata(file);
1650 struct v4l2_ext_controls *p = arg;
1651 struct v4l2_fh *vfh =
1652 test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags) ? fh : NULL;
1654 p->error_idx = p->count;
1655 if (vfh && vfh->ctrl_handler)
1656 return v4l2_try_ext_ctrls(vfh->ctrl_handler, p);
1657 if (vfd->ctrl_handler)
1658 return v4l2_try_ext_ctrls(vfd->ctrl_handler, p);
1659 if (ops->vidioc_try_ext_ctrls == NULL)
1661 return check_ext_ctrls(p, 0) ? ops->vidioc_try_ext_ctrls(file, fh, p) :
1665 static int v4l_g_crop(const struct v4l2_ioctl_ops *ops,
1666 struct file *file, void *fh, void *arg)
1668 struct v4l2_crop *p = arg;
1669 struct v4l2_selection s = {
1674 if (ops->vidioc_g_crop)
1675 return ops->vidioc_g_crop(file, fh, p);
1676 /* simulate capture crop using selection api */
1678 /* crop means compose for output devices */
1679 if (V4L2_TYPE_IS_OUTPUT(p->type))
1680 s.target = V4L2_SEL_TGT_COMPOSE_ACTIVE;
1682 s.target = V4L2_SEL_TGT_CROP_ACTIVE;
1684 ret = ops->vidioc_g_selection(file, fh, &s);
1686 /* copying results to old structure on success */
1692 static int v4l_s_crop(const struct v4l2_ioctl_ops *ops,
1693 struct file *file, void *fh, void *arg)
1695 struct v4l2_crop *p = arg;
1696 struct v4l2_selection s = {
1701 if (ops->vidioc_s_crop)
1702 return ops->vidioc_s_crop(file, fh, p);
1703 /* simulate capture crop using selection api */
1705 /* crop means compose for output devices */
1706 if (V4L2_TYPE_IS_OUTPUT(p->type))
1707 s.target = V4L2_SEL_TGT_COMPOSE_ACTIVE;
1709 s.target = V4L2_SEL_TGT_CROP_ACTIVE;
1711 return ops->vidioc_s_selection(file, fh, &s);
1714 static int v4l_cropcap(const struct v4l2_ioctl_ops *ops,
1715 struct file *file, void *fh, void *arg)
1717 struct v4l2_cropcap *p = arg;
1718 struct v4l2_selection s = { .type = p->type };
1721 if (ops->vidioc_cropcap)
1722 return ops->vidioc_cropcap(file, fh, p);
1724 /* obtaining bounds */
1725 if (V4L2_TYPE_IS_OUTPUT(p->type))
1726 s.target = V4L2_SEL_TGT_COMPOSE_BOUNDS;
1728 s.target = V4L2_SEL_TGT_CROP_BOUNDS;
1730 ret = ops->vidioc_g_selection(file, fh, &s);
1735 /* obtaining defrect */
1736 if (V4L2_TYPE_IS_OUTPUT(p->type))
1737 s.target = V4L2_SEL_TGT_COMPOSE_DEFAULT;
1739 s.target = V4L2_SEL_TGT_CROP_DEFAULT;
1741 ret = ops->vidioc_g_selection(file, fh, &s);
1746 /* setting trivial pixelaspect */
1747 p->pixelaspect.numerator = 1;
1748 p->pixelaspect.denominator = 1;
1752 static int v4l_log_status(const struct v4l2_ioctl_ops *ops,
1753 struct file *file, void *fh, void *arg)
1755 struct video_device *vfd = video_devdata(file);
1759 pr_info("%s: ================= START STATUS =================\n",
1760 vfd->v4l2_dev->name);
1761 ret = ops->vidioc_log_status(file, fh);
1763 pr_info("%s: ================== END STATUS ==================\n",
1764 vfd->v4l2_dev->name);
1768 static int v4l_dbg_g_register(const struct v4l2_ioctl_ops *ops,
1769 struct file *file, void *fh, void *arg)
1771 #ifdef CONFIG_VIDEO_ADV_DEBUG
1772 struct v4l2_dbg_register *p = arg;
1774 if (!capable(CAP_SYS_ADMIN))
1776 return ops->vidioc_g_register(file, fh, p);
1782 static int v4l_dbg_s_register(const struct v4l2_ioctl_ops *ops,
1783 struct file *file, void *fh, void *arg)
1785 #ifdef CONFIG_VIDEO_ADV_DEBUG
1786 struct v4l2_dbg_register *p = arg;
1788 if (!capable(CAP_SYS_ADMIN))
1790 return ops->vidioc_s_register(file, fh, p);
1796 static int v4l_dbg_g_chip_ident(const struct v4l2_ioctl_ops *ops,
1797 struct file *file, void *fh, void *arg)
1799 struct v4l2_dbg_chip_ident *p = arg;
1801 p->ident = V4L2_IDENT_NONE;
1803 return ops->vidioc_g_chip_ident(file, fh, p);
1806 static int v4l_dqevent(const struct v4l2_ioctl_ops *ops,
1807 struct file *file, void *fh, void *arg)
1809 return v4l2_event_dequeue(fh, arg, file->f_flags & O_NONBLOCK);
1812 static int v4l_subscribe_event(const struct v4l2_ioctl_ops *ops,
1813 struct file *file, void *fh, void *arg)
1815 return ops->vidioc_subscribe_event(fh, arg);
1818 static int v4l_unsubscribe_event(const struct v4l2_ioctl_ops *ops,
1819 struct file *file, void *fh, void *arg)
1821 return ops->vidioc_unsubscribe_event(fh, arg);
1824 static int v4l_g_sliced_vbi_cap(const struct v4l2_ioctl_ops *ops,
1825 struct file *file, void *fh, void *arg)
1827 struct v4l2_sliced_vbi_cap *p = arg;
1829 /* Clear up to type, everything after type is zeroed already */
1830 memset(p, 0, offsetof(struct v4l2_sliced_vbi_cap, type));
1832 return ops->vidioc_g_sliced_vbi_cap(file, fh, p);
1835 static int v4l_enum_freq_bands(const struct v4l2_ioctl_ops *ops,
1836 struct file *file, void *fh, void *arg)
1838 struct video_device *vfd = video_devdata(file);
1839 struct v4l2_frequency_band *p = arg;
1840 enum v4l2_tuner_type type;
1843 type = (vfd->vfl_type == VFL_TYPE_RADIO) ?
1844 V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1846 if (type != p->type)
1848 if (ops->vidioc_enum_freq_bands)
1849 return ops->vidioc_enum_freq_bands(file, fh, p);
1850 if (ops->vidioc_g_tuner) {
1851 struct v4l2_tuner t = {
1856 err = ops->vidioc_g_tuner(file, fh, &t);
1859 p->capability = t.capability | V4L2_TUNER_CAP_FREQ_BANDS;
1860 p->rangelow = t.rangelow;
1861 p->rangehigh = t.rangehigh;
1862 p->modulation = (type == V4L2_TUNER_RADIO) ?
1863 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
1866 if (ops->vidioc_g_modulator) {
1867 struct v4l2_modulator m = {
1871 if (type != V4L2_TUNER_RADIO)
1873 err = ops->vidioc_g_modulator(file, fh, &m);
1876 p->capability = m.capability | V4L2_TUNER_CAP_FREQ_BANDS;
1877 p->rangelow = m.rangelow;
1878 p->rangehigh = m.rangehigh;
1879 p->modulation = (type == V4L2_TUNER_RADIO) ?
1880 V4L2_BAND_MODULATION_FM : V4L2_BAND_MODULATION_VSB;
1886 struct v4l2_ioctl_info {
1889 const char * const name;
1892 int (*func)(const struct v4l2_ioctl_ops *ops,
1893 struct file *file, void *fh, void *p);
1895 void (*debug)(const void *arg, bool write_only);
1898 /* This control needs a priority check */
1899 #define INFO_FL_PRIO (1 << 0)
1900 /* This control can be valid if the filehandle passes a control handler. */
1901 #define INFO_FL_CTRL (1 << 1)
1902 /* This is a standard ioctl, no need for special code */
1903 #define INFO_FL_STD (1 << 2)
1904 /* This is ioctl has its own function */
1905 #define INFO_FL_FUNC (1 << 3)
1907 #define INFO_FL_QUEUE (1 << 4)
1908 /* Zero struct from after the field to the end */
1909 #define INFO_FL_CLEAR(v4l2_struct, field) \
1910 ((offsetof(struct v4l2_struct, field) + \
1911 sizeof(((struct v4l2_struct *)0)->field)) << 16)
1912 #define INFO_FL_CLEAR_MASK (_IOC_SIZEMASK << 16)
1914 #define IOCTL_INFO_STD(_ioctl, _vidioc, _debug, _flags) \
1915 [_IOC_NR(_ioctl)] = { \
1917 .flags = _flags | INFO_FL_STD, \
1919 .u.offset = offsetof(struct v4l2_ioctl_ops, _vidioc), \
1923 #define IOCTL_INFO_FNC(_ioctl, _func, _debug, _flags) \
1924 [_IOC_NR(_ioctl)] = { \
1926 .flags = _flags | INFO_FL_FUNC, \
1932 static struct v4l2_ioctl_info v4l2_ioctls[] = {
1933 IOCTL_INFO_FNC(VIDIOC_QUERYCAP, v4l_querycap, v4l_print_querycap, 0),
1934 IOCTL_INFO_FNC(VIDIOC_ENUM_FMT, v4l_enum_fmt, v4l_print_fmtdesc, INFO_FL_CLEAR(v4l2_fmtdesc, type)),
1935 IOCTL_INFO_FNC(VIDIOC_G_FMT, v4l_g_fmt, v4l_print_format, INFO_FL_CLEAR(v4l2_format, type)),
1936 IOCTL_INFO_FNC(VIDIOC_S_FMT, v4l_s_fmt, v4l_print_format, INFO_FL_PRIO),
1937 IOCTL_INFO_FNC(VIDIOC_REQBUFS, v4l_reqbufs, v4l_print_requestbuffers, INFO_FL_PRIO | INFO_FL_QUEUE),
1938 IOCTL_INFO_FNC(VIDIOC_QUERYBUF, v4l_querybuf, v4l_print_buffer, INFO_FL_QUEUE | INFO_FL_CLEAR(v4l2_buffer, length)),
1939 IOCTL_INFO_STD(VIDIOC_G_FBUF, vidioc_g_fbuf, v4l_print_framebuffer, 0),
1940 IOCTL_INFO_STD(VIDIOC_S_FBUF, vidioc_s_fbuf, v4l_print_framebuffer, INFO_FL_PRIO),
1941 IOCTL_INFO_STD(VIDIOC_OVERLAY, vidioc_overlay, v4l_print_u32, INFO_FL_PRIO),
1942 IOCTL_INFO_FNC(VIDIOC_QBUF, v4l_qbuf, v4l_print_buffer, INFO_FL_QUEUE),
1943 IOCTL_INFO_FNC(VIDIOC_DQBUF, v4l_dqbuf, v4l_print_buffer, INFO_FL_QUEUE),
1944 IOCTL_INFO_FNC(VIDIOC_STREAMON, v4l_streamon, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
1945 IOCTL_INFO_FNC(VIDIOC_STREAMOFF, v4l_streamoff, v4l_print_buftype, INFO_FL_PRIO | INFO_FL_QUEUE),
1946 IOCTL_INFO_FNC(VIDIOC_G_PARM, v4l_g_parm, v4l_print_streamparm, INFO_FL_CLEAR(v4l2_streamparm, type)),
1947 IOCTL_INFO_FNC(VIDIOC_S_PARM, v4l_s_parm, v4l_print_streamparm, INFO_FL_PRIO),
1948 IOCTL_INFO_FNC(VIDIOC_G_STD, v4l_g_std, v4l_print_std, 0),
1949 IOCTL_INFO_FNC(VIDIOC_S_STD, v4l_s_std, v4l_print_std, INFO_FL_PRIO),
1950 IOCTL_INFO_FNC(VIDIOC_ENUMSTD, v4l_enumstd, v4l_print_standard, INFO_FL_CLEAR(v4l2_standard, index)),
1951 IOCTL_INFO_FNC(VIDIOC_ENUMINPUT, v4l_enuminput, v4l_print_enuminput, INFO_FL_CLEAR(v4l2_input, index)),
1952 IOCTL_INFO_FNC(VIDIOC_G_CTRL, v4l_g_ctrl, v4l_print_control, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_control, id)),
1953 IOCTL_INFO_FNC(VIDIOC_S_CTRL, v4l_s_ctrl, v4l_print_control, INFO_FL_PRIO | INFO_FL_CTRL),
1954 IOCTL_INFO_FNC(VIDIOC_G_TUNER, v4l_g_tuner, v4l_print_tuner, INFO_FL_CLEAR(v4l2_tuner, index)),
1955 IOCTL_INFO_FNC(VIDIOC_S_TUNER, v4l_s_tuner, v4l_print_tuner, INFO_FL_PRIO),
1956 IOCTL_INFO_STD(VIDIOC_G_AUDIO, vidioc_g_audio, v4l_print_audio, 0),
1957 IOCTL_INFO_STD(VIDIOC_S_AUDIO, vidioc_s_audio, v4l_print_audio, INFO_FL_PRIO),
1958 IOCTL_INFO_FNC(VIDIOC_QUERYCTRL, v4l_queryctrl, v4l_print_queryctrl, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_queryctrl, id)),
1959 IOCTL_INFO_FNC(VIDIOC_QUERYMENU, v4l_querymenu, v4l_print_querymenu, INFO_FL_CTRL | INFO_FL_CLEAR(v4l2_querymenu, index)),
1960 IOCTL_INFO_STD(VIDIOC_G_INPUT, vidioc_g_input, v4l_print_u32, 0),
1961 IOCTL_INFO_FNC(VIDIOC_S_INPUT, v4l_s_input, v4l_print_u32, INFO_FL_PRIO),
1962 IOCTL_INFO_STD(VIDIOC_G_OUTPUT, vidioc_g_output, v4l_print_u32, 0),
1963 IOCTL_INFO_FNC(VIDIOC_S_OUTPUT, v4l_s_output, v4l_print_u32, INFO_FL_PRIO),
1964 IOCTL_INFO_FNC(VIDIOC_ENUMOUTPUT, v4l_enumoutput, v4l_print_enumoutput, INFO_FL_CLEAR(v4l2_output, index)),
1965 IOCTL_INFO_STD(VIDIOC_G_AUDOUT, vidioc_g_audout, v4l_print_audioout, 0),
1966 IOCTL_INFO_STD(VIDIOC_S_AUDOUT, vidioc_s_audout, v4l_print_audioout, INFO_FL_PRIO),
1967 IOCTL_INFO_FNC(VIDIOC_G_MODULATOR, v4l_g_modulator, v4l_print_modulator, INFO_FL_CLEAR(v4l2_modulator, index)),
1968 IOCTL_INFO_STD(VIDIOC_S_MODULATOR, vidioc_s_modulator, v4l_print_modulator, INFO_FL_PRIO),
1969 IOCTL_INFO_FNC(VIDIOC_G_FREQUENCY, v4l_g_frequency, v4l_print_frequency, INFO_FL_CLEAR(v4l2_frequency, tuner)),
1970 IOCTL_INFO_FNC(VIDIOC_S_FREQUENCY, v4l_s_frequency, v4l_print_frequency, INFO_FL_PRIO),
1971 IOCTL_INFO_FNC(VIDIOC_CROPCAP, v4l_cropcap, v4l_print_cropcap, INFO_FL_CLEAR(v4l2_cropcap, type)),
1972 IOCTL_INFO_FNC(VIDIOC_G_CROP, v4l_g_crop, v4l_print_crop, INFO_FL_CLEAR(v4l2_crop, type)),
1973 IOCTL_INFO_FNC(VIDIOC_S_CROP, v4l_s_crop, v4l_print_crop, INFO_FL_PRIO),
1974 IOCTL_INFO_STD(VIDIOC_G_SELECTION, vidioc_g_selection, v4l_print_selection, 0),
1975 IOCTL_INFO_STD(VIDIOC_S_SELECTION, vidioc_s_selection, v4l_print_selection, INFO_FL_PRIO),
1976 IOCTL_INFO_STD(VIDIOC_G_JPEGCOMP, vidioc_g_jpegcomp, v4l_print_jpegcompression, 0),
1977 IOCTL_INFO_STD(VIDIOC_S_JPEGCOMP, vidioc_s_jpegcomp, v4l_print_jpegcompression, INFO_FL_PRIO),
1978 IOCTL_INFO_FNC(VIDIOC_QUERYSTD, v4l_querystd, v4l_print_std, 0),
1979 IOCTL_INFO_FNC(VIDIOC_TRY_FMT, v4l_try_fmt, v4l_print_format, 0),
1980 IOCTL_INFO_STD(VIDIOC_ENUMAUDIO, vidioc_enumaudio, v4l_print_audio, INFO_FL_CLEAR(v4l2_audio, index)),
1981 IOCTL_INFO_STD(VIDIOC_ENUMAUDOUT, vidioc_enumaudout, v4l_print_audioout, INFO_FL_CLEAR(v4l2_audioout, index)),
1982 IOCTL_INFO_FNC(VIDIOC_G_PRIORITY, v4l_g_priority, v4l_print_u32, 0),
1983 IOCTL_INFO_FNC(VIDIOC_S_PRIORITY, v4l_s_priority, v4l_print_u32, INFO_FL_PRIO),
1984 IOCTL_INFO_FNC(VIDIOC_G_SLICED_VBI_CAP, v4l_g_sliced_vbi_cap, v4l_print_sliced_vbi_cap, INFO_FL_CLEAR(v4l2_sliced_vbi_cap, type)),
1985 IOCTL_INFO_FNC(VIDIOC_LOG_STATUS, v4l_log_status, v4l_print_newline, 0),
1986 IOCTL_INFO_FNC(VIDIOC_G_EXT_CTRLS, v4l_g_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL),
1987 IOCTL_INFO_FNC(VIDIOC_S_EXT_CTRLS, v4l_s_ext_ctrls, v4l_print_ext_controls, INFO_FL_PRIO | INFO_FL_CTRL),
1988 IOCTL_INFO_FNC(VIDIOC_TRY_EXT_CTRLS, v4l_try_ext_ctrls, v4l_print_ext_controls, INFO_FL_CTRL),
1989 IOCTL_INFO_STD(VIDIOC_ENUM_FRAMESIZES, vidioc_enum_framesizes, v4l_print_frmsizeenum, INFO_FL_CLEAR(v4l2_frmsizeenum, pixel_format)),
1990 IOCTL_INFO_STD(VIDIOC_ENUM_FRAMEINTERVALS, vidioc_enum_frameintervals, v4l_print_frmivalenum, INFO_FL_CLEAR(v4l2_frmivalenum, height)),
1991 IOCTL_INFO_STD(VIDIOC_G_ENC_INDEX, vidioc_g_enc_index, v4l_print_enc_idx, 0),
1992 IOCTL_INFO_STD(VIDIOC_ENCODER_CMD, vidioc_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_PRIO | INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
1993 IOCTL_INFO_STD(VIDIOC_TRY_ENCODER_CMD, vidioc_try_encoder_cmd, v4l_print_encoder_cmd, INFO_FL_CLEAR(v4l2_encoder_cmd, flags)),
1994 IOCTL_INFO_STD(VIDIOC_DECODER_CMD, vidioc_decoder_cmd, v4l_print_decoder_cmd, INFO_FL_PRIO),
1995 IOCTL_INFO_STD(VIDIOC_TRY_DECODER_CMD, vidioc_try_decoder_cmd, v4l_print_decoder_cmd, 0),
1996 IOCTL_INFO_FNC(VIDIOC_DBG_S_REGISTER, v4l_dbg_s_register, v4l_print_dbg_register, 0),
1997 IOCTL_INFO_FNC(VIDIOC_DBG_G_REGISTER, v4l_dbg_g_register, v4l_print_dbg_register, 0),
1998 IOCTL_INFO_FNC(VIDIOC_DBG_G_CHIP_IDENT, v4l_dbg_g_chip_ident, v4l_print_dbg_chip_ident, 0),
1999 IOCTL_INFO_FNC(VIDIOC_S_HW_FREQ_SEEK, v4l_s_hw_freq_seek, v4l_print_hw_freq_seek, INFO_FL_PRIO),
2000 IOCTL_INFO_STD(VIDIOC_ENUM_DV_PRESETS, vidioc_enum_dv_presets, v4l_print_dv_enum_presets, 0),
2001 IOCTL_INFO_STD(VIDIOC_S_DV_PRESET, vidioc_s_dv_preset, v4l_print_dv_preset, INFO_FL_PRIO),
2002 IOCTL_INFO_STD(VIDIOC_G_DV_PRESET, vidioc_g_dv_preset, v4l_print_dv_preset, 0),
2003 IOCTL_INFO_STD(VIDIOC_QUERY_DV_PRESET, vidioc_query_dv_preset, v4l_print_dv_preset, 0),
2004 IOCTL_INFO_STD(VIDIOC_S_DV_TIMINGS, vidioc_s_dv_timings, v4l_print_dv_timings, INFO_FL_PRIO),
2005 IOCTL_INFO_STD(VIDIOC_G_DV_TIMINGS, vidioc_g_dv_timings, v4l_print_dv_timings, 0),
2006 IOCTL_INFO_FNC(VIDIOC_DQEVENT, v4l_dqevent, v4l_print_event, 0),
2007 IOCTL_INFO_FNC(VIDIOC_SUBSCRIBE_EVENT, v4l_subscribe_event, v4l_print_event_subscription, 0),
2008 IOCTL_INFO_FNC(VIDIOC_UNSUBSCRIBE_EVENT, v4l_unsubscribe_event, v4l_print_event_subscription, 0),
2009 IOCTL_INFO_FNC(VIDIOC_CREATE_BUFS, v4l_create_bufs, v4l_print_create_buffers, INFO_FL_PRIO | INFO_FL_QUEUE),
2010 IOCTL_INFO_FNC(VIDIOC_PREPARE_BUF, v4l_prepare_buf, v4l_print_buffer, INFO_FL_QUEUE),
2011 IOCTL_INFO_STD(VIDIOC_ENUM_DV_TIMINGS, vidioc_enum_dv_timings, v4l_print_enum_dv_timings, 0),
2012 IOCTL_INFO_STD(VIDIOC_QUERY_DV_TIMINGS, vidioc_query_dv_timings, v4l_print_dv_timings, 0),
2013 IOCTL_INFO_STD(VIDIOC_DV_TIMINGS_CAP, vidioc_dv_timings_cap, v4l_print_dv_timings_cap, INFO_FL_CLEAR(v4l2_dv_timings_cap, type)),
2014 IOCTL_INFO_FNC(VIDIOC_ENUM_FREQ_BANDS, v4l_enum_freq_bands, v4l_print_freq_band, 0),
2016 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
2018 bool v4l2_is_known_ioctl(unsigned int cmd)
2020 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2022 return v4l2_ioctls[_IOC_NR(cmd)].ioctl == cmd;
2025 struct mutex *v4l2_ioctl_get_lock(struct video_device *vdev, unsigned cmd)
2027 if (_IOC_NR(cmd) >= V4L2_IOCTLS)
2029 if (test_bit(_IOC_NR(cmd), vdev->disable_locking))
2031 if (vdev->queue && vdev->queue->lock &&
2032 (v4l2_ioctls[_IOC_NR(cmd)].flags & INFO_FL_QUEUE))
2033 return vdev->queue->lock;
2037 /* Common ioctl debug function. This function can be used by
2038 external ioctl messages as well as internal V4L ioctl */
2039 void v4l_printk_ioctl(const char *prefix, unsigned int cmd)
2041 const char *dir, *type;
2044 printk(KERN_DEBUG "%s: ", prefix);
2046 switch (_IOC_TYPE(cmd)) {
2051 if (_IOC_NR(cmd) >= V4L2_IOCTLS) {
2055 pr_cont("%s", v4l2_ioctls[_IOC_NR(cmd)].name);
2062 switch (_IOC_DIR(cmd)) {
2063 case _IOC_NONE: dir = "--"; break;
2064 case _IOC_READ: dir = "r-"; break;
2065 case _IOC_WRITE: dir = "-w"; break;
2066 case _IOC_READ | _IOC_WRITE: dir = "rw"; break;
2067 default: dir = "*ERR*"; break;
2069 pr_cont("%s ioctl '%c', dir=%s, #%d (0x%08x)",
2070 type, _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
2072 EXPORT_SYMBOL(v4l_printk_ioctl);
2074 static long __video_do_ioctl(struct file *file,
2075 unsigned int cmd, void *arg)
2077 struct video_device *vfd = video_devdata(file);
2078 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
2079 bool write_only = false;
2080 struct v4l2_ioctl_info default_info;
2081 const struct v4l2_ioctl_info *info;
2082 void *fh = file->private_data;
2083 struct v4l2_fh *vfh = NULL;
2084 int use_fh_prio = 0;
2085 int debug = vfd->debug;
2089 pr_warn("%s: has no ioctl_ops.\n",
2090 video_device_node_name(vfd));
2094 if (test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags)) {
2095 vfh = file->private_data;
2096 use_fh_prio = test_bit(V4L2_FL_USE_FH_PRIO, &vfd->flags);
2099 if (v4l2_is_known_ioctl(cmd)) {
2100 info = &v4l2_ioctls[_IOC_NR(cmd)];
2102 if (!test_bit(_IOC_NR(cmd), vfd->valid_ioctls) &&
2103 !((info->flags & INFO_FL_CTRL) && vfh && vfh->ctrl_handler))
2106 if (use_fh_prio && (info->flags & INFO_FL_PRIO)) {
2107 ret = v4l2_prio_check(vfd->prio, vfh->prio);
2112 default_info.ioctl = cmd;
2113 default_info.flags = 0;
2114 default_info.debug = v4l_print_default;
2115 info = &default_info;
2118 write_only = _IOC_DIR(cmd) == _IOC_WRITE;
2119 if (write_only && debug > V4L2_DEBUG_IOCTL) {
2120 v4l_printk_ioctl(video_device_node_name(vfd), cmd);
2122 info->debug(arg, write_only);
2124 if (info->flags & INFO_FL_STD) {
2125 typedef int (*vidioc_op)(struct file *file, void *fh, void *p);
2126 const void *p = vfd->ioctl_ops;
2127 const vidioc_op *vidioc = p + info->u.offset;
2129 ret = (*vidioc)(file, fh, arg);
2130 } else if (info->flags & INFO_FL_FUNC) {
2131 ret = info->u.func(ops, file, fh, arg);
2132 } else if (!ops->vidioc_default) {
2135 ret = ops->vidioc_default(file, fh,
2136 use_fh_prio ? v4l2_prio_check(vfd->prio, vfh->prio) >= 0 : 0,
2142 if (write_only && debug > V4L2_DEBUG_IOCTL) {
2144 printk(KERN_DEBUG "%s: error %ld\n",
2145 video_device_node_name(vfd), ret);
2148 v4l_printk_ioctl(video_device_node_name(vfd), cmd);
2150 pr_cont(": error %ld\n", ret);
2151 else if (debug == V4L2_DEBUG_IOCTL)
2153 else if (_IOC_DIR(cmd) == _IOC_NONE)
2154 info->debug(arg, write_only);
2157 info->debug(arg, write_only);
2164 static int check_array_args(unsigned int cmd, void *parg, size_t *array_size,
2165 void * __user *user_ptr, void ***kernel_ptr)
2170 case VIDIOC_QUERYBUF:
2172 case VIDIOC_DQBUF: {
2173 struct v4l2_buffer *buf = parg;
2175 if (V4L2_TYPE_IS_MULTIPLANAR(buf->type) && buf->length > 0) {
2176 if (buf->length > VIDEO_MAX_PLANES) {
2180 *user_ptr = (void __user *)buf->m.planes;
2181 *kernel_ptr = (void *)&buf->m.planes;
2182 *array_size = sizeof(struct v4l2_plane) * buf->length;
2188 case VIDIOC_S_EXT_CTRLS:
2189 case VIDIOC_G_EXT_CTRLS:
2190 case VIDIOC_TRY_EXT_CTRLS: {
2191 struct v4l2_ext_controls *ctrls = parg;
2193 if (ctrls->count != 0) {
2194 if (ctrls->count > V4L2_CID_MAX_CTRLS) {
2198 *user_ptr = (void __user *)ctrls->controls;
2199 *kernel_ptr = (void *)&ctrls->controls;
2200 *array_size = sizeof(struct v4l2_ext_control)
2212 video_usercopy(struct file *file, unsigned int cmd, unsigned long arg,
2217 void *parg = (void *)arg;
2219 bool has_array_args;
2220 size_t array_size = 0;
2221 void __user *user_ptr = NULL;
2222 void **kernel_ptr = NULL;
2224 /* Copy arguments into temp kernel buffer */
2225 if (_IOC_DIR(cmd) != _IOC_NONE) {
2226 if (_IOC_SIZE(cmd) <= sizeof(sbuf)) {
2229 /* too big to allocate from stack */
2230 mbuf = kmalloc(_IOC_SIZE(cmd), GFP_KERNEL);
2237 if (_IOC_DIR(cmd) & _IOC_WRITE) {
2238 unsigned int n = _IOC_SIZE(cmd);
2241 * In some cases, only a few fields are used as input,
2242 * i.e. when the app sets "index" and then the driver
2243 * fills in the rest of the structure for the thing
2244 * with that index. We only need to copy up the first
2247 if (v4l2_is_known_ioctl(cmd)) {
2248 u32 flags = v4l2_ioctls[_IOC_NR(cmd)].flags;
2249 if (flags & INFO_FL_CLEAR_MASK)
2250 n = (flags & INFO_FL_CLEAR_MASK) >> 16;
2253 if (copy_from_user(parg, (void __user *)arg, n))
2256 /* zero out anything we don't copy from userspace */
2257 if (n < _IOC_SIZE(cmd))
2258 memset((u8 *)parg + n, 0, _IOC_SIZE(cmd) - n);
2260 /* read-only ioctl */
2261 memset(parg, 0, _IOC_SIZE(cmd));
2265 err = check_array_args(cmd, parg, &array_size, &user_ptr, &kernel_ptr);
2268 has_array_args = err;
2270 if (has_array_args) {
2272 * When adding new types of array args, make sure that the
2273 * parent argument to ioctl (which contains the pointer to the
2274 * array) fits into sbuf (so that mbuf will still remain
2275 * unused up to here).
2277 mbuf = kmalloc(array_size, GFP_KERNEL);
2280 goto out_array_args;
2282 if (copy_from_user(mbuf, user_ptr, array_size))
2283 goto out_array_args;
2288 err = func(file, cmd, parg);
2289 if (err == -ENOIOCTLCMD)
2292 if (has_array_args) {
2293 *kernel_ptr = user_ptr;
2294 if (copy_to_user(user_ptr, mbuf, array_size))
2296 goto out_array_args;
2298 /* VIDIOC_QUERY_DV_TIMINGS can return an error, but still have valid
2299 results that must be returned. */
2300 if (err < 0 && cmd != VIDIOC_QUERY_DV_TIMINGS)
2304 /* Copy results into user buffer */
2305 switch (_IOC_DIR(cmd)) {
2307 case (_IOC_WRITE | _IOC_READ):
2308 if (copy_to_user((void __user *)arg, parg, _IOC_SIZE(cmd)))
2317 EXPORT_SYMBOL(video_usercopy);
2319 long video_ioctl2(struct file *file,
2320 unsigned int cmd, unsigned long arg)
2322 return video_usercopy(file, cmd, arg, __video_do_ioctl);
2324 EXPORT_SYMBOL(video_ioctl2);