Quelle  v4l2-ioctl.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * Video capture interface for Linux version 2
 *
 * A generic framework to process V4L2 ioctl commands.
 *
 * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1)
 *              Mauro Carvalho Chehab <mchehab@kernel.org> (version 2)
 */

#include <linux/compat.h>
#include <linux/mm.h>
#include <linux/module.h>
#include <linux/slab.h>
#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/version.h>

#include <linux/v4l2-subdev.h>
#include <linux/videodev2.h>

#include <media/media-device.h> /* for media_set_bus_info() */
#include <media/v4l2-common.h>
#include <media/v4l2-ioctl.h>
#include <media/v4l2-ctrls.h>
#include <media/v4l2-fh.h>
#include <media/v4l2-event.h>
#include <media/v4l2-device.h>
#include <media/videobuf2-v4l2.h>
#include <media/v4l2-mc.h>
#include <media/v4l2-mem2mem.h>

#include <trace/events/v4l2.h>

#define is_valid_ioctl(vfd, cmd) test_bit(_IOC_NR(cmd), (vfd)->valid_ioctls)

struct std_descr {
 v4l2_std_id std;
 const char *descr;
};

static const struct std_descr standards[] = {
 { V4L2_STD_NTSC, "NTSC"      },
 { V4L2_STD_NTSC_M, "NTSC-M"    },
 { V4L2_STD_NTSC_M_JP, "NTSC-M-JP" },
 { V4L2_STD_NTSC_M_KR, "NTSC-M-KR" },
 { V4L2_STD_NTSC_443, "NTSC-443"  },
 { V4L2_STD_PAL,  "PAL"       },
 { V4L2_STD_PAL_BG, "PAL-BG"    },
 { V4L2_STD_PAL_B, "PAL-B"     },
 { V4L2_STD_PAL_B1, "PAL-B1"    },
 { V4L2_STD_PAL_G, "PAL-G"     },
 { V4L2_STD_PAL_H, "PAL-H"     },
 { V4L2_STD_PAL_I, "PAL-I"     },
 { V4L2_STD_PAL_DK, "PAL-DK"    },
 { V4L2_STD_PAL_D, "PAL-D"     },
 { V4L2_STD_PAL_D1, "PAL-D1"    },
 { V4L2_STD_PAL_K, "PAL-K"     },
 { V4L2_STD_PAL_M, "PAL-M"     },
 { V4L2_STD_PAL_N, "PAL-N"     },
 { V4L2_STD_PAL_Nc, "PAL-Nc"    },
 { V4L2_STD_PAL_60, "PAL-60"    },
 { V4L2_STD_SECAM, "SECAM"     },
 { V4L2_STD_SECAM_B, "SECAM-B"   },
 { V4L2_STD_SECAM_G, "SECAM-G"   },
 { V4L2_STD_SECAM_H, "SECAM-H"   },
 { V4L2_STD_SECAM_DK, "SECAM-DK"  },
 { V4L2_STD_SECAM_D, "SECAM-D"   },
 { V4L2_STD_SECAM_K, "SECAM-K"   },
 { V4L2_STD_SECAM_K1, "SECAM-K1"  },
 { V4L2_STD_SECAM_L, "SECAM-L"   },
 { V4L2_STD_SECAM_LC, "SECAM-Lc"  },
 { 0,   "Unknown"   }
};

/* video4linux standard ID conversion to standard name
 */
const char *v4l2_norm_to_name(v4l2_std_id id)
{
 u32 myid = id;
 int i;

 /* HACK: ppc32 architecture doesn't have __ucmpdi2 function to handle
   64 bit comparisons. So, on that architecture, with some gcc
   variants, compilation fails. Currently, the max value is 30bit wide.
 */
 BUG_ON(myid != id);

 for (i = 0; standards[i].std; i++)
  if (myid == standards[i].std)
   break;
 return standards[i].descr;
}
EXPORT_SYMBOL(v4l2_norm_to_name);

/* Returns frame period for the given standard */
void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod)
{
 if (id & V4L2_STD_525_60) {
  frameperiod->numerator = 1001;
  frameperiod->denominator = 30000;
 } else {
  frameperiod->numerator = 1;
  frameperiod->denominator = 25;
 }
}
EXPORT_SYMBOL(v4l2_video_std_frame_period);

/* Fill in the fields of a v4l2_standard structure according to the
   'id' and 'transmission' parameters.  Returns negative on error.  */
int v4l2_video_std_construct(struct v4l2_standard *vs,
        int id, const char *name)
{
 vs->id = id;
 v4l2_video_std_frame_period(id, &vs->frameperiod);
 vs->framelines = (id & V4L2_STD_525_60) ? 525 : 625;
 strscpy(vs->name, name, sizeof(vs->name));
 return 0;
}
EXPORT_SYMBOL(v4l2_video_std_construct);

/* Fill in the fields of a v4l2_standard structure according to the
 * 'id' and 'vs->index' parameters. Returns negative on error. */
int v4l_video_std_enumstd(struct v4l2_standard *vs, v4l2_std_id id)
{
 v4l2_std_id curr_id = 0;
 unsigned int index = vs->index, i, j = 0;
 const char *descr = "";

 /* Return -ENODATA if the id for the current input
   or output is 0, meaning that it doesn't support this API. */
 if (id == 0)
  return -ENODATA;

 /* Return norm array in a canonical way */
 for (i = 0; i <= index && id; i++) {
  /* last std value in the standards array is 0, so this
   while always ends there since (id & 0) == 0. */
  while ((id & standards[j].std) != standards[j].std)
   j++;
  curr_id = standards[j].std;
  descr = standards[j].descr;
  j++;
  if (curr_id == 0)
   break;
  if (curr_id != V4L2_STD_PAL &&
    curr_id != V4L2_STD_SECAM &&
    curr_id != V4L2_STD_NTSC)
   id &= ~curr_id;
 }
 if (i <= index)
  return -EINVAL;

 v4l2_video_std_construct(vs, curr_id, descr);
 return 0;
}

/* ----------------------------------------------------------------- */
/* some arrays for pretty-printing debug messages of enum types      */

const char *v4l2_field_names[] = {
 [V4L2_FIELD_ANY]        = "any",
 [V4L2_FIELD_NONE]       = "none",
 [V4L2_FIELD_TOP]        = "top",
 [V4L2_FIELD_BOTTOM]     = "bottom",
 [V4L2_FIELD_INTERLACED] = "interlaced",
 [V4L2_FIELD_SEQ_TB]     = "seq-tb",
 [V4L2_FIELD_SEQ_BT]     = "seq-bt",
 [V4L2_FIELD_ALTERNATE]  = "alternate",
 [V4L2_FIELD_INTERLACED_TB] = "interlaced-tb",
 [V4L2_FIELD_INTERLACED_BT] = "interlaced-bt",
};
EXPORT_SYMBOL(v4l2_field_names);

const char *v4l2_type_names[] = {
 [0]       = "0",
 [V4L2_BUF_TYPE_VIDEO_CAPTURE]      = "vid-cap",
 [V4L2_BUF_TYPE_VIDEO_OVERLAY]      = "vid-overlay",
 [V4L2_BUF_TYPE_VIDEO_OUTPUT]       = "vid-out",
 [V4L2_BUF_TYPE_VBI_CAPTURE]        = "vbi-cap",
 [V4L2_BUF_TYPE_VBI_OUTPUT]         = "vbi-out",
 [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
 [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT]  = "sliced-vbi-out",
 [V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY] = "vid-out-overlay",
 [V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE] = "vid-cap-mplane",
 [V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE] = "vid-out-mplane",
 [V4L2_BUF_TYPE_SDR_CAPTURE]        = "sdr-cap",
 [V4L2_BUF_TYPE_SDR_OUTPUT]         = "sdr-out",
 [V4L2_BUF_TYPE_META_CAPTURE]       = "meta-cap",
 [V4L2_BUF_TYPE_META_OUTPUT]    = "meta-out",
};
EXPORT_SYMBOL(v4l2_type_names);

static const char *v4l2_memory_names[] = {
 [V4L2_MEMORY_MMAP]    = "mmap",
 [V4L2_MEMORY_USERPTR] = "userptr",
 [V4L2_MEMORY_OVERLAY] = "overlay",
 [V4L2_MEMORY_DMABUF] = "dmabuf",
};

#define prt_names(a, arr) (((unsigned)(a)) < ARRAY_SIZE(arr) ? arr[a] : "unknown")

/* ------------------------------------------------------------------ */
/* debug help functions                                               */

static void v4l_print_querycap(const void *arg, bool write_only)
{
 const struct v4l2_capability *p = arg;

 pr_cont("driver=%.*s, card=%.*s, bus=%.*s, version=0x%08x, capabilities=0x%08x, device_caps=0x%08x\n",
  (int)sizeof(p->driver), p->driver,
  (int)sizeof(p->card), p->card,
  (int)sizeof(p->bus_info), p->bus_info,
  p->version, p->capabilities, p->device_caps);
}

static void v4l_print_enuminput(const void *arg, bool write_only)
{
 const struct v4l2_input *p = arg;

 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, tuner=%u, std=0x%08Lx, status=0x%x, capabilities=0x%x\n",
  p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
  p->tuner, (unsigned long long)p->std, p->status,
  p->capabilities);
}

static void v4l_print_enumoutput(const void *arg, bool write_only)
{
 const struct v4l2_output *p = arg;

 pr_cont("index=%u, name=%.*s, type=%u, audioset=0x%x, modulator=%u, std=0x%08Lx, capabilities=0x%x\n",
  p->index, (int)sizeof(p->name), p->name, p->type, p->audioset,
  p->modulator, (unsigned long long)p->std, p->capabilities);
}

static void v4l_print_audio(const void *arg, bool write_only)
{
 const struct v4l2_audio *p = arg;

 if (write_only)
  pr_cont("index=%u, mode=0x%x\n", p->index, p->mode);
 else
  pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
   p->index, (int)sizeof(p->name), p->name,
   p->capability, p->mode);
}

static void v4l_print_audioout(const void *arg, bool write_only)
{
 const struct v4l2_audioout *p = arg;

 if (write_only)
  pr_cont("index=%u\n", p->index);
 else
  pr_cont("index=%u, name=%.*s, capability=0x%x, mode=0x%x\n",
   p->index, (int)sizeof(p->name), p->name,
   p->capability, p->mode);
}

static void v4l_print_fmtdesc(const void *arg, bool write_only)
{
 const struct v4l2_fmtdesc *p = arg;

 pr_cont("index=%u, type=%s, flags=0x%x, pixelformat=%p4cc, mbus_code=0x%04x, description='%.*s'\n",
  p->index, prt_names(p->type, v4l2_type_names),
  p->flags, &p->pixelformat, p->mbus_code,
  (int)sizeof(p->description), p->description);
}

