1V4L2-CTL(1)                      User Commands                     V4L2-CTL(1)
2
3
4

NAME

6       v4l2-ctl - An application to control video4linux drivers
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

18       -d, --device <dev>
19              Use  device <dev> as the V4L2 device. If <dev> is a number, then
20              /dev/video<dev> is used.
21
22       -v, --verbose
23              Turn on verbose reporting.
24
25       -w, --wrapper
26              Use the libv4l2 wrapper library for all V4L2 device accesses. By
27              default  v4l2-ctl will directly access the V4L2 device, but with
28              this option all access will go via this wrapper library.
29
30       -h, --help
31              Prints the help message.
32
33       --help-io
34              Prints the help message for all options that get/set/list inputs
35              and outputs, both video and audio.
36
37       --help-misc
38              Prints the help message for miscellaneous options.
39
40       --help-overlay
41              Prints  the help message for all options that get/set/list over‐
42              lay and framebuffer formats.
43
44       --help-sdr
45              Prints the help message for all options that get/set/list  soft‐
46              ware defined radio formats.
47
48       --help-selection
49              Prints  the  help  message for all options that deal with selec‐
50              tions (cropping and composing).
51
52       --help-stds
53              Prints the help message for all  options  that  deal  with  SDTV
54              standards and Digital Video timings.
55
56       --help-streaming
57              Prints  the  help message for all options that deal with stream‐
58              ing.
59
60       --help-subdev
61              Prints the help message for all options that deal with  v4l-sub‐
62              devX devices.
63
64       --help-tuner
65              Prints  the  help  message for all options that deal with tuners
66              and modulators.
67
68       --help-vbi
69              Prints the help message for all options  that  get/set/list  VBI
70              formats.
71
72       --help-vidcap
73              Prints  the help message for all options that get/set/list video
74              capture formats.
75
76       --help-vidout
77              Prints the help message for all options that get/set/list  video
78              output formats.
79
80       --help-edid
81              Prints the help message for all options that get/set EDIDs.
82
83       --help-all
84              Prints the help message for all options.
85
86       --all  Display all information available.
87
88       -C, --get-ctrl <ctrl>[,<ctrl>...]
89              Get the value of the controls [VIDIOC_G_EXT_CTRLS].
90
91       -c, --set-ctrl <ctrl>=<val>[,<ctrl>=<val>...]
92              Set the value of the controls [VIDIOC_S_EXT_CTRLS].
93
94       -D, --info
95              Show driver info [VIDIOC_QUERYCAP].
96
97       -e, --out-device <dev>
98              Use  device  <dev>  for  output  streams  instead of the default
99              device as set with --device. If <dev> starts with a digit,  then
100              /dev/video<dev> is used.
101
102       -k, --concise
103              Be more concise if possible.
104
105       -l, --list-ctrls
106              Display all controls and their values [VIDIOC_QUERYCTRL].
107
108       -L, --list-ctrls-menus
109              Display all controls and their menus [VIDIOC_QUERYMENU].
110
111       -r, --subset <ctrl>[,<offset>,<size>]+
112              The  subset  of  the  N-dimensional array to get/set for control
113              <ctrl>, for every  dimension  an  (<offset>,  <size>)  tuple  is
114              given.
115
116       --list-devices
117              List all v4l devices.
118
119       --log-status
120              Log the board status in the kernel log [VIDIOC_LOG_STATUS].
121
122       --get-priority
123              Query the current access priority [VIDIOC_G_PRIORITY].
124
125       --set-priority <prio>
126              Set  the  new  access priority [VIDIOC_S_PRIORITY].  <prio> is 1
127              (background), 2 (interactive) or 3 (record).
128
129       --silent
130              Only set the result code, do not print any messages.
131
132       --sleep <secs>
133              Sleep <secs>, call QUERYCAP and close the file handle.
134

EXIT STATUS

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

BUGS

139       This manual page is a work in progress.
140
141       Bug reports or questions about this  utility  should  be  sent  to  the
142       linux-media@vger.kernel.org mailinglist.
143
144
145
146v4l-utils 1.16.3                  March 2015                       V4L2-CTL(1)
Impressum