v4l2-ctl man page

v4l2-ctl — An application to control video4linux drivers

Synopsis

v4l2-ctl [-h] [-d <dev>] [many other options]

Description

The v4l2-ctl tool is used to control video4linux devices, either video, vbi, radio or swradio, both input and output. It is able to control almost any aspect of such devices covering the full V4L2 API.

Options

-d, --device=<dev>

Use device <dev> as the V4L2 device. If <dev> is a number, then /dev/video<dev> is used.

-v, --verbose

Turn on verbose reporting.

-w, --wrapper

Use the libv4l2 wrapper library for all V4L2 device accesses. By default v4l2-ctl will directly access the V4L2 device, but with this option all access will go via this wrapper library.

-h, --help

Prints the help message.

--help-io

Prints the help message for all options that get/set/list inputs and outputs, both video and audio.

--help-misc

Prints the help message for miscellaneous options.

--help-overlay

Prints the help message for all options that get/set/list overlay and framebuffer formats.

--help-sdr

Prints the help message for all options that get/set/list software defined radio formats.

--help-selection

Prints the help message for all options that deal with selections (cropping and composing).

--help-stds

Prints the help message for all options that deal with SDTV standards and Digital Video timings.

--help-streaming

Prints the help message for all options that deal with streaming.

--help-tuner

Prints the help message for all options that deal with tuners and modulators.

--help-vbi

Prints the help message for all options that get/set/list VBI formats.

--help-vidcap

Prints the help message for all options that get/set/list video capture formats.

--help-vidout

Prints the help message for all options that get/set/list video output formats.

--help-edid

Prints the help message for all options that get/set EDIDs.

--help-all

Prints the help message for all options.

--all

Display all information available.

-C, --get-ctrl=<ctrl>[,<ctrl>...]

Get the value of the controls [VIDIOC_G_EXT_CTRLS].

-c, --set-ctrl=<ctrl>=<val>[,<ctrl>=<val>...]

Set the value of the controls [VIDIOC_S_EXT_CTRLS].

-D, --info

Show driver info [VIDIOC_QUERYCAP].

-e, --out-device=<dev>

Use device <dev> for output streams instead of the default device as set with --device. If <dev> starts with a digit, then /dev/video<dev> is used.

-k, --concise

Be more concise if possible.

-l, --list-ctrls

Display all controls and their values [VIDIOC_QUERYCTRL].

-L, --list-ctrls-menus

Display all controls and their menus [VIDIOC_QUERYMENU].

-r, --subset=<ctrl>[,<offset>,<size>]+

The subset of the N-dimensional array to get/set for control <ctrl>, for every dimension an (<offset>, <size>) tuple is given.

--list-devices

List all v4l devices.

--log-status

Log the board status in the kernel log [VIDIOC_LOG_STATUS].

--get-priority

Query the current access priority [VIDIOC_G_PRIORITY].

--set-priority=<prio>

Set the new access priority [VIDIOC_S_PRIORITY]. <prio> is 1 (background), 2 (interactive) or 3 (record).

--silent

Only set the result code, do not print any messages.

--sleep=<secs>

Sleep <secs>, call QUERYCAP and close the file handle.

Exit Status

On success, it returns 0. Otherwise, it will return the error code.

Bugs

This manual page is a work in progress.

Bug reports or questions about this utility should be sent to the linux-media@vger.kernel.org mailinglist.

Info

March 2015 v4l-utils 1.12.5 User Commands