static void v4l_print_format(const void *arg, bool write_only)
{
 const struct v4l2_format *p = arg;
 const struct v4l2_pix_format *pix;
 const struct v4l2_pix_format_mplane *mp;
 const struct v4l2_vbi_format *vbi;
 const struct v4l2_sliced_vbi_format *sliced;
 const struct v4l2_window *win;
 const struct v4l2_meta_format *meta;
 u32 pixelformat;
 u32 planes;
 unsigned i;

 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));
 switch (p->type) {
 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
  pix = &p->fmt.pix;
  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",
   pix->width, pix->height, &pix->pixelformat,
   prt_names(pix->field, v4l2_field_names),
   pix->bytesperline, pix->sizeimage,
   pix->colorspace, pix->flags, pix->ycbcr_enc,
   pix->quantization, pix->xfer_func);
  break;
 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
  mp = &p->fmt.pix_mp;
  pixelformat = mp->pixelformat;
  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",
   mp->width, mp->height, &pixelformat,
   prt_names(mp->field, v4l2_field_names),
   mp->colorspace, mp->num_planes, mp->flags,
   mp->ycbcr_enc, mp->quantization, mp->xfer_func);
  planes = min_t(u32, mp->num_planes, VIDEO_MAX_PLANES);
  for (i = 0; i < planes; i++)
   printk(KERN_DEBUG "plane %u: bytesperline=%u sizeimage=%u\n", i,
     mp->plane_fmt[i].bytesperline,
     mp->plane_fmt[i].sizeimage);
  break;
 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
  win = &p->fmt.win;
  pr_cont(", (%d,%d)/%ux%u, field=%s, chromakey=0x%08x, global_alpha=0x%02x\n",
   win->w.left, win->w.top, win->w.width, win->w.height,
   prt_names(win->field, v4l2_field_names),
   win->chromakey, win->global_alpha);
  break;
 case V4L2_BUF_TYPE_VBI_CAPTURE:
 case V4L2_BUF_TYPE_VBI_OUTPUT:
  vbi = &p->fmt.vbi;
  pr_cont(", sampling_rate=%u, offset=%u, samples_per_line=%u, sample_format=%p4cc, start=%u,%u, count=%u,%u\n",
   vbi->sampling_rate, vbi->offset,
   vbi->samples_per_line, &vbi->sample_format,
   vbi->start[0], vbi->start[1],
   vbi->count[0], vbi->count[1]);
  break;
 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
  sliced = &p->fmt.sliced;
  pr_cont(", service_set=0x%08x, io_size=%d\n",
    sliced->service_set, sliced->io_size);
  for (i = 0; i < 24; i++)
   printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
    sliced->service_lines[0][i],
    sliced->service_lines[1][i]);
  break;
 case V4L2_BUF_TYPE_SDR_CAPTURE:
 case V4L2_BUF_TYPE_SDR_OUTPUT:
  pixelformat = p->fmt.sdr.pixelformat;
  pr_cont(", pixelformat=%p4cc\n", &pixelformat);
  break;
 case V4L2_BUF_TYPE_META_CAPTURE:
 case V4L2_BUF_TYPE_META_OUTPUT:
  meta = &p->fmt.meta;
  pixelformat = meta->dataformat;
  pr_cont(", dataformat=%p4cc, buffersize=%u, width=%u, height=%u, bytesperline=%u\n",
   &pixelformat, meta->buffersize, meta->width,
   meta->height, meta->bytesperline);
  break;
 }
}

static void v4l_print_framebuffer(const void *arg, bool write_only)
{
 const struct v4l2_framebuffer *p = arg;

 pr_cont("capability=0x%x, flags=0x%x, base=0x%p, width=%u, height=%u, pixelformat=%p4cc, bytesperline=%u, sizeimage=%u, colorspace=%d\n",
  p->capability, p->flags, p->base, p->fmt.width, p->fmt.height,
  &p->fmt.pixelformat, p->fmt.bytesperline, p->fmt.sizeimage,
  p->fmt.colorspace);
}

static void v4l_print_buftype(const void *arg, bool write_only)
{
 pr_cont("type=%s\n", prt_names(*(u32 *)arg, v4l2_type_names));
}

static void v4l_print_modulator(const void *arg, bool write_only)
{
 const struct v4l2_modulator *p = arg;

 if (write_only)
  pr_cont("index=%u, txsubchans=0x%x\n", p->index, p->txsubchans);
 else
  pr_cont("index=%u, name=%.*s, capability=0x%x, rangelow=%u, rangehigh=%u, txsubchans=0x%x\n",
   p->index, (int)sizeof(p->name), p->name, p->capability,
   p->rangelow, p->rangehigh, p->txsubchans);
}

static void v4l_print_tuner(const void *arg, bool write_only)
{
 const struct v4l2_tuner *p = arg;

 if (write_only)
  pr_cont("index=%u, audmode=%u\n", p->index, p->audmode);
 else
  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",
   p->index, (int)sizeof(p->name), p->name, p->type,
   p->capability, p->rangelow,
   p->rangehigh, p->signal, p->afc,
   p->rxsubchans, p->audmode);
}

static void v4l_print_frequency(const void *arg, bool write_only)
{
 const struct v4l2_frequency *p = arg;

 pr_cont("tuner=%u, type=%u, frequency=%u\n",
    p->tuner, p->type, p->frequency);
}

static void v4l_print_standard(const void *arg, bool write_only)
{
 const struct v4l2_standard *p = arg;

 pr_cont("index=%u, id=0x%Lx, name=%.*s, fps=%u/%u, framelines=%u\n",
  p->index,
  (unsigned long long)p->id, (int)sizeof(p->name), p->name,
  p->frameperiod.numerator,
  p->frameperiod.denominator,
  p->framelines);
}

static void v4l_print_std(const void *arg, bool write_only)
{
 pr_cont("std=0x%08Lx\n", *(const long long unsigned *)arg);
}

static void v4l_print_hw_freq_seek(const void *arg, bool write_only)
{
 const struct v4l2_hw_freq_seek *p = arg;

 pr_cont("tuner=%u, type=%u, seek_upward=%u, wrap_around=%u, spacing=%u, rangelow=%u, rangehigh=%u\n",
  p->tuner, p->type, p->seek_upward, p->wrap_around, p->spacing,
  p->rangelow, p->rangehigh);
}

static void v4l_print_requestbuffers(const void *arg, bool write_only)
{
 const struct v4l2_requestbuffers *p = arg;

 pr_cont("count=%d, type=%s, memory=%s\n",
  p->count,
  prt_names(p->type, v4l2_type_names),
  prt_names(p->memory, v4l2_memory_names));
}

static void v4l_print_buffer(const void *arg, bool write_only)
{
 const struct v4l2_buffer *p = arg;
 const struct v4l2_timecode *tc = &p->timecode;
 const struct v4l2_plane *plane;
 int i;

 pr_cont("%02d:%02d:%02d.%06ld index=%d, type=%s, request_fd=%d, flags=0x%08x, field=%s, sequence=%d, memory=%s",
   (int)p->timestamp.tv_sec / 3600,
   ((int)p->timestamp.tv_sec / 60) % 60,
   ((int)p->timestamp.tv_sec % 60),
   (long)p->timestamp.tv_usec,
   p->index,
   prt_names(p->type, v4l2_type_names), p->request_fd,
   p->flags, prt_names(p->field, v4l2_field_names),
   p->sequence, prt_names(p->memory, v4l2_memory_names));

 if (V4L2_TYPE_IS_MULTIPLANAR(p->type) && p->m.planes) {
  pr_cont("\n");
  for (i = 0; i < p->length; ++i) {
   plane = &p->m.planes[i];
   printk(KERN_DEBUG
    "plane %d: bytesused=%d, data_offset=0x%08x, offset/userptr=0x%lx, length=%d\n",
    i, plane->bytesused, plane->data_offset,
    plane->m.userptr, plane->length);
  }
 } else {
  pr_cont(", bytesused=%d, offset/userptr=0x%lx, length=%d\n",
   p->bytesused, p->m.userptr, p->length);
 }

 printk(KERN_DEBUG "timecode=%02d:%02d:%02d type=%d, flags=0x%08x, frames=%d, userbits=0x%08x\n",
   tc->hours, tc->minutes, tc->seconds,
   tc->type, tc->flags, tc->frames, *(__u32 *)tc->userbits);
}

static void v4l_print_exportbuffer(const void *arg, bool write_only)
{
 const struct v4l2_exportbuffer *p = arg;

 pr_cont("fd=%d, type=%s, index=%u, plane=%u, flags=0x%08x\n",
  p->fd, prt_names(p->type, v4l2_type_names),
  p->index, p->plane, p->flags);
}

static void v4l_print_create_buffers(const void *arg, bool write_only)
{
 const struct v4l2_create_buffers *p = arg;

 pr_cont("index=%d, count=%d, memory=%s, capabilities=0x%08x, max num buffers=%u, ",
  p->index, p->count, prt_names(p->memory, v4l2_memory_names),
  p->capabilities, p->max_num_buffers);
 v4l_print_format(&p->format, write_only);
}

static void v4l_print_remove_buffers(const void *arg, bool write_only)
{
 const struct v4l2_remove_buffers *p = arg;

 pr_cont("type=%s, index=%u, count=%u\n",
  prt_names(p->type, v4l2_type_names), p->index, p->count);
}

static void v4l_print_streamparm(const void *arg, bool write_only)
{
 const struct v4l2_streamparm *p = arg;

 pr_cont("type=%s", prt_names(p->type, v4l2_type_names));

 if (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
     p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE) {
  const struct v4l2_captureparm *c = &p->parm.capture;

  pr_cont(", capability=0x%x, capturemode=0x%x, timeperframe=%d/%d, extendedmode=%d, readbuffers=%d\n",
   c->capability, c->capturemode,
   c->timeperframe.numerator, c->timeperframe.denominator,
   c->extendedmode, c->readbuffers);
 } else if (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT ||
     p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
  const struct v4l2_outputparm *c = &p->parm.output;

  pr_cont(", capability=0x%x, outputmode=0x%x, timeperframe=%d/%d, extendedmode=%d, writebuffers=%d\n",
   c->capability, c->outputmode,
   c->timeperframe.numerator, c->timeperframe.denominator,
   c->extendedmode, c->writebuffers);
 } else {
  pr_cont("\n");
 }
}

static void v4l_print_queryctrl(const void *arg, bool write_only)
{
 const struct v4l2_queryctrl *p = arg;

 pr_cont("id=0x%x, type=%d, name=%.*s, min/max=%d/%d, step=%d, default=%d, flags=0x%08x\n",
   p->id, p->type, (int)sizeof(p->name), p->name,
   p->minimum, p->maximum,
   p->step, p->default_value, p->flags);
}

static void v4l_print_query_ext_ctrl(const void *arg, bool write_only)
{
 const struct v4l2_query_ext_ctrl *p = arg;

 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",
   p->id, p->type, (int)sizeof(p->name), p->name,
   p->minimum, p->maximum,
   p->step, p->default_value, p->flags,
   p->elem_size, p->elems, p->nr_of_dims,
   p->dims[0], p->dims[1], p->dims[2], p->dims[3]);
}

