OS Manuals

/usr/bin/v4l2-compliance

Linux media (V4L2/DVB/CEC/IR) utilities and libraries

From v4l-utils 1.32.0-r1 (enterprise-packages), captured 2026-11-08 by running v4l2-compliance --help (exit 1). permalink

Usage:
Common options:
  -d, --device <dev> Use device <dev> as the video device.
                     If <dev> starts with a digit, then /dev/video<dev> is used.
                     Otherwise if -z was specified earlier, then <dev> is the entity name
                     or interface ID (if prefixed with 0x) as found in the topology of the
                     media device with the bus info string as specified by the -z option.
  -V, --vbi-device <dev>
                     Use device <dev> as the vbi device.
                     If <dev> starts with a digit, then /dev/vbi<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -r, --radio-device <dev>
                     Use device <dev> as the radio device.
                     If <dev> starts with a digit, then /dev/radio<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -S, --sdr-device <dev>
                     Use device <dev> as the SDR device.
                     If <dev> starts with a digit, then /dev/swradio<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -t, --touch-device <dev>
                     Use device <dev> as the touch device.
                     If <dev> starts with a digit, then /dev/v4l-touch<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -u, --subdev-device <dev>
                     Use device <dev> as the v4l-subdev device.
                     If <dev> starts with a digit, then /dev/v4l-subdev<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -e, --expbuf-device <dev>
                     Use video device <dev> to obtain DMABUF handles.
                     If <dev> starts with a digit, then /dev/video<dev> is used.
                     See the -d description of how <dev> is used in combination with -z.
  -z, --media-bus-info <bus-info>
                     Find the media device with the given bus info string. If set, then
                     the options above can use the entity name or interface ID to refer
                     to the device nodes.
  -m, --media-device <dev>
                     Use device <dev> as the media controller device. Besides this
                     device it also tests all interfaces it finds.
                     If <dev> starts with a digit, then /dev/media<dev> is used.
                     If <dev> doesn't exist, then attempt to find a media device with a
                     bus info string equal to <dev>.
  -M, --media-device-only <dev>
                     Use device <dev> as the media controller device. Only test this
                     device, don't walk over all the interfaces.
                     If <dev> starts with a digit, then /dev/media<dev> is used.
                     If <dev> doesn't exist, then attempt to find a media device with a
                     bus info string equal to <dev>.
  -s, --streaming <count>
                     Enable the streaming tests. Set <count> to the number of
                     frames to stream (default 60). Requires a valid input/output
                     and frequency (when dealing with a tuner). For DMABUF testing
                     --expbuf-device needs to be set as well.
  --stream-from [<pixelformat>=]<file>
  --stream-from-hdr [<pixelformat>=]<file>
                     Use the contents of the file to fill in output buffers.
                     If the fourcc of the pixelformat is given, then use the file
                     for output buffers using that pixelformat only.
                     The --stream-from-hdr variant uses the format written by
                     v4l2-ctl --stream-to-hdr where the payload sizes for each
                     buffer are stored in a header. Useful for compressed formats.
  -f, --stream-all-formats [<count>]
                     Test streaming all available formats.
                     This attempts to stream using MMAP mode or read/write
                     for one second for all formats, at all sizes, at all intervals
                     and with all field values. If <count> is given, then stream
                     for that many frames instead of one second.
  -a, --stream-all-io
                     Do streaming tests for all inputs or outputs instead of just
                     the current input or output. This requires that a valid video
                     signal is present on all inputs and all outputs are hooked up.
  -c, --stream-all-color color=red|green|blue,skip=<skip>,perc=<percentage>
                     For all formats stream <skip + 1> frames and check if
                     the last frame has at least <perc> percent of the pixels with
                     a <color> component that is higher than the other two color
                     components. This requires that a valid red, green or blue video
                     signal is present on the input(s). If <skip> is not specified,
                     then just capture the first frame. If <perc> is not specified,
                     then this defaults to 90%.
  -E, --exit-on-fail Exit on the first fail.
  -h, --help         Display this help message.
  -C, --color <when> Highlight OK/warn/fail/FAIL strings with colors
                     <when> can be set to always, never, or auto (the default)
  -n, --no-warnings  Turn off warning messages.
  -P, --no-progress  Turn off progress messages.
  -T, --trace        Trace all called ioctls.
  -v, --verbose      Turn on verbose reporting.
  --version          Show version information.
  -w, --wrapper      Use the libv4l2 wrapper library.
  -W, --exit-on-warn Exit on the first warning.
Options (26)
OptionDescriptionSource
-V, --vbi-device devUse device <dev> as the vbi device.help + man
-r, --radio-device devUse device <dev> as the radio device.help + man
-S, --sdr-device devUse device <dev> as the SDR device.help + man
-t, --touch-device devUse device <dev> as the touch device.help + man
-u, --subdev-device devUse device <dev> as the v4l-subdevX device.help + man
-e, --expbuf-device devUse video device <dev> to obtain DMABUF handles.help
-z, --media-bus-info bus-infoFind the media device with the given bus info string.help + man
-m, --media-device devUse device <dev> as the media controller device.help + man
-M, --media-device-only devUse device <dev> as the media controller device.help + man
-s, --streaming countEnable the streaming tests.help + man
--stream-from pixelformat>=]<filehelp
--stream-from-hdr pixelformat>=]<fileUse the contents of the file to fill in output buffers.help
-f, --stream-all-formats countTest streaming all available formats.help
-a, --stream-all-ioDo the -s, -c and -f streaming tests for all inputs or outputs instead of just the current input or output.help + man
-c, --stream-all-color color=red|green|blueFor all formats stream <skip + 1> frames and check if the last frame has at least <perc> percent of the pixels with a <color> component that is higher than the other two color components.help + man
-h, --helpDisplay this help message.help + man
-n, --no-warningsTurn off warning messages.help + man
-P, --no-progressTurn off progress messages.help + man
-T, --traceTrace all called ioctls.help + man
-v, --verboseTurn on verbose reporting.help + man
--versionShow version information.help + man
-w, --wrapperUse the libv4l2 wrapper library for all V4L2 device accesses.help + man
-d, --device devUse device <dev> as the video device. (in the manual page but not in --help)man
-E, --exit-on-failExit this application when the first failure occurs instead of continuing with a possible inconsistent state. (in the manual page but not in --help)man
-C, --color whenHighlight OK/warn/fail/FAIL strings with colors. (in the manual page but not in --help)man
-W, --exit-on-warnExit this application when the first warning occurs instead of continuing. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.