static void v4l_print_querymenu(const void *arg, bool write_only)
{
 const struct v4l2_querymenu *p = arg;

 pr_cont("id=0x%x, index=%d\n", p->id, p->index);
}

static void v4l_print_control(const void *arg, bool write_only)
{
 const struct v4l2_control *p = arg;
 const char *name = v4l2_ctrl_get_name(p->id);

 if (name)
  pr_cont("name=%s, ", name);
 pr_cont("id=0x%x, value=%d\n", p->id, p->value);
}

static void v4l_print_ext_controls(const void *arg, bool write_only)
{
 const struct v4l2_ext_controls *p = arg;
 int i;

 pr_cont("which=0x%x, count=%d, error_idx=%d, request_fd=%d",
   p->which, p->count, p->error_idx, p->request_fd);
 for (i = 0; i < p->count; i++) {
  unsigned int id = p->controls[i].id;
  const char *name = v4l2_ctrl_get_name(id);

  if (name)
   pr_cont(", name=%s", name);
  if (!p->controls[i].size)
   pr_cont(", id/val=0x%x/0x%x", id, p->controls[i].value);
  else
   pr_cont(", id/size=0x%x/%u", id, p->controls[i].size);
 }
 pr_cont("\n");
}

static void v4l_print_cropcap(const void *arg, bool write_only)
{
 const struct v4l2_cropcap *p = arg;

 pr_cont("type=%s, bounds (%d,%d)/%ux%u, defrect (%d,%d)/%ux%u, pixelaspect %d/%d\n",
  prt_names(p->type, v4l2_type_names),
  p->bounds.left, p->bounds.top,
  p->bounds.width, p->bounds.height,
  p->defrect.left, p->defrect.top,
  p->defrect.width, p->defrect.height,
  p->pixelaspect.numerator, p->pixelaspect.denominator);
}

static void v4l_print_crop(const void *arg, bool write_only)
{
 const struct v4l2_crop *p = arg;

 pr_cont("type=%s, crop=(%d,%d)/%ux%u\n",
  prt_names(p->type, v4l2_type_names),
  p->c.left, p->c.top,
  p->c.width, p->c.height);
}

static void v4l_print_selection(const void *arg, bool write_only)
{
 const struct v4l2_selection *p = arg;

 pr_cont("type=%s, target=%d, flags=0x%x, rect=(%d,%d)/%ux%u\n",
  prt_names(p->type, v4l2_type_names),
  p->target, p->flags,
  p->r.left, p->r.top, p->r.width, p->r.height);
}

static void v4l_print_jpegcompression(const void *arg, bool write_only)
{
 const struct v4l2_jpegcompression *p = arg;

 pr_cont("quality=%d, APPn=%d, APP_len=%d, COM_len=%d, jpeg_markers=0x%x\n",
  p->quality, p->APPn, p->APP_len,
  p->COM_len, p->jpeg_markers);
}

static void v4l_print_enc_idx(const void *arg, bool write_only)
{
 const struct v4l2_enc_idx *p = arg;

 pr_cont("entries=%d, entries_cap=%d\n",
   p->entries, p->entries_cap);
}

static void v4l_print_encoder_cmd(const void *arg, bool write_only)
{
 const struct v4l2_encoder_cmd *p = arg;

 pr_cont("cmd=%d, flags=0x%x\n",
   p->cmd, p->flags);
}

static void v4l_print_decoder_cmd(const void *arg, bool write_only)
{
 const struct v4l2_decoder_cmd *p = arg;

 pr_cont("cmd=%d, flags=0x%x\n", p->cmd, p->flags);

 if (p->cmd == V4L2_DEC_CMD_START)
  pr_info("speed=%d, format=%u\n",
    p->start.speed, p->start.format);
 else if (p->cmd == V4L2_DEC_CMD_STOP)
  pr_info("pts=%llu\n", p->stop.pts);
}

static void v4l_print_dbg_chip_info(const void *arg, bool write_only)
{
 const struct v4l2_dbg_chip_info *p = arg;

 pr_cont("type=%u, ", p->match.type);
 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
  pr_cont("name=%.*s, ",
    (int)sizeof(p->match.name), p->match.name);
 else
  pr_cont("addr=%u, ", p->match.addr);
 pr_cont("name=%.*s\n", (int)sizeof(p->name), p->name);
}

static void v4l_print_dbg_register(const void *arg, bool write_only)
{
 const struct v4l2_dbg_register *p = arg;

 pr_cont("type=%u, ", p->match.type);
 if (p->match.type == V4L2_CHIP_MATCH_I2C_DRIVER)
  pr_cont("name=%.*s, ",
    (int)sizeof(p->match.name), p->match.name);
 else
  pr_cont("addr=%u, ", p->match.addr);
 pr_cont("reg=0x%llx, val=0x%llx\n",
   p->reg, p->val);
}

static void v4l_print_dv_timings(const void *arg, bool write_only)
{
 const struct v4l2_dv_timings *p = arg;

 switch (p->type) {
 case V4L2_DV_BT_656_1120:
  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",
    p->bt.interlaced, p->bt.pixelclock,
    p->bt.width, p->bt.height,
    p->bt.polarities, p->bt.hfrontporch,
    p->bt.hsync, p->bt.hbackporch,
    p->bt.vfrontporch, p->bt.vsync,
    p->bt.vbackporch, p->bt.il_vfrontporch,
    p->bt.il_vsync, p->bt.il_vbackporch,
    p->bt.standards, p->bt.flags);
  break;
 default:
  pr_cont("type=%d\n", p->type);
  break;
 }
}

static void v4l_print_enum_dv_timings(const void *arg, bool write_only)
{
 const struct v4l2_enum_dv_timings *p = arg;

 pr_cont("index=%u, ", p->index);
 v4l_print_dv_timings(&p->timings, write_only);
}

static void v4l_print_dv_timings_cap(const void *arg, bool write_only)
{
 const struct v4l2_dv_timings_cap *p = arg;

 switch (p->type) {
 case V4L2_DV_BT_656_1120:
  pr_cont("type=bt-656/1120, width=%u-%u, height=%u-%u, pixelclock=%llu-%llu, standards=0x%x, capabilities=0x%x\n",
   p->bt.min_width, p->bt.max_width,
   p->bt.min_height, p->bt.max_height,
   p->bt.min_pixelclock, p->bt.max_pixelclock,
   p->bt.standards, p->bt.capabilities);
  break;
 default:
  pr_cont("type=%u\n", p->type);
  break;
 }
}

static void v4l_print_frmsizeenum(const void *arg, bool write_only)
{
 const struct v4l2_frmsizeenum *p = arg;

 pr_cont("index=%u, pixelformat=%p4cc, type=%u",
  p->index, &p->pixel_format, p->type);
 switch (p->type) {
 case V4L2_FRMSIZE_TYPE_DISCRETE:
  pr_cont(", wxh=%ux%u\n",
   p->discrete.width, p->discrete.height);
  break;
 case V4L2_FRMSIZE_TYPE_STEPWISE:
  pr_cont(", min=%ux%u, max=%ux%u, step=%ux%u\n",
    p->stepwise.min_width,
    p->stepwise.min_height,
    p->stepwise.max_width,
    p->stepwise.max_height,
    p->stepwise.step_width,
    p->stepwise.step_height);
  break;
 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
 default:
  pr_cont("\n");
  break;
 }
}

static void v4l_print_frmivalenum(const void *arg, bool write_only)
{
 const struct v4l2_frmivalenum *p = arg;

 pr_cont("index=%u, pixelformat=%p4cc, wxh=%ux%u, type=%u",
  p->index, &p->pixel_format, p->width, p->height, p->type);
 switch (p->type) {
 case V4L2_FRMIVAL_TYPE_DISCRETE:
  pr_cont(", fps=%d/%d\n",
    p->discrete.numerator,
    p->discrete.denominator);
  break;
 case V4L2_FRMIVAL_TYPE_STEPWISE:
  pr_cont(", min=%d/%d, max=%d/%d, step=%d/%d\n",
    p->stepwise.min.numerator,
    p->stepwise.min.denominator,
    p->stepwise.max.numerator,
    p->stepwise.max.denominator,
    p->stepwise.step.numerator,
    p->stepwise.step.denominator);
  break;
 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
 default:
  pr_cont("\n");
  break;
 }
}

static void v4l_print_event(const void *arg, bool write_only)
{
 const struct v4l2_event *p = arg;
 const struct v4l2_event_ctrl *c;

 pr_cont("type=0x%x, pending=%u, sequence=%u, id=%u, timestamp=%llu.%9.9llu\n",
   p->type, p->pending, p->sequence, p->id,
   p->timestamp.tv_sec, p->timestamp.tv_nsec);
 switch (p->type) {
 case V4L2_EVENT_VSYNC:
  printk(KERN_DEBUG "field=%s\n",
   prt_names(p->u.vsync.field, v4l2_field_names));
  break;
 case V4L2_EVENT_CTRL:
  c = &p->u.ctrl;
  printk(KERN_DEBUG "changes=0x%x, type=%u, ",
   c->changes, c->type);
  if (c->type == V4L2_CTRL_TYPE_INTEGER64)
   pr_cont("value64=%lld, ", c->value64);
  else
   pr_cont("value=%d, ", c->value);
  pr_cont("flags=0x%x, minimum=%d, maximum=%d, step=%d, default_value=%d\n",
   c->flags, c->minimum, c->maximum,
   c->step, c->default_value);
  break;
 case V4L2_EVENT_FRAME_SYNC:
  pr_cont("frame_sequence=%u\n",
   p->u.frame_sync.frame_sequence);
  break;
 }
}

static void v4l_print_event_subscription(const void *arg, bool write_only)
{
 const struct v4l2_event_subscription *p = arg;

 pr_cont("type=0x%x, id=0x%x, flags=0x%x\n",
   p->type, p->id, p->flags);
}

static void v4l_print_sliced_vbi_cap(const void *arg, bool write_only)
{
 const struct v4l2_sliced_vbi_cap *p = arg;
 int i;

 pr_cont("type=%s, service_set=0x%08x\n",
   prt_names(p->type, v4l2_type_names), p->service_set);
 for (i = 0; i < 24; i++)
  printk(KERN_DEBUG "line[%02u]=0x%04x, 0x%04x\n", i,
    p->service_lines[0][i],
    p->service_lines[1][i]);
}

static void v4l_print_freq_band(const void *arg, bool write_only)
{
 const struct v4l2_frequency_band *p = arg;

 pr_cont("tuner=%u, type=%u, index=%u, capability=0x%x, rangelow=%u, rangehigh=%u, modulation=0x%x\n",
   p->tuner, p->type, p->index,
   p->capability, p->rangelow,
   p->rangehigh, p->modulation);
}

static void v4l_print_edid(const void *arg, bool write_only)
{
 const struct v4l2_edid *p = arg;

 pr_cont("pad=%u, start_block=%u, blocks=%u\n",
  p->pad, p->start_block, p->blocks);
}

static void v4l_print_u32(const void *arg, bool write_only)
{
 pr_cont("value=%u\n", *(const u32 *)arg);
}

static void v4l_print_newline(const void *arg, bool write_only)
{
 pr_cont("\n");
}

static void v4l_print_default(const void *arg, bool write_only)
{
 pr_cont("driver-specific ioctl\n");
}

static bool check_ext_ctrls(struct v4l2_ext_controls *c, unsigned long ioctl)
{
 __u32 i;

 /* zero the reserved fields */
 c->reserved[0] = 0;
 for (i = 0; i < c->count; i++)
  c->controls[i].reserved2[0] = 0;

 switch (c->which) {
 case V4L2_CID_PRIVATE_BASE:
  /*
 * V4L2_CID_PRIVATE_BASE cannot be used as control class
 * when using extended controls.
 * Only when passed in through VIDIOC_G_CTRL and VIDIOC_S_CTRL
 * is it allowed for backwards compatibility.
 */
  if (ioctl == VIDIOC_G_CTRL || ioctl == VIDIOC_S_CTRL)
   return false;
  break;
 case V4L2_CTRL_WHICH_DEF_VAL:
 case V4L2_CTRL_WHICH_MIN_VAL:
 case V4L2_CTRL_WHICH_MAX_VAL:
  /* Default, minimum or maximum value cannot be changed */
  if (ioctl == VIDIOC_S_EXT_CTRLS ||
      ioctl == VIDIOC_TRY_EXT_CTRLS) {
   c->error_idx = c->count;
   return false;
  }
  return true;
 case V4L2_CTRL_WHICH_CUR_VAL:
  return true;
 case V4L2_CTRL_WHICH_REQUEST_VAL:
  c->error_idx = c->count;
  return false;
 }

 /* Check that all controls are from the same control class. */
 for (i = 0; i < c->count; i++) {
  if (V4L2_CTRL_ID2WHICH(c->controls[i].id) != c->which) {
   c->error_idx = ioctl == VIDIOC_TRY_EXT_CTRLS ? i :
              c->count;
   return false;
  }
 }
 return true;
}

static int check_fmt(struct file *file, enum v4l2_buf_type type)
{
 const u32 vid_caps = V4L2_CAP_VIDEO_CAPTURE |
        V4L2_CAP_VIDEO_CAPTURE_MPLANE |
        V4L2_CAP_VIDEO_OUTPUT |
        V4L2_CAP_VIDEO_OUTPUT_MPLANE |
        V4L2_CAP_VIDEO_M2M | V4L2_CAP_VIDEO_M2M_MPLANE;
 const u32 meta_caps = V4L2_CAP_META_CAPTURE |
         V4L2_CAP_META_OUTPUT;
 struct video_device *vfd = video_devdata(file);
 const struct v4l2_ioctl_ops *ops = vfd->ioctl_ops;
 bool is_vid = vfd->vfl_type == VFL_TYPE_VIDEO &&
        (vfd->device_caps & vid_caps);
 bool is_vbi = vfd->vfl_type == VFL_TYPE_VBI;
 bool is_sdr = vfd->vfl_type == VFL_TYPE_SDR;
 bool is_tch = vfd->vfl_type == VFL_TYPE_TOUCH;
 bool is_meta = vfd->vfl_type == VFL_TYPE_VIDEO &&
         (vfd->device_caps & meta_caps);
 bool is_rx = vfd->vfl_dir != VFL_DIR_TX;
 bool is_tx = vfd->vfl_dir != VFL_DIR_RX;

 if (ops == NULL)
  return -EINVAL;

 switch (type) {
 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
  if ((is_vid || is_tch) && is_rx &&
      (ops->vidioc_g_fmt_vid_cap || ops->vidioc_g_fmt_vid_cap_mplane))
   return 0;
  break;
 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
  if ((is_vid || is_tch) && is_rx && ops->vidioc_g_fmt_vid_cap_mplane)
   return 0;
  break;
 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
  if (is_vid && is_rx && ops->vidioc_g_fmt_vid_overlay)
   return 0;
  break;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
  if (is_vid && is_tx &&
      (ops->vidioc_g_fmt_vid_out || ops->vidioc_g_fmt_vid_out_mplane))
   return 0;
  break;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
  if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_mplane)
   return 0;
  break;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
  if (is_vid && is_tx && ops->vidioc_g_fmt_vid_out_overlay)
   return 0;
  break;
 case V4L2_BUF_TYPE_VBI_CAPTURE:
  if (is_vbi && is_rx && ops->vidioc_g_fmt_vbi_cap)
   return 0;
  break;
 case V4L2_BUF_TYPE_VBI_OUTPUT:
  if (is_vbi && is_tx && ops->vidioc_g_fmt_vbi_out)
   return 0;
  break;
 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
  if (is_vbi && is_rx && ops->vidioc_g_fmt_sliced_vbi_cap)
   return 0;
  break;
 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
  if (is_vbi && is_tx && ops->vidioc_g_fmt_sliced_vbi_out)
   return 0;
  break;
 case V4L2_BUF_TYPE_SDR_CAPTURE:
  if (is_sdr && is_rx && ops->vidioc_g_fmt_sdr_cap)
   return 0;
  break;
 case V4L2_BUF_TYPE_SDR_OUTPUT:
  if (is_sdr && is_tx && ops->vidioc_g_fmt_sdr_out)
   return 0;
  break;
 case V4L2_BUF_TYPE_META_CAPTURE:
  if (is_meta && is_rx && ops->vidioc_g_fmt_meta_cap)
   return 0;
  break;
 case V4L2_BUF_TYPE_META_OUTPUT:
  if (is_meta && is_tx && ops->vidioc_g_fmt_meta_out)
   return 0;
  break;
 default:
  break;
 }
 return -EINVAL;
}

static void v4l_sanitize_colorspace(u32 pixelformat, u32 *colorspace,
        u32 *encoding, u32 *quantization,
        u32 *xfer_func)
{
 bool is_hsv = pixelformat == V4L2_PIX_FMT_HSV24 ||
        pixelformat == V4L2_PIX_FMT_HSV32;

 if (!v4l2_is_colorspace_valid(*colorspace)) {
  *colorspace = V4L2_COLORSPACE_DEFAULT;
  *encoding = V4L2_YCBCR_ENC_DEFAULT;
  *quantization = V4L2_QUANTIZATION_DEFAULT;
  *xfer_func = V4L2_XFER_FUNC_DEFAULT;
 }

 if ((!is_hsv && !v4l2_is_ycbcr_enc_valid(*encoding)) ||
     (is_hsv && !v4l2_is_hsv_enc_valid(*encoding)))
  *encoding = V4L2_YCBCR_ENC_DEFAULT;

 if (!v4l2_is_quant_valid(*quantization))
  *quantization = V4L2_QUANTIZATION_DEFAULT;

 if (!v4l2_is_xfer_func_valid(*xfer_func))
  *xfer_func = V4L2_XFER_FUNC_DEFAULT;
}

static void v4l_sanitize_format(struct v4l2_format *fmt)
{
 unsigned int offset;

 /* Make sure num_planes is not bogus */
 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE ||
     fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
  fmt->fmt.pix_mp.num_planes = min_t(u32, fmt->fmt.pix_mp.num_planes,
            VIDEO_MAX_PLANES);

 /*
 * The v4l2_pix_format structure has been extended with fields that were
 * not previously required to be set to zero by applications. The priv
 * field, when set to a magic value, indicates that the extended fields
 * are valid. Otherwise they will contain undefined values. To simplify
 * the API towards drivers zero the extended fields and set the priv
 * field to the magic value when the extended pixel format structure
 * isn't used by applications.
 */
 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
     fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT) {
  if (fmt->fmt.pix.priv != V4L2_PIX_FMT_PRIV_MAGIC) {
   fmt->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;

   offset = offsetof(struct v4l2_pix_format, priv)
          + sizeof(fmt->fmt.pix.priv);
   memset(((void *)&fmt->fmt.pix) + offset, 0,
          sizeof(fmt->fmt.pix) - offset);
  }
 }

 /* Replace invalid colorspace values with defaults. */
 if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE ||
     fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT) {
  v4l_sanitize_colorspace(fmt->fmt.pix.pixelformat,
     &fmt->fmt.pix.colorspace,
     &fmt->fmt.pix.ycbcr_enc,
     &fmt->fmt.pix.quantization,
     &fmt->fmt.pix.xfer_func);
 } else if (fmt->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE ||
     fmt->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE) {
  u32 ycbcr_enc = fmt->fmt.pix_mp.ycbcr_enc;
  u32 quantization = fmt->fmt.pix_mp.quantization;
  u32 xfer_func = fmt->fmt.pix_mp.xfer_func;

  v4l_sanitize_colorspace(fmt->fmt.pix_mp.pixelformat,
     &fmt->fmt.pix_mp.colorspace, &ycbcr_enc,
     &quantization, &xfer_func);

  fmt->fmt.pix_mp.ycbcr_enc = ycbcr_enc;
  fmt->fmt.pix_mp.quantization = quantization;
  fmt->fmt.pix_mp.xfer_func = xfer_func;
 }
}

static int v4l_querycap(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct v4l2_capability *cap = (struct v4l2_capability *)arg;
 struct video_device *vfd = video_devdata(file);
 int ret;

 cap->version = LINUX_VERSION_CODE;
 cap->device_caps = vfd->device_caps;
 cap->capabilities = vfd->device_caps | V4L2_CAP_DEVICE_CAPS;

 media_set_bus_info(cap->bus_info, sizeof(cap->bus_info),
      vfd->dev_parent);

 ret = ops->vidioc_querycap(file, fh, cap);

 /*
 * Drivers must not change device_caps, so check for this and
 * warn if this happened.
 */
 WARN_ON(cap->device_caps != vfd->device_caps);
 /*
 * Check that capabilities is a superset of
 * vfd->device_caps | V4L2_CAP_DEVICE_CAPS
 */
 WARN_ON((cap->capabilities &
   (vfd->device_caps | V4L2_CAP_DEVICE_CAPS)) !=
  (vfd->device_caps | V4L2_CAP_DEVICE_CAPS));
 cap->capabilities |= V4L2_CAP_EXT_PIX_FORMAT;
 cap->device_caps |= V4L2_CAP_EXT_PIX_FORMAT;

 return ret;
}

static int v4l_g_input(const struct v4l2_ioctl_ops *ops,
         struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);

 if (vfd->device_caps & V4L2_CAP_IO_MC) {
  *(int *)arg = 0;
  return 0;
 }

 return ops->vidioc_g_input(file, fh, arg);
}

static int v4l_g_output(const struct v4l2_ioctl_ops *ops,
   struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);

 if (vfd->device_caps & V4L2_CAP_IO_MC) {
  *(int *)arg = 0;
  return 0;
 }

 return ops->vidioc_g_output(file, fh, arg);
}

static int v4l_s_input(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);
 int ret;

 ret = v4l_enable_media_source(vfd);
 if (ret)
  return ret;

 if (vfd->device_caps & V4L2_CAP_IO_MC)
  return  *(int *)arg ? -EINVAL : 0;

 return ops->vidioc_s_input(file, fh, *(unsigned int *)arg);
}

static int v4l_s_output(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);

 if (vfd->device_caps & V4L2_CAP_IO_MC)
  return  *(int *)arg ? -EINVAL : 0;

 return ops->vidioc_s_output(file, fh, *(unsigned int *)arg);
}

static int v4l_g_priority(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd;
 u32 *p = arg;

 vfd = video_devdata(file);
 *p = v4l2_prio_max(vfd->prio);
 return 0;
}

static int v4l_s_priority(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd;
 struct v4l2_fh *vfh;
 u32 *p = arg;

 vfd = video_devdata(file);
 if (!test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags))
  return -ENOTTY;
 vfh = file->private_data;
 return v4l2_prio_change(vfd->prio, &vfh->prio, *p);
}

static int v4l_enuminput(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);
 struct v4l2_input *p = arg;

 /*
 * We set the flags for CAP_DV_TIMINGS &
 * CAP_STD here based on ioctl handler provided by the
 * driver. If the driver doesn't support these
 * for a specific input, it must override these flags.
 */
 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
  p->capabilities |= V4L2_IN_CAP_STD;

 if (vfd->device_caps & V4L2_CAP_IO_MC) {
  if (p->index)
   return -EINVAL;
  strscpy(p->name, vfd->name, sizeof(p->name));
  p->type = V4L2_INPUT_TYPE_CAMERA;
  return 0;
 }

 return ops->vidioc_enum_input(file, fh, p);
}

static int v4l_enumoutput(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vfd = video_devdata(file);
 struct v4l2_output *p = arg;

 /*
 * We set the flags for CAP_DV_TIMINGS &
 * CAP_STD here based on ioctl handler provided by the
 * driver. If the driver doesn't support these
 * for a specific output, it must override these flags.
 */
 if (is_valid_ioctl(vfd, VIDIOC_S_STD))
  p->capabilities |= V4L2_OUT_CAP_STD;

 if (vfd->device_caps & V4L2_CAP_IO_MC) {
  if (p->index)
   return -EINVAL;
  strscpy(p->name, vfd->name, sizeof(p->name));
  p->type = V4L2_OUTPUT_TYPE_ANALOG;
  return 0;
 }

 return ops->vidioc_enum_output(file, fh, p);
}

static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt)
{
 const unsigned sz = sizeof(fmt->description);
 const char *descr = NULL;
 u32 flags = 0;

 /*
 * We depart from the normal coding style here since the descriptions
 * should be aligned so it is easy to see which descriptions will be
 * longer than 31 characters (the max length for a description).
 * And frankly, this is easier to read anyway.
 *
 * Note that gcc will use O(log N) comparisons to find the right case.
 */
 switch (fmt->pixelformat) {
 /* Max description length mask: descr = "0123456789012345678901234567890" */
 case V4L2_PIX_FMT_RGB332: descr = "8-bit RGB 3-3-2"; break;
 case V4L2_PIX_FMT_RGB444: descr = "16-bit A/XRGB 4-4-4-4"; break;
 case V4L2_PIX_FMT_ARGB444: descr = "16-bit ARGB 4-4-4-4"; break;
 case V4L2_PIX_FMT_XRGB444: descr = "16-bit XRGB 4-4-4-4"; break;
 case V4L2_PIX_FMT_RGBA444: descr = "16-bit RGBA 4-4-4-4"; break;
 case V4L2_PIX_FMT_RGBX444: descr = "16-bit RGBX 4-4-4-4"; break;
 case V4L2_PIX_FMT_ABGR444: descr = "16-bit ABGR 4-4-4-4"; break;
 case V4L2_PIX_FMT_XBGR444: descr = "16-bit XBGR 4-4-4-4"; break;
 case V4L2_PIX_FMT_BGRA444: descr = "16-bit BGRA 4-4-4-4"; break;
 case V4L2_PIX_FMT_BGRX444: descr = "16-bit BGRX 4-4-4-4"; break;
 case V4L2_PIX_FMT_RGB555: descr = "16-bit A/XRGB 1-5-5-5"; break;
 case V4L2_PIX_FMT_ARGB555: descr = "16-bit ARGB 1-5-5-5"; break;
 case V4L2_PIX_FMT_XRGB555: descr = "16-bit XRGB 1-5-5-5"; break;
 case V4L2_PIX_FMT_ABGR555: descr = "16-bit ABGR 1-5-5-5"; break;
 case V4L2_PIX_FMT_XBGR555: descr = "16-bit XBGR 1-5-5-5"; break;
 case V4L2_PIX_FMT_RGBA555: descr = "16-bit RGBA 5-5-5-1"; break;
 case V4L2_PIX_FMT_RGBX555: descr = "16-bit RGBX 5-5-5-1"; break;
 case V4L2_PIX_FMT_BGRA555: descr = "16-bit BGRA 5-5-5-1"; break;
 case V4L2_PIX_FMT_BGRX555: descr = "16-bit BGRX 5-5-5-1"; break;
 case V4L2_PIX_FMT_RGB565: descr = "16-bit RGB 5-6-5"; break;
 case V4L2_PIX_FMT_RGB555X: descr = "16-bit A/XRGB 1-5-5-5 BE"; break;
 case V4L2_PIX_FMT_ARGB555X: descr = "16-bit ARGB 1-5-5-5 BE"; break;
 case V4L2_PIX_FMT_XRGB555X: descr = "16-bit XRGB 1-5-5-5 BE"; break;
 case V4L2_PIX_FMT_RGB565X: descr = "16-bit RGB 5-6-5 BE"; break;
 case V4L2_PIX_FMT_BGR666: descr = "18-bit BGRX 6-6-6-14"; break;
 case V4L2_PIX_FMT_BGR24: descr = "24-bit BGR 8-8-8"; break;
 case V4L2_PIX_FMT_RGB24: descr = "24-bit RGB 8-8-8"; break;
 case V4L2_PIX_FMT_BGR32: descr = "32-bit BGRA/X 8-8-8-8"; break;
 case V4L2_PIX_FMT_ABGR32: descr = "32-bit BGRA 8-8-8-8"; break;
 case V4L2_PIX_FMT_XBGR32: descr = "32-bit BGRX 8-8-8-8"; break;
 case V4L2_PIX_FMT_RGB32: descr = "32-bit A/XRGB 8-8-8-8"; break;
 case V4L2_PIX_FMT_ARGB32: descr = "32-bit ARGB 8-8-8-8"; break;
 case V4L2_PIX_FMT_XRGB32: descr = "32-bit XRGB 8-8-8-8"; break;
 case V4L2_PIX_FMT_BGRA32: descr = "32-bit ABGR 8-8-8-8"; break;
 case V4L2_PIX_FMT_BGRX32: descr = "32-bit XBGR 8-8-8-8"; break;
 case V4L2_PIX_FMT_RGBA32: descr = "32-bit RGBA 8-8-8-8"; break;
 case V4L2_PIX_FMT_RGBX32: descr = "32-bit RGBX 8-8-8-8"; break;
 case V4L2_PIX_FMT_RGBX1010102: descr = "32-bit RGBX 10-10-10-2"; break;
 case V4L2_PIX_FMT_RGBA1010102: descr = "32-bit RGBA 10-10-10-2"; break;
 case V4L2_PIX_FMT_ARGB2101010: descr = "32-bit ARGB 2-10-10-10"; break;
 case V4L2_PIX_FMT_BGR48: descr = "48-bit BGR 16-16-16"; break;
 case V4L2_PIX_FMT_RGB48: descr = "48-bit RGB 16-16-16"; break;
 case V4L2_PIX_FMT_BGR48_12: descr = "12-bit Depth BGR"; break;
 case V4L2_PIX_FMT_ABGR64_12: descr = "12-bit Depth BGRA"; break;
 case V4L2_PIX_FMT_GREY:  descr = "8-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y4:  descr = "4-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y6:  descr = "6-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y10:  descr = "10-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y12:  descr = "12-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y012:  descr = "12-bit Greyscale (bits 15-4)"; break;
 case V4L2_PIX_FMT_Y14:  descr = "14-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y16:  descr = "16-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y16_BE: descr = "16-bit Greyscale BE"; break;
 case V4L2_PIX_FMT_Y10BPACK: descr = "10-bit Greyscale (Packed)"; break;
 case V4L2_PIX_FMT_Y10P:  descr = "10-bit Greyscale (MIPI Packed)"; break;
 case V4L2_PIX_FMT_IPU3_Y10: descr = "10-bit greyscale (IPU3 Packed)"; break;
 case V4L2_PIX_FMT_Y12P:  descr = "12-bit Greyscale (MIPI Packed)"; break;
 case V4L2_PIX_FMT_Y14P:  descr = "14-bit Greyscale (MIPI Packed)"; break;
 case V4L2_PIX_FMT_Y8I:  descr = "Interleaved 8-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y12I:  descr = "Interleaved 12-bit Greyscale"; break;
 case V4L2_PIX_FMT_Y16I:  descr = "Interleaved 16-bit Greyscale"; break;
 case V4L2_PIX_FMT_Z16:  descr = "16-bit Depth"; break;
 case V4L2_PIX_FMT_INZI:  descr = "Planar 10:16 Greyscale Depth"; break;
 case V4L2_PIX_FMT_CNF4:  descr = "4-bit Depth Confidence (Packed)"; break;
 case V4L2_PIX_FMT_PAL8:  descr = "8-bit Palette"; break;
 case V4L2_PIX_FMT_UV8:  descr = "8-bit Chrominance UV 4-4"; break;
 case V4L2_PIX_FMT_YVU410: descr = "Planar YVU 4:1:0"; break;
 case V4L2_PIX_FMT_YVU420: descr = "Planar YVU 4:2:0"; break;
 case V4L2_PIX_FMT_YUYV:  descr = "YUYV 4:2:2"; break;
 case V4L2_PIX_FMT_YYUV:  descr = "YYUV 4:2:2"; break;
 case V4L2_PIX_FMT_YVYU:  descr = "YVYU 4:2:2"; break;
 case V4L2_PIX_FMT_UYVY:  descr = "UYVY 4:2:2"; break;
 case V4L2_PIX_FMT_VYUY:  descr = "VYUY 4:2:2"; break;
 case V4L2_PIX_FMT_YUV422P: descr = "Planar YUV 4:2:2"; break;
 case V4L2_PIX_FMT_YUV411P: descr = "Planar YUV 4:1:1"; break;
 case V4L2_PIX_FMT_Y41P:  descr = "YUV 4:1:1 (Packed)"; break;
 case V4L2_PIX_FMT_YUV444: descr = "16-bit A/XYUV 4-4-4-4"; break;
 case V4L2_PIX_FMT_YUV555: descr = "16-bit A/XYUV 1-5-5-5"; break;
 case V4L2_PIX_FMT_YUV565: descr = "16-bit YUV 5-6-5"; break;
 case V4L2_PIX_FMT_YUV24: descr = "24-bit YUV 4:4:4 8-8-8"; break;
 case V4L2_PIX_FMT_YUV32: descr = "32-bit A/XYUV 8-8-8-8"; break;
 case V4L2_PIX_FMT_AYUV32: descr = "32-bit AYUV 8-8-8-8"; break;
 case V4L2_PIX_FMT_XYUV32: descr = "32-bit XYUV 8-8-8-8"; break;
 case V4L2_PIX_FMT_VUYA32: descr = "32-bit VUYA 8-8-8-8"; break;
 case V4L2_PIX_FMT_VUYX32: descr = "32-bit VUYX 8-8-8-8"; break;
 case V4L2_PIX_FMT_YUVA32: descr = "32-bit YUVA 8-8-8-8"; break;
 case V4L2_PIX_FMT_YUVX32: descr = "32-bit YUVX 8-8-8-8"; break;
 case V4L2_PIX_FMT_YUV410: descr = "Planar YUV 4:1:0"; break;
 case V4L2_PIX_FMT_YUV420: descr = "Planar YUV 4:2:0"; break;
 case V4L2_PIX_FMT_HI240: descr = "8-bit Dithered RGB (BTTV)"; break;
 case V4L2_PIX_FMT_M420:  descr = "YUV 4:2:0 (M420)"; break;
 case V4L2_PIX_FMT_YUV48_12: descr = "12-bit YUV 4:4:4 Packed"; break;
 case V4L2_PIX_FMT_NV12:  descr = "Y/UV 4:2:0"; break;
 case V4L2_PIX_FMT_NV21:  descr = "Y/VU 4:2:0"; break;
 case V4L2_PIX_FMT_NV15:  descr = "10-bit Y/UV 4:2:0 (Packed)"; break;
 case V4L2_PIX_FMT_NV16:  descr = "Y/UV 4:2:2"; break;
 case V4L2_PIX_FMT_NV61:  descr = "Y/VU 4:2:2"; break;
 case V4L2_PIX_FMT_NV20:  descr = "10-bit Y/UV 4:2:2 (Packed)"; break;
 case V4L2_PIX_FMT_NV24:  descr = "Y/UV 4:4:4"; break;
 case V4L2_PIX_FMT_NV42:  descr = "Y/VU 4:4:4"; break;
 case V4L2_PIX_FMT_P010:  descr = "10-bit Y/UV 4:2:0"; break;
 case V4L2_PIX_FMT_P012:  descr = "12-bit Y/UV 4:2:0"; break;
 case V4L2_PIX_FMT_NV12_4L4: descr = "Y/UV 4:2:0 (4x4 Linear)"; break;
 case V4L2_PIX_FMT_NV12_16L16: descr = "Y/UV 4:2:0 (16x16 Linear)"; break;
 case V4L2_PIX_FMT_NV12_32L32:   descr = "Y/UV 4:2:0 (32x32 Linear)"; break;
 case V4L2_PIX_FMT_NV15_4L4: descr = "10-bit Y/UV 4:2:0 (4x4 Linear)"; break;
 case V4L2_PIX_FMT_P010_4L4: descr = "10-bit Y/UV 4:2:0 (4x4 Linear)"; break;
 case V4L2_PIX_FMT_NV12M: descr = "Y/UV 4:2:0 (N-C)"; break;
 case V4L2_PIX_FMT_NV21M: descr = "Y/VU 4:2:0 (N-C)"; break;
 case V4L2_PIX_FMT_NV16M: descr = "Y/UV 4:2:2 (N-C)"; break;
 case V4L2_PIX_FMT_NV61M: descr = "Y/VU 4:2:2 (N-C)"; break;
 case V4L2_PIX_FMT_NV12MT: descr = "Y/UV 4:2:0 (64x32 MB, N-C)"; break;
 case V4L2_PIX_FMT_NV12MT_16X16: descr = "Y/UV 4:2:0 (16x16 MB, N-C)"; break;
 case V4L2_PIX_FMT_P012M: descr = "12-bit Y/UV 4:2:0 (N-C)"; break;
 case V4L2_PIX_FMT_YUV420M: descr = "Planar YUV 4:2:0 (N-C)"; break;
 case V4L2_PIX_FMT_YVU420M: descr = "Planar YVU 4:2:0 (N-C)"; break;
 case V4L2_PIX_FMT_YUV422M: descr = "Planar YUV 4:2:2 (N-C)"; break;
 case V4L2_PIX_FMT_YVU422M: descr = "Planar YVU 4:2:2 (N-C)"; break;
 case V4L2_PIX_FMT_YUV444M: descr = "Planar YUV 4:4:4 (N-C)"; break;
 case V4L2_PIX_FMT_YVU444M: descr = "Planar YVU 4:4:4 (N-C)"; break;
 case V4L2_PIX_FMT_SBGGR8: descr = "8-bit Bayer BGBG/GRGR"; break;
 case V4L2_PIX_FMT_SGBRG8: descr = "8-bit Bayer GBGB/RGRG"; break;
 case V4L2_PIX_FMT_SGRBG8: descr = "8-bit Bayer GRGR/BGBG"; break;
 case V4L2_PIX_FMT_SRGGB8: descr = "8-bit Bayer RGRG/GBGB"; break;
 case V4L2_PIX_FMT_SBGGR10: descr = "10-bit Bayer BGBG/GRGR"; break;
 case V4L2_PIX_FMT_SGBRG10: descr = "10-bit Bayer GBGB/RGRG"; break;
 case V4L2_PIX_FMT_SGRBG10: descr = "10-bit Bayer GRGR/BGBG"; break;
 case V4L2_PIX_FMT_SRGGB10: descr = "10-bit Bayer RGRG/GBGB"; break;
 case V4L2_PIX_FMT_SBGGR10P: descr = "10-bit Bayer BGBG/GRGR Packed"; break;
 case V4L2_PIX_FMT_SGBRG10P: descr = "10-bit Bayer GBGB/RGRG Packed"; break;
 case V4L2_PIX_FMT_SGRBG10P: descr = "10-bit Bayer GRGR/BGBG Packed"; break;
 case V4L2_PIX_FMT_SRGGB10P: descr = "10-bit Bayer RGRG/GBGB Packed"; break;
 case V4L2_PIX_FMT_IPU3_SBGGR10: descr = "10-bit bayer BGGR IPU3 Packed"; break;
 case V4L2_PIX_FMT_IPU3_SGBRG10: descr = "10-bit bayer GBRG IPU3 Packed"; break;
 case V4L2_PIX_FMT_IPU3_SGRBG10: descr = "10-bit bayer GRBG IPU3 Packed"; break;
 case V4L2_PIX_FMT_IPU3_SRGGB10: descr = "10-bit bayer RGGB IPU3 Packed"; break;
 case V4L2_PIX_FMT_SBGGR10ALAW8: descr = "8-bit Bayer BGBG/GRGR (A-law)"; break;
 case V4L2_PIX_FMT_SGBRG10ALAW8: descr = "8-bit Bayer GBGB/RGRG (A-law)"; break;
 case V4L2_PIX_FMT_SGRBG10ALAW8: descr = "8-bit Bayer GRGR/BGBG (A-law)"; break;
 case V4L2_PIX_FMT_SRGGB10ALAW8: descr = "8-bit Bayer RGRG/GBGB (A-law)"; break;
 case V4L2_PIX_FMT_SBGGR10DPCM8: descr = "8-bit Bayer BGBG/GRGR (DPCM)"; break;
 case V4L2_PIX_FMT_SGBRG10DPCM8: descr = "8-bit Bayer GBGB/RGRG (DPCM)"; break;
 case V4L2_PIX_FMT_SGRBG10DPCM8: descr = "8-bit Bayer GRGR/BGBG (DPCM)"; break;
 case V4L2_PIX_FMT_SRGGB10DPCM8: descr = "8-bit Bayer RGRG/GBGB (DPCM)"; break;
 case V4L2_PIX_FMT_RAW_CRU10: descr = "10-bit Raw CRU Packed"; break;
 case V4L2_PIX_FMT_SBGGR12: descr = "12-bit Bayer BGBG/GRGR"; break;
 case V4L2_PIX_FMT_SGBRG12: descr = "12-bit Bayer GBGB/RGRG"; break;
 case V4L2_PIX_FMT_SGRBG12: descr = "12-bit Bayer GRGR/BGBG"; break;
 case V4L2_PIX_FMT_SRGGB12: descr = "12-bit Bayer RGRG/GBGB"; break;
 case V4L2_PIX_FMT_SBGGR12P: descr = "12-bit Bayer BGBG/GRGR Packed"; break;
 case V4L2_PIX_FMT_SGBRG12P: descr = "12-bit Bayer GBGB/RGRG Packed"; break;
 case V4L2_PIX_FMT_SGRBG12P: descr = "12-bit Bayer GRGR/BGBG Packed"; break;
 case V4L2_PIX_FMT_SRGGB12P: descr = "12-bit Bayer RGRG/GBGB Packed"; break;
 case V4L2_PIX_FMT_RAW_CRU12: descr = "12-bit Raw CRU Packed"; break;
 case V4L2_PIX_FMT_SBGGR14: descr = "14-bit Bayer BGBG/GRGR"; break;
 case V4L2_PIX_FMT_SGBRG14: descr = "14-bit Bayer GBGB/RGRG"; break;
 case V4L2_PIX_FMT_SGRBG14: descr = "14-bit Bayer GRGR/BGBG"; break;
 case V4L2_PIX_FMT_SRGGB14: descr = "14-bit Bayer RGRG/GBGB"; break;
 case V4L2_PIX_FMT_SBGGR14P: descr = "14-bit Bayer BGBG/GRGR Packed"; break;
 case V4L2_PIX_FMT_SGBRG14P: descr = "14-bit Bayer GBGB/RGRG Packed"; break;
 case V4L2_PIX_FMT_SGRBG14P: descr = "14-bit Bayer GRGR/BGBG Packed"; break;
 case V4L2_PIX_FMT_SRGGB14P: descr = "14-bit Bayer RGRG/GBGB Packed"; break;
 case V4L2_PIX_FMT_RAW_CRU14: descr = "14-bit Raw CRU Packed"; break;
 case V4L2_PIX_FMT_SBGGR16: descr = "16-bit Bayer BGBG/GRGR"; break;
 case V4L2_PIX_FMT_SGBRG16: descr = "16-bit Bayer GBGB/RGRG"; break;
 case V4L2_PIX_FMT_SGRBG16: descr = "16-bit Bayer GRGR/BGBG"; break;
 case V4L2_PIX_FMT_SRGGB16: descr = "16-bit Bayer RGRG/GBGB"; break;
 case V4L2_PIX_FMT_RAW_CRU20: descr = "14-bit Raw CRU Packed"; break;
 case V4L2_PIX_FMT_SN9C20X_I420: descr = "GSPCA SN9C20X I420"; break;
 case V4L2_PIX_FMT_SPCA501: descr = "GSPCA SPCA501"; break;
 case V4L2_PIX_FMT_SPCA505: descr = "GSPCA SPCA505"; break;
 case V4L2_PIX_FMT_SPCA508: descr = "GSPCA SPCA508"; break;
 case V4L2_PIX_FMT_STV0680: descr = "GSPCA STV0680"; break;
 case V4L2_PIX_FMT_TM6000: descr = "A/V + VBI Mux Packet"; break;
 case V4L2_PIX_FMT_CIT_YYVYUY: descr = "GSPCA CIT YYVYUY"; break;
 case V4L2_PIX_FMT_KONICA420: descr = "GSPCA KONICA420"; break;
 case V4L2_PIX_FMT_MM21:  descr = "Mediatek 8-bit Block Format"; break;
 case V4L2_PIX_FMT_HSV24: descr = "24-bit HSV 8-8-8"; break;
 case V4L2_PIX_FMT_HSV32: descr = "32-bit XHSV 8-8-8-8"; break;
 case V4L2_SDR_FMT_CU8:  descr = "Complex U8"; break;
 case V4L2_SDR_FMT_CU16LE: descr = "Complex U16LE"; break;
 case V4L2_SDR_FMT_CS8:  descr = "Complex S8"; break;
 case V4L2_SDR_FMT_CS14LE: descr = "Complex S14LE"; break;
 case V4L2_SDR_FMT_RU12LE: descr = "Real U12LE"; break;
 case V4L2_SDR_FMT_PCU16BE: descr = "Planar Complex U16BE"; break;
 case V4L2_SDR_FMT_PCU18BE: descr = "Planar Complex U18BE"; break;
 case V4L2_SDR_FMT_PCU20BE: descr = "Planar Complex U20BE"; break;
 case V4L2_TCH_FMT_DELTA_TD16: descr = "16-bit Signed Deltas"; break;
 case V4L2_TCH_FMT_DELTA_TD08: descr = "8-bit Signed Deltas"; break;
 case V4L2_TCH_FMT_TU16:  descr = "16-bit Unsigned Touch Data"; break;
 case V4L2_TCH_FMT_TU08:  descr = "8-bit Unsigned Touch Data"; break;
 case V4L2_META_FMT_VSP1_HGO: descr = "R-Car VSP1 1-D Histogram"; break;
 case V4L2_META_FMT_VSP1_HGT: descr = "R-Car VSP1 2-D Histogram"; break;
 case V4L2_META_FMT_UVC:  descr = "UVC Payload Header Metadata"; break;
 case V4L2_META_FMT_UVC_MSXU_1_5: descr = "UVC MSXU Metadata"; break;
 case V4L2_META_FMT_D4XX: descr = "Intel D4xx UVC Metadata"; break;
 case V4L2_META_FMT_VIVID:       descr = "Vivid Metadata"; break;
 case V4L2_META_FMT_RK_ISP1_PARAMS: descr = "Rockchip ISP1 3A Parameters"; break;
 case V4L2_META_FMT_RK_ISP1_STAT_3A: descr = "Rockchip ISP1 3A Statistics"; break;
 case V4L2_META_FMT_RK_ISP1_EXT_PARAMS: descr = "Rockchip ISP1 Ext 3A Params"; break;
 case V4L2_META_FMT_C3ISP_PARAMS: descr = "Amlogic C3 ISP Parameters"; break;
 case V4L2_META_FMT_C3ISP_STATS:  descr = "Amlogic C3 ISP Statistics"; break;
 case V4L2_PIX_FMT_NV12_8L128: descr = "NV12 (8x128 Linear)"; break;
 case V4L2_PIX_FMT_NV12M_8L128: descr = "NV12M (8x128 Linear)"; break;
 case V4L2_PIX_FMT_NV12_10BE_8L128: descr = "10-bit NV12 (8x128 Linear, BE)"; break;
 case V4L2_PIX_FMT_NV12M_10BE_8L128: descr = "10-bit NV12M (8x128 Linear, BE)"; break;
 case V4L2_PIX_FMT_Y210:  descr = "10-bit YUYV Packed"; break;
 case V4L2_PIX_FMT_Y212:  descr = "12-bit YUYV Packed"; break;
 case V4L2_PIX_FMT_Y216:  descr = "16-bit YUYV Packed"; break;
 case V4L2_META_FMT_RPI_BE_CFG: descr = "RPi PiSP BE Config format"; break;
 case V4L2_META_FMT_RPI_FE_CFG:  descr = "RPi PiSP FE Config format"; break;
 case V4L2_META_FMT_RPI_FE_STATS: descr = "RPi PiSP FE Statistics format"; break;
 case V4L2_META_FMT_GENERIC_8: descr = "8-bit Generic Metadata"; break;
 case V4L2_META_FMT_GENERIC_CSI2_10: descr = "8-bit Generic Meta, 10b CSI-2"; break;
 case V4L2_META_FMT_GENERIC_CSI2_12: descr = "8-bit Generic Meta, 12b CSI-2"; break;
 case V4L2_META_FMT_GENERIC_CSI2_14: descr = "8-bit Generic Meta, 14b CSI-2"; break;
 case V4L2_META_FMT_GENERIC_CSI2_16: descr = "8-bit Generic Meta, 16b CSI-2"; break;
 case V4L2_META_FMT_GENERIC_CSI2_20: descr = "8-bit Generic Meta, 20b CSI-2"; break;
 case V4L2_META_FMT_GENERIC_CSI2_24: descr = "8-bit Generic Meta, 24b CSI-2"; break;

 default:
  /* Compressed formats */
  flags = V4L2_FMT_FLAG_COMPRESSED;
  switch (fmt->pixelformat) {
  /* Max description length mask: descr = "0123456789012345678901234567890" */
  case V4L2_PIX_FMT_MJPEG: descr = "Motion-JPEG"; break;
  case V4L2_PIX_FMT_JPEG:  descr = "JFIF JPEG"; break;
  case V4L2_PIX_FMT_DV:  descr = "1394"; break;
  case V4L2_PIX_FMT_MPEG:  descr = "MPEG-1/2/4"; break;
  case V4L2_PIX_FMT_H264:  descr = "H.264"; break;
  case V4L2_PIX_FMT_H264_NO_SC: descr = "H.264 (No Start Codes)"; break;
  case V4L2_PIX_FMT_H264_MVC: descr = "H.264 MVC"; break;
  case V4L2_PIX_FMT_H264_SLICE: descr = "H.264 Parsed Slice Data"; break;
  case V4L2_PIX_FMT_H263:  descr = "H.263"; break;
  case V4L2_PIX_FMT_MPEG1: descr = "MPEG-1 ES"; break;
  case V4L2_PIX_FMT_MPEG2: descr = "MPEG-2 ES"; break;
  case V4L2_PIX_FMT_MPEG2_SLICE: descr = "MPEG-2 Parsed Slice Data"; break;
  case V4L2_PIX_FMT_MPEG4: descr = "MPEG-4 Part 2 ES"; break;
  case V4L2_PIX_FMT_XVID:  descr = "Xvid"; break;
  case V4L2_PIX_FMT_VC1_ANNEX_G: descr = "VC-1 (SMPTE 412M Annex G)"; break;
  case V4L2_PIX_FMT_VC1_ANNEX_L: descr = "VC-1 (SMPTE 412M Annex L)"; break;
  case V4L2_PIX_FMT_VP8:  descr = "VP8"; break;
  case V4L2_PIX_FMT_VP8_FRAME:    descr = "VP8 Frame"; break;
  case V4L2_PIX_FMT_VP9:  descr = "VP9"; break;
  case V4L2_PIX_FMT_VP9_FRAME:    descr = "VP9 Frame"; break;
  case V4L2_PIX_FMT_HEVC:  descr = "HEVC"; break; /* aka H.265 */
  case V4L2_PIX_FMT_HEVC_SLICE: descr = "HEVC Parsed Slice Data"; break;
  case V4L2_PIX_FMT_FWHT:  descr = "FWHT"; break; /* used in vicodec */
  case V4L2_PIX_FMT_FWHT_STATELESS: descr = "FWHT Stateless"; break; /* used in vicodec */
  case V4L2_PIX_FMT_SPK:  descr = "Sorenson Spark"; break;
  case V4L2_PIX_FMT_RV30:  descr = "RealVideo 8"; break;
  case V4L2_PIX_FMT_RV40:  descr = "RealVideo 9 & 10"; break;
  case V4L2_PIX_FMT_CPIA1: descr = "GSPCA CPiA YUV"; break;
  case V4L2_PIX_FMT_WNVA:  descr = "WNVA"; break;
  case V4L2_PIX_FMT_SN9C10X: descr = "GSPCA SN9C10X"; break;
  case V4L2_PIX_FMT_PWC1:  descr = "Raw Philips Webcam Type (Old)"; break;
  case V4L2_PIX_FMT_PWC2:  descr = "Raw Philips Webcam Type (New)"; break;
  case V4L2_PIX_FMT_ET61X251: descr = "GSPCA ET61X251"; break;
  case V4L2_PIX_FMT_SPCA561: descr = "GSPCA SPCA561"; break;
  case V4L2_PIX_FMT_PAC207: descr = "GSPCA PAC207"; break;
  case V4L2_PIX_FMT_MR97310A: descr = "GSPCA MR97310A"; break;
  case V4L2_PIX_FMT_JL2005BCD: descr = "GSPCA JL2005BCD"; break;
  case V4L2_PIX_FMT_SN9C2028: descr = "GSPCA SN9C2028"; break;
  case V4L2_PIX_FMT_SQ905C: descr = "GSPCA SQ905C"; break;
  case V4L2_PIX_FMT_PJPG:  descr = "GSPCA PJPG"; break;
  case V4L2_PIX_FMT_OV511: descr = "GSPCA OV511"; break;
  case V4L2_PIX_FMT_OV518: descr = "GSPCA OV518"; break;
  case V4L2_PIX_FMT_JPGL:  descr = "JPEG Lite"; break;
  case V4L2_PIX_FMT_SE401: descr = "GSPCA SE401"; break;
  case V4L2_PIX_FMT_S5C_UYVY_JPG: descr = "S5C73MX interleaved UYVY/JPEG"; break;
  case V4L2_PIX_FMT_MT21C: descr = "Mediatek Compressed Format"; break;
  case V4L2_PIX_FMT_QC08C: descr = "QCOM Compressed 8-bit Format"; break;
  case V4L2_PIX_FMT_QC10C: descr = "QCOM Compressed 10-bit Format"; break;
  case V4L2_PIX_FMT_AJPG:  descr = "Aspeed JPEG"; break;
  case V4L2_PIX_FMT_AV1_FRAME: descr = "AV1 Frame"; break;
  case V4L2_PIX_FMT_MT2110T: descr = "Mediatek 10bit Tile Mode"; break;
  case V4L2_PIX_FMT_MT2110R: descr = "Mediatek 10bit Raster Mode"; break;
  case V4L2_PIX_FMT_HEXTILE: descr = "Hextile Compressed Format"; break;
  case V4L2_PIX_FMT_PISP_COMP1_RGGB: descr = "PiSP 8b RGRG/GBGB mode1 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP1_GRBG: descr = "PiSP 8b GRGR/BGBG mode1 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP1_GBRG: descr = "PiSP 8b GBGB/RGRG mode1 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP1_BGGR: descr = "PiSP 8b BGBG/GRGR mode1 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP1_MONO: descr = "PiSP 8b monochrome mode1 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP2_RGGB: descr = "PiSP 8b RGRG/GBGB mode2 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP2_GRBG: descr = "PiSP 8b GRGR/BGBG mode2 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP2_GBRG: descr = "PiSP 8b GBGB/RGRG mode2 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP2_BGGR: descr = "PiSP 8b BGBG/GRGR mode2 compr"; break;
  case V4L2_PIX_FMT_PISP_COMP2_MONO: descr = "PiSP 8b monochrome mode2 compr"; break;
  default:
   if (fmt->description[0])
    return;
   WARN(1, "Unknown pixelformat 0x%08x\n", fmt->pixelformat);
   flags = 0;
   snprintf(fmt->description, sz, "%p4cc",
     &fmt->pixelformat);
   break;
  }
 }

 if (fmt->type == V4L2_BUF_TYPE_META_CAPTURE) {
  switch (fmt->pixelformat) {
  case V4L2_META_FMT_GENERIC_8:
  case V4L2_META_FMT_GENERIC_CSI2_10:
  case V4L2_META_FMT_GENERIC_CSI2_12:
  case V4L2_META_FMT_GENERIC_CSI2_14:
  case V4L2_META_FMT_GENERIC_CSI2_16:
  case V4L2_META_FMT_GENERIC_CSI2_20:
  case V4L2_META_FMT_GENERIC_CSI2_24:
   fmt->flags |= V4L2_FMT_FLAG_META_LINE_BASED;
   break;
  default:
   fmt->flags &= ~V4L2_FMT_FLAG_META_LINE_BASED;
  }
 }

 if (descr)
  WARN_ON(strscpy(fmt->description, descr, sz) < 0);
 fmt->flags |= flags;
}

static int v4l_enum_fmt(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct video_device *vdev = video_devdata(file);
 struct v4l2_fmtdesc *p = arg;
 int ret = check_fmt(file, p->type);
 u32 mbus_code;
 u32 cap_mask;

 if (ret)
  return ret;
 ret = -EINVAL;

 if (!(vdev->device_caps & V4L2_CAP_IO_MC))
  p->mbus_code = 0;

 mbus_code = p->mbus_code;
 memset_after(p, 0, type);
 p->mbus_code = mbus_code;

 switch (p->type) {
 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
  cap_mask = V4L2_CAP_VIDEO_CAPTURE_MPLANE |
      V4L2_CAP_VIDEO_M2M_MPLANE;
  if (!!(vdev->device_caps & cap_mask) !=
      (p->type == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE))
   break;

  if (unlikely(!ops->vidioc_enum_fmt_vid_cap))
   break;
  ret = ops->vidioc_enum_fmt_vid_cap(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
  if (unlikely(!ops->vidioc_enum_fmt_vid_overlay))
   break;
  ret = ops->vidioc_enum_fmt_vid_overlay(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
  cap_mask = V4L2_CAP_VIDEO_OUTPUT_MPLANE |
      V4L2_CAP_VIDEO_M2M_MPLANE;
  if (!!(vdev->device_caps & cap_mask) !=
      (p->type == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE))
   break;

  if (unlikely(!ops->vidioc_enum_fmt_vid_out))
   break;
  ret = ops->vidioc_enum_fmt_vid_out(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_SDR_CAPTURE:
  if (unlikely(!ops->vidioc_enum_fmt_sdr_cap))
   break;
  ret = ops->vidioc_enum_fmt_sdr_cap(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_SDR_OUTPUT:
  if (unlikely(!ops->vidioc_enum_fmt_sdr_out))
   break;
  ret = ops->vidioc_enum_fmt_sdr_out(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_META_CAPTURE:
  if (unlikely(!ops->vidioc_enum_fmt_meta_cap))
   break;
  ret = ops->vidioc_enum_fmt_meta_cap(file, fh, arg);
  break;
 case V4L2_BUF_TYPE_META_OUTPUT:
  if (unlikely(!ops->vidioc_enum_fmt_meta_out))
   break;
  ret = ops->vidioc_enum_fmt_meta_out(file, fh, arg);
  break;
 }
 if (ret == 0)
  v4l_fill_fmtdesc(p);
 return ret;
}

static void v4l_pix_format_touch(struct v4l2_pix_format *p)
{
 /*
 * The v4l2_pix_format structure contains fields that make no sense for
 * touch. Set them to default values in this case.
 */

 p->field = V4L2_FIELD_NONE;
 p->colorspace = V4L2_COLORSPACE_RAW;
 p->flags = 0;
 p->ycbcr_enc = 0;
 p->quantization = 0;
 p->xfer_func = 0;
}

static int v4l_g_fmt(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct v4l2_format *p = arg;
 struct video_device *vfd = video_devdata(file);
 int ret = check_fmt(file, p->type);

 if (ret)
  return ret;

 memset(&p->fmt, 0, sizeof(p->fmt));

 switch (p->type) {
 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
  if (unlikely(!ops->vidioc_g_fmt_vid_cap))
   break;
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  ret = ops->vidioc_g_fmt_vid_cap(file, fh, arg);
  /* just in case the driver zeroed it again */
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  if (vfd->vfl_type == VFL_TYPE_TOUCH)
   v4l_pix_format_touch(&p->fmt.pix);
  return ret;
 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
  return ops->vidioc_g_fmt_vid_cap_mplane(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
  return ops->vidioc_g_fmt_vid_overlay(file, fh, arg);
 case V4L2_BUF_TYPE_VBI_CAPTURE:
  return ops->vidioc_g_fmt_vbi_cap(file, fh, arg);
 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
  return ops->vidioc_g_fmt_sliced_vbi_cap(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
  if (unlikely(!ops->vidioc_g_fmt_vid_out))
   break;
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  ret = ops->vidioc_g_fmt_vid_out(file, fh, arg);
  /* just in case the driver zeroed it again */
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  return ret;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
  return ops->vidioc_g_fmt_vid_out_mplane(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
  return ops->vidioc_g_fmt_vid_out_overlay(file, fh, arg);
 case V4L2_BUF_TYPE_VBI_OUTPUT:
  return ops->vidioc_g_fmt_vbi_out(file, fh, arg);
 case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT:
  return ops->vidioc_g_fmt_sliced_vbi_out(file, fh, arg);
 case V4L2_BUF_TYPE_SDR_CAPTURE:
  return ops->vidioc_g_fmt_sdr_cap(file, fh, arg);
 case V4L2_BUF_TYPE_SDR_OUTPUT:
  return ops->vidioc_g_fmt_sdr_out(file, fh, arg);
 case V4L2_BUF_TYPE_META_CAPTURE:
  return ops->vidioc_g_fmt_meta_cap(file, fh, arg);
 case V4L2_BUF_TYPE_META_OUTPUT:
  return ops->vidioc_g_fmt_meta_out(file, fh, arg);
 }
 return -EINVAL;
}

static int v4l_s_fmt(const struct v4l2_ioctl_ops *ops,
    struct file *file, void *fh, void *arg)
{
 struct v4l2_format *p = arg;
 struct video_device *vfd = video_devdata(file);
 int ret = check_fmt(file, p->type);
 unsigned int i;

 if (ret)
  return ret;

 ret = v4l_enable_media_source(vfd);
 if (ret)
  return ret;
 v4l_sanitize_format(p);

 switch (p->type) {
 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
  if (unlikely(!ops->vidioc_s_fmt_vid_cap))
   break;
  memset_after(p, 0, fmt.pix);
  ret = ops->vidioc_s_fmt_vid_cap(file, fh, arg);
  /* just in case the driver zeroed it again */
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  if (vfd->vfl_type == VFL_TYPE_TOUCH)
   v4l_pix_format_touch(&p->fmt.pix);
  return ret;
 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
  if (unlikely(!ops->vidioc_s_fmt_vid_cap_mplane))
   break;
  memset_after(p, 0, fmt.pix_mp.xfer_func);
  for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
   memset_after(&p->fmt.pix_mp.plane_fmt[i],
         0, bytesperline);
  return ops->vidioc_s_fmt_vid_cap_mplane(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
  if (unlikely(!ops->vidioc_s_fmt_vid_overlay))
   break;
  memset_after(p, 0, fmt.win);
  p->fmt.win.clips = NULL;
  p->fmt.win.clipcount = 0;
  p->fmt.win.bitmap = NULL;
  return ops->vidioc_s_fmt_vid_overlay(file, fh, arg);
 case V4L2_BUF_TYPE_VBI_CAPTURE:
  if (unlikely(!ops->vidioc_s_fmt_vbi_cap))
   break;
  memset_after(p, 0, fmt.vbi.flags);
  return ops->vidioc_s_fmt_vbi_cap(file, fh, arg);
 case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE:
  if (unlikely(!ops->vidioc_s_fmt_sliced_vbi_cap))
   break;
  memset_after(p, 0, fmt.sliced.io_size);
  return ops->vidioc_s_fmt_sliced_vbi_cap(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
  if (unlikely(!ops->vidioc_s_fmt_vid_out))
   break;
  memset_after(p, 0, fmt.pix);
  ret = ops->vidioc_s_fmt_vid_out(file, fh, arg);
  /* just in case the driver zeroed it again */
  p->fmt.pix.priv = V4L2_PIX_FMT_PRIV_MAGIC;
  return ret;
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
  if (unlikely(!ops->vidioc_s_fmt_vid_out_mplane))
   break;
  memset_after(p, 0, fmt.pix_mp.xfer_func);
  for (i = 0; i < p->fmt.pix_mp.num_planes; i++)
   memset_after(&p->fmt.pix_mp.plane_fmt[i],
         0, bytesperline);
  return ops->vidioc_s_fmt_vid_out_mplane(file, fh, arg);
 case V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY:
  if (unlikely(!ops->vidioc_s_fmt_vid_out_overlay))
   break;
--> --------------------

--> maximum size reached

--> --------------------