Loading...
1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 *
4 * V 4 L 2 D R I V E R H E L P E R A P I
5 *
6 * Moved from videodev2.h
7 *
8 * Some commonly needed functions for drivers (v4l2-common.o module)
9 */
10#ifndef _V4L2_IOCTL_H
11#define _V4L2_IOCTL_H
12
13#include <linux/poll.h>
14#include <linux/fs.h>
15#include <linux/mutex.h>
16#include <linux/sched/signal.h>
17#include <linux/compiler.h> /* need __user */
18#include <linux/videodev2.h>
19
20struct v4l2_fh;
21
22/**
23 * struct v4l2_ioctl_ops - describe operations for each V4L2 ioctl
24 *
25 * @vidioc_querycap: pointer to the function that implements
26 * :ref:`VIDIOC_QUERYCAP <vidioc_querycap>` ioctl
27 * @vidioc_enum_fmt_vid_cap: pointer to the function that implements
28 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
29 * for video capture in single and multi plane mode
30 * @vidioc_enum_fmt_vid_overlay: pointer to the function that implements
31 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
32 * for video overlay
33 * @vidioc_enum_fmt_vid_out: pointer to the function that implements
34 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
35 * for video output in single and multi plane mode
36 * @vidioc_enum_fmt_sdr_cap: pointer to the function that implements
37 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
38 * for Software Defined Radio capture
39 * @vidioc_enum_fmt_sdr_out: pointer to the function that implements
40 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
41 * for Software Defined Radio output
42 * @vidioc_enum_fmt_meta_cap: pointer to the function that implements
43 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
44 * for metadata capture
45 * @vidioc_enum_fmt_meta_out: pointer to the function that implements
46 * :ref:`VIDIOC_ENUM_FMT <vidioc_enum_fmt>` ioctl logic
47 * for metadata output
48 * @vidioc_g_fmt_vid_cap: pointer to the function that implements
49 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video capture
50 * in single plane mode
51 * @vidioc_g_fmt_vid_overlay: pointer to the function that implements
52 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video overlay
53 * @vidioc_g_fmt_vid_out: pointer to the function that implements
54 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video out
55 * in single plane mode
56 * @vidioc_g_fmt_vid_out_overlay: pointer to the function that implements
57 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video overlay output
58 * @vidioc_g_fmt_vbi_cap: pointer to the function that implements
59 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for raw VBI capture
60 * @vidioc_g_fmt_vbi_out: pointer to the function that implements
61 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for raw VBI output
62 * @vidioc_g_fmt_sliced_vbi_cap: pointer to the function that implements
63 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI capture
64 * @vidioc_g_fmt_sliced_vbi_out: pointer to the function that implements
65 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI output
66 * @vidioc_g_fmt_vid_cap_mplane: pointer to the function that implements
67 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video capture
68 * in multiple plane mode
69 * @vidioc_g_fmt_vid_out_mplane: pointer to the function that implements
70 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for video out
71 * in multiplane plane mode
72 * @vidioc_g_fmt_sdr_cap: pointer to the function that implements
73 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
74 * Radio capture
75 * @vidioc_g_fmt_sdr_out: pointer to the function that implements
76 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
77 * Radio output
78 * @vidioc_g_fmt_meta_cap: pointer to the function that implements
79 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for metadata capture
80 * @vidioc_g_fmt_meta_out: pointer to the function that implements
81 * :ref:`VIDIOC_G_FMT <vidioc_g_fmt>` ioctl logic for metadata output
82 * @vidioc_s_fmt_vid_cap: pointer to the function that implements
83 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video capture
84 * in single plane mode
85 * @vidioc_s_fmt_vid_overlay: pointer to the function that implements
86 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video overlay
87 * @vidioc_s_fmt_vid_out: pointer to the function that implements
88 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video out
89 * in single plane mode
90 * @vidioc_s_fmt_vid_out_overlay: pointer to the function that implements
91 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video overlay output
92 * @vidioc_s_fmt_vbi_cap: pointer to the function that implements
93 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for raw VBI capture
94 * @vidioc_s_fmt_vbi_out: pointer to the function that implements
95 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for raw VBI output
96 * @vidioc_s_fmt_sliced_vbi_cap: pointer to the function that implements
97 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI capture
98 * @vidioc_s_fmt_sliced_vbi_out: pointer to the function that implements
99 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI output
100 * @vidioc_s_fmt_vid_cap_mplane: pointer to the function that implements
101 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video capture
102 * in multiple plane mode
103 * @vidioc_s_fmt_vid_out_mplane: pointer to the function that implements
104 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for video out
105 * in multiplane plane mode
106 * @vidioc_s_fmt_sdr_cap: pointer to the function that implements
107 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
108 * Radio capture
109 * @vidioc_s_fmt_sdr_out: pointer to the function that implements
110 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
111 * Radio output
112 * @vidioc_s_fmt_meta_cap: pointer to the function that implements
113 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for metadata capture
114 * @vidioc_s_fmt_meta_out: pointer to the function that implements
115 * :ref:`VIDIOC_S_FMT <vidioc_g_fmt>` ioctl logic for metadata output
116 * @vidioc_try_fmt_vid_cap: pointer to the function that implements
117 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video capture
118 * in single plane mode
119 * @vidioc_try_fmt_vid_overlay: pointer to the function that implements
120 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video overlay
121 * @vidioc_try_fmt_vid_out: pointer to the function that implements
122 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video out
123 * in single plane mode
124 * @vidioc_try_fmt_vid_out_overlay: pointer to the function that implements
125 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video overlay
126 * output
127 * @vidioc_try_fmt_vbi_cap: pointer to the function that implements
128 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for raw VBI capture
129 * @vidioc_try_fmt_vbi_out: pointer to the function that implements
130 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for raw VBI output
131 * @vidioc_try_fmt_sliced_vbi_cap: pointer to the function that implements
132 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI
133 * capture
134 * @vidioc_try_fmt_sliced_vbi_out: pointer to the function that implements
135 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for sliced VBI output
136 * @vidioc_try_fmt_vid_cap_mplane: pointer to the function that implements
137 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video capture
138 * in multiple plane mode
139 * @vidioc_try_fmt_vid_out_mplane: pointer to the function that implements
140 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for video out
141 * in multiplane plane mode
142 * @vidioc_try_fmt_sdr_cap: pointer to the function that implements
143 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
144 * Radio capture
145 * @vidioc_try_fmt_sdr_out: pointer to the function that implements
146 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for Software Defined
147 * Radio output
148 * @vidioc_try_fmt_meta_cap: pointer to the function that implements
149 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for metadata capture
150 * @vidioc_try_fmt_meta_out: pointer to the function that implements
151 * :ref:`VIDIOC_TRY_FMT <vidioc_g_fmt>` ioctl logic for metadata output
152 * @vidioc_reqbufs: pointer to the function that implements
153 * :ref:`VIDIOC_REQBUFS <vidioc_reqbufs>` ioctl
154 * @vidioc_querybuf: pointer to the function that implements
155 * :ref:`VIDIOC_QUERYBUF <vidioc_querybuf>` ioctl
156 * @vidioc_qbuf: pointer to the function that implements
157 * :ref:`VIDIOC_QBUF <vidioc_qbuf>` ioctl
158 * @vidioc_expbuf: pointer to the function that implements
159 * :ref:`VIDIOC_EXPBUF <vidioc_expbuf>` ioctl
160 * @vidioc_dqbuf: pointer to the function that implements
161 * :ref:`VIDIOC_DQBUF <vidioc_qbuf>` ioctl
162 * @vidioc_create_bufs: pointer to the function that implements
163 * :ref:`VIDIOC_CREATE_BUFS <vidioc_create_bufs>` ioctl
164 * @vidioc_prepare_buf: pointer to the function that implements
165 * :ref:`VIDIOC_PREPARE_BUF <vidioc_prepare_buf>` ioctl
166 * @vidioc_remove_bufs: pointer to the function that implements
167 * :ref:`VIDIOC_REMOVE_BUFS <vidioc_remove_bufs>` ioctl
168 * @vidioc_overlay: pointer to the function that implements
169 * :ref:`VIDIOC_OVERLAY <vidioc_overlay>` ioctl
170 * @vidioc_g_fbuf: pointer to the function that implements
171 * :ref:`VIDIOC_G_FBUF <vidioc_g_fbuf>` ioctl
172 * @vidioc_s_fbuf: pointer to the function that implements
173 * :ref:`VIDIOC_S_FBUF <vidioc_g_fbuf>` ioctl
174 * @vidioc_streamon: pointer to the function that implements
175 * :ref:`VIDIOC_STREAMON <vidioc_streamon>` ioctl
176 * @vidioc_streamoff: pointer to the function that implements
177 * :ref:`VIDIOC_STREAMOFF <vidioc_streamon>` ioctl
178 * @vidioc_g_std: pointer to the function that implements
179 * :ref:`VIDIOC_G_STD <vidioc_g_std>` ioctl
180 * @vidioc_s_std: pointer to the function that implements
181 * :ref:`VIDIOC_S_STD <vidioc_g_std>` ioctl
182 * @vidioc_querystd: pointer to the function that implements
183 * :ref:`VIDIOC_QUERYSTD <vidioc_querystd>` ioctl
184 * @vidioc_enum_input: pointer to the function that implements
185 * :ref:`VIDIOC_ENUM_INPUT <vidioc_g_input>` ioctl
186 * @vidioc_g_input: pointer to the function that implements
187 * :ref:`VIDIOC_G_INPUT <vidioc_g_input>` ioctl
188 * @vidioc_s_input: pointer to the function that implements
189 * :ref:`VIDIOC_S_INPUT <vidioc_g_input>` ioctl
190 * @vidioc_enum_output: pointer to the function that implements
191 * :ref:`VIDIOC_ENUM_OUTPUT <vidioc_g_output>` ioctl
192 * @vidioc_g_output: pointer to the function that implements
193 * :ref:`VIDIOC_G_OUTPUT <vidioc_g_output>` ioctl
194 * @vidioc_s_output: pointer to the function that implements
195 * :ref:`VIDIOC_S_OUTPUT <vidioc_g_output>` ioctl
196 * @vidioc_queryctrl: pointer to the function that implements
197 * :ref:`VIDIOC_QUERYCTRL <vidioc_queryctrl>` ioctl
198 * @vidioc_query_ext_ctrl: pointer to the function that implements
199 * :ref:`VIDIOC_QUERY_EXT_CTRL <vidioc_queryctrl>` ioctl
200 * @vidioc_g_ctrl: pointer to the function that implements
201 * :ref:`VIDIOC_G_CTRL <vidioc_g_ctrl>` ioctl
202 * @vidioc_s_ctrl: pointer to the function that implements
203 * :ref:`VIDIOC_S_CTRL <vidioc_g_ctrl>` ioctl
204 * @vidioc_g_ext_ctrls: pointer to the function that implements
205 * :ref:`VIDIOC_G_EXT_CTRLS <vidioc_g_ext_ctrls>` ioctl
206 * @vidioc_s_ext_ctrls: pointer to the function that implements
207 * :ref:`VIDIOC_S_EXT_CTRLS <vidioc_g_ext_ctrls>` ioctl
208 * @vidioc_try_ext_ctrls: pointer to the function that implements
209 * :ref:`VIDIOC_TRY_EXT_CTRLS <vidioc_g_ext_ctrls>` ioctl
210 * @vidioc_querymenu: pointer to the function that implements
211 * :ref:`VIDIOC_QUERYMENU <vidioc_queryctrl>` ioctl
212 * @vidioc_enumaudio: pointer to the function that implements
213 * :ref:`VIDIOC_ENUMAUDIO <vidioc_enumaudio>` ioctl
214 * @vidioc_g_audio: pointer to the function that implements
215 * :ref:`VIDIOC_G_AUDIO <vidioc_g_audio>` ioctl
216 * @vidioc_s_audio: pointer to the function that implements
217 * :ref:`VIDIOC_S_AUDIO <vidioc_g_audio>` ioctl
218 * @vidioc_enumaudout: pointer to the function that implements
219 * :ref:`VIDIOC_ENUMAUDOUT <vidioc_enumaudout>` ioctl
220 * @vidioc_g_audout: pointer to the function that implements
221 * :ref:`VIDIOC_G_AUDOUT <vidioc_g_audout>` ioctl
222 * @vidioc_s_audout: pointer to the function that implements
223 * :ref:`VIDIOC_S_AUDOUT <vidioc_g_audout>` ioctl
224 * @vidioc_g_modulator: pointer to the function that implements
225 * :ref:`VIDIOC_G_MODULATOR <vidioc_g_modulator>` ioctl
226 * @vidioc_s_modulator: pointer to the function that implements
227 * :ref:`VIDIOC_S_MODULATOR <vidioc_g_modulator>` ioctl
228 * @vidioc_g_pixelaspect: pointer to the function that implements
229 * the pixelaspect part of the :ref:`VIDIOC_CROPCAP <vidioc_cropcap>` ioctl
230 * @vidioc_g_selection: pointer to the function that implements
231 * :ref:`VIDIOC_G_SELECTION <vidioc_g_selection>` ioctl
232 * @vidioc_s_selection: pointer to the function that implements
233 * :ref:`VIDIOC_S_SELECTION <vidioc_g_selection>` ioctl
234 * @vidioc_g_jpegcomp: pointer to the function that implements
235 * :ref:`VIDIOC_G_JPEGCOMP <vidioc_g_jpegcomp>` ioctl
236 * @vidioc_s_jpegcomp: pointer to the function that implements
237 * :ref:`VIDIOC_S_JPEGCOMP <vidioc_g_jpegcomp>` ioctl
238 * @vidioc_g_enc_index: pointer to the function that implements
239 * :ref:`VIDIOC_G_ENC_INDEX <vidioc_g_enc_index>` ioctl
240 * @vidioc_encoder_cmd: pointer to the function that implements
241 * :ref:`VIDIOC_ENCODER_CMD <vidioc_encoder_cmd>` ioctl
242 * @vidioc_try_encoder_cmd: pointer to the function that implements
243 * :ref:`VIDIOC_TRY_ENCODER_CMD <vidioc_encoder_cmd>` ioctl
244 * @vidioc_decoder_cmd: pointer to the function that implements
245 * :ref:`VIDIOC_DECODER_CMD <vidioc_decoder_cmd>` ioctl
246 * @vidioc_try_decoder_cmd: pointer to the function that implements
247 * :ref:`VIDIOC_TRY_DECODER_CMD <vidioc_decoder_cmd>` ioctl
248 * @vidioc_g_parm: pointer to the function that implements
249 * :ref:`VIDIOC_G_PARM <vidioc_g_parm>` ioctl
250 * @vidioc_s_parm: pointer to the function that implements
251 * :ref:`VIDIOC_S_PARM <vidioc_g_parm>` ioctl
252 * @vidioc_g_tuner: pointer to the function that implements
253 * :ref:`VIDIOC_G_TUNER <vidioc_g_tuner>` ioctl
254 * @vidioc_s_tuner: pointer to the function that implements
255 * :ref:`VIDIOC_S_TUNER <vidioc_g_tuner>` ioctl
256 * @vidioc_g_frequency: pointer to the function that implements
257 * :ref:`VIDIOC_G_FREQUENCY <vidioc_g_frequency>` ioctl
258 * @vidioc_s_frequency: pointer to the function that implements
259 * :ref:`VIDIOC_S_FREQUENCY <vidioc_g_frequency>` ioctl
260 * @vidioc_enum_freq_bands: pointer to the function that implements
261 * :ref:`VIDIOC_ENUM_FREQ_BANDS <vidioc_enum_freq_bands>` ioctl
262 * @vidioc_g_sliced_vbi_cap: pointer to the function that implements
263 * :ref:`VIDIOC_G_SLICED_VBI_CAP <vidioc_g_sliced_vbi_cap>` ioctl
264 * @vidioc_log_status: pointer to the function that implements
265 * :ref:`VIDIOC_LOG_STATUS <vidioc_log_status>` ioctl
266 * @vidioc_s_hw_freq_seek: pointer to the function that implements
267 * :ref:`VIDIOC_S_HW_FREQ_SEEK <vidioc_s_hw_freq_seek>` ioctl
268 * @vidioc_g_register: pointer to the function that implements
269 * :ref:`VIDIOC_DBG_G_REGISTER <vidioc_dbg_g_register>` ioctl
270 * @vidioc_s_register: pointer to the function that implements
271 * :ref:`VIDIOC_DBG_S_REGISTER <vidioc_dbg_g_register>` ioctl
272 * @vidioc_g_chip_info: pointer to the function that implements
273 * :ref:`VIDIOC_DBG_G_CHIP_INFO <vidioc_dbg_g_chip_info>` ioctl
274 * @vidioc_enum_framesizes: pointer to the function that implements
275 * :ref:`VIDIOC_ENUM_FRAMESIZES <vidioc_enum_framesizes>` ioctl
276 * @vidioc_enum_frameintervals: pointer to the function that implements
277 * :ref:`VIDIOC_ENUM_FRAMEINTERVALS <vidioc_enum_frameintervals>` ioctl
278 * @vidioc_s_dv_timings: pointer to the function that implements
279 * :ref:`VIDIOC_S_DV_TIMINGS <vidioc_g_dv_timings>` ioctl
280 * @vidioc_g_dv_timings: pointer to the function that implements
281 * :ref:`VIDIOC_G_DV_TIMINGS <vidioc_g_dv_timings>` ioctl
282 * @vidioc_query_dv_timings: pointer to the function that implements
283 * :ref:`VIDIOC_QUERY_DV_TIMINGS <vidioc_query_dv_timings>` ioctl
284 * @vidioc_enum_dv_timings: pointer to the function that implements
285 * :ref:`VIDIOC_ENUM_DV_TIMINGS <vidioc_enum_dv_timings>` ioctl
286 * @vidioc_dv_timings_cap: pointer to the function that implements
287 * :ref:`VIDIOC_DV_TIMINGS_CAP <vidioc_dv_timings_cap>` ioctl
288 * @vidioc_g_edid: pointer to the function that implements
289 * :ref:`VIDIOC_G_EDID <vidioc_g_edid>` ioctl
290 * @vidioc_s_edid: pointer to the function that implements
291 * :ref:`VIDIOC_S_EDID <vidioc_g_edid>` ioctl
292 * @vidioc_subscribe_event: pointer to the function that implements
293 * :ref:`VIDIOC_SUBSCRIBE_EVENT <vidioc_subscribe_event>` ioctl
294 * @vidioc_unsubscribe_event: pointer to the function that implements
295 * :ref:`VIDIOC_UNSUBSCRIBE_EVENT <vidioc_unsubscribe_event>` ioctl
296 * @vidioc_default: pointed used to allow other ioctls
297 */
298struct v4l2_ioctl_ops {
299 /* ioctl callbacks */
300
301 /* VIDIOC_QUERYCAP handler */
302 int (*vidioc_querycap)(struct file *file, void *fh,
303 struct v4l2_capability *cap);
304
305 /* VIDIOC_ENUM_FMT handlers */
306 int (*vidioc_enum_fmt_vid_cap)(struct file *file, void *fh,
307 struct v4l2_fmtdesc *f);
308 int (*vidioc_enum_fmt_vid_overlay)(struct file *file, void *fh,
309 struct v4l2_fmtdesc *f);
310 int (*vidioc_enum_fmt_vid_out)(struct file *file, void *fh,
311 struct v4l2_fmtdesc *f);
312 int (*vidioc_enum_fmt_sdr_cap)(struct file *file, void *fh,
313 struct v4l2_fmtdesc *f);
314 int (*vidioc_enum_fmt_sdr_out)(struct file *file, void *fh,
315 struct v4l2_fmtdesc *f);
316 int (*vidioc_enum_fmt_meta_cap)(struct file *file, void *fh,
317 struct v4l2_fmtdesc *f);
318 int (*vidioc_enum_fmt_meta_out)(struct file *file, void *fh,
319 struct v4l2_fmtdesc *f);
320
321 /* VIDIOC_G_FMT handlers */
322 int (*vidioc_g_fmt_vid_cap)(struct file *file, void *fh,
323 struct v4l2_format *f);
324 int (*vidioc_g_fmt_vid_overlay)(struct file *file, void *fh,
325 struct v4l2_format *f);
326 int (*vidioc_g_fmt_vid_out)(struct file *file, void *fh,
327 struct v4l2_format *f);
328 int (*vidioc_g_fmt_vid_out_overlay)(struct file *file, void *fh,
329 struct v4l2_format *f);
330 int (*vidioc_g_fmt_vbi_cap)(struct file *file, void *fh,
331 struct v4l2_format *f);
332 int (*vidioc_g_fmt_vbi_out)(struct file *file, void *fh,
333 struct v4l2_format *f);
334 int (*vidioc_g_fmt_sliced_vbi_cap)(struct file *file, void *fh,
335 struct v4l2_format *f);
336 int (*vidioc_g_fmt_sliced_vbi_out)(struct file *file, void *fh,
337 struct v4l2_format *f);
338 int (*vidioc_g_fmt_vid_cap_mplane)(struct file *file, void *fh,
339 struct v4l2_format *f);
340 int (*vidioc_g_fmt_vid_out_mplane)(struct file *file, void *fh,
341 struct v4l2_format *f);
342 int (*vidioc_g_fmt_sdr_cap)(struct file *file, void *fh,
343 struct v4l2_format *f);
344 int (*vidioc_g_fmt_sdr_out)(struct file *file, void *fh,
345 struct v4l2_format *f);
346 int (*vidioc_g_fmt_meta_cap)(struct file *file, void *fh,
347 struct v4l2_format *f);
348 int (*vidioc_g_fmt_meta_out)(struct file *file, void *fh,
349 struct v4l2_format *f);
350
351 /* VIDIOC_S_FMT handlers */
352 int (*vidioc_s_fmt_vid_cap)(struct file *file, void *fh,
353 struct v4l2_format *f);
354 int (*vidioc_s_fmt_vid_overlay)(struct file *file, void *fh,
355 struct v4l2_format *f);
356 int (*vidioc_s_fmt_vid_out)(struct file *file, void *fh,
357 struct v4l2_format *f);
358 int (*vidioc_s_fmt_vid_out_overlay)(struct file *file, void *fh,
359 struct v4l2_format *f);
360 int (*vidioc_s_fmt_vbi_cap)(struct file *file, void *fh,
361 struct v4l2_format *f);
362 int (*vidioc_s_fmt_vbi_out)(struct file *file, void *fh,
363 struct v4l2_format *f);
364 int (*vidioc_s_fmt_sliced_vbi_cap)(struct file *file, void *fh,
365 struct v4l2_format *f);
366 int (*vidioc_s_fmt_sliced_vbi_out)(struct file *file, void *fh,
367 struct v4l2_format *f);
368 int (*vidioc_s_fmt_vid_cap_mplane)(struct file *file, void *fh,
369 struct v4l2_format *f);
370 int (*vidioc_s_fmt_vid_out_mplane)(struct file *file, void *fh,
371 struct v4l2_format *f);
372 int (*vidioc_s_fmt_sdr_cap)(struct file *file, void *fh,
373 struct v4l2_format *f);
374 int (*vidioc_s_fmt_sdr_out)(struct file *file, void *fh,
375 struct v4l2_format *f);
376 int (*vidioc_s_fmt_meta_cap)(struct file *file, void *fh,
377 struct v4l2_format *f);
378 int (*vidioc_s_fmt_meta_out)(struct file *file, void *fh,
379 struct v4l2_format *f);
380
381 /* VIDIOC_TRY_FMT handlers */
382 int (*vidioc_try_fmt_vid_cap)(struct file *file, void *fh,
383 struct v4l2_format *f);
384 int (*vidioc_try_fmt_vid_overlay)(struct file *file, void *fh,
385 struct v4l2_format *f);
386 int (*vidioc_try_fmt_vid_out)(struct file *file, void *fh,
387 struct v4l2_format *f);
388 int (*vidioc_try_fmt_vid_out_overlay)(struct file *file, void *fh,
389 struct v4l2_format *f);
390 int (*vidioc_try_fmt_vbi_cap)(struct file *file, void *fh,
391 struct v4l2_format *f);
392 int (*vidioc_try_fmt_vbi_out)(struct file *file, void *fh,
393 struct v4l2_format *f);
394 int (*vidioc_try_fmt_sliced_vbi_cap)(struct file *file, void *fh,
395 struct v4l2_format *f);
396 int (*vidioc_try_fmt_sliced_vbi_out)(struct file *file, void *fh,
397 struct v4l2_format *f);
398 int (*vidioc_try_fmt_vid_cap_mplane)(struct file *file, void *fh,
399 struct v4l2_format *f);
400 int (*vidioc_try_fmt_vid_out_mplane)(struct file *file, void *fh,
401 struct v4l2_format *f);
402 int (*vidioc_try_fmt_sdr_cap)(struct file *file, void *fh,
403 struct v4l2_format *f);
404 int (*vidioc_try_fmt_sdr_out)(struct file *file, void *fh,
405 struct v4l2_format *f);
406 int (*vidioc_try_fmt_meta_cap)(struct file *file, void *fh,
407 struct v4l2_format *f);
408 int (*vidioc_try_fmt_meta_out)(struct file *file, void *fh,
409 struct v4l2_format *f);
410
411 /* Buffer handlers */
412 int (*vidioc_reqbufs)(struct file *file, void *fh,
413 struct v4l2_requestbuffers *b);
414 int (*vidioc_querybuf)(struct file *file, void *fh,
415 struct v4l2_buffer *b);
416 int (*vidioc_qbuf)(struct file *file, void *fh,
417 struct v4l2_buffer *b);
418 int (*vidioc_expbuf)(struct file *file, void *fh,
419 struct v4l2_exportbuffer *e);
420 int (*vidioc_dqbuf)(struct file *file, void *fh,
421 struct v4l2_buffer *b);
422
423 int (*vidioc_create_bufs)(struct file *file, void *fh,
424 struct v4l2_create_buffers *b);
425 int (*vidioc_prepare_buf)(struct file *file, void *fh,
426 struct v4l2_buffer *b);
427 int (*vidioc_remove_bufs)(struct file *file, void *fh,
428 struct v4l2_remove_buffers *d);
429
430 int (*vidioc_overlay)(struct file *file, void *fh, unsigned int i);
431 int (*vidioc_g_fbuf)(struct file *file, void *fh,
432 struct v4l2_framebuffer *a);
433 int (*vidioc_s_fbuf)(struct file *file, void *fh,
434 const struct v4l2_framebuffer *a);
435
436 /* Stream on/off */
437 int (*vidioc_streamon)(struct file *file, void *fh,
438 enum v4l2_buf_type i);
439 int (*vidioc_streamoff)(struct file *file, void *fh,
440 enum v4l2_buf_type i);
441
442 /*
443 * Standard handling
444 *
445 * Note: ENUMSTD is handled by videodev.c
446 */
447 int (*vidioc_g_std)(struct file *file, void *fh, v4l2_std_id *norm);
448 int (*vidioc_s_std)(struct file *file, void *fh, v4l2_std_id norm);
449 int (*vidioc_querystd)(struct file *file, void *fh, v4l2_std_id *a);
450
451 /* Input handling */
452 int (*vidioc_enum_input)(struct file *file, void *fh,
453 struct v4l2_input *inp);
454 int (*vidioc_g_input)(struct file *file, void *fh, unsigned int *i);
455 int (*vidioc_s_input)(struct file *file, void *fh, unsigned int i);
456
457 /* Output handling */
458 int (*vidioc_enum_output)(struct file *file, void *fh,
459 struct v4l2_output *a);
460 int (*vidioc_g_output)(struct file *file, void *fh, unsigned int *i);
461 int (*vidioc_s_output)(struct file *file, void *fh, unsigned int i);
462
463 /* Control handling */
464 int (*vidioc_queryctrl)(struct file *file, void *fh,
465 struct v4l2_queryctrl *a);
466 int (*vidioc_query_ext_ctrl)(struct file *file, void *fh,
467 struct v4l2_query_ext_ctrl *a);
468 int (*vidioc_g_ctrl)(struct file *file, void *fh,
469 struct v4l2_control *a);
470 int (*vidioc_s_ctrl)(struct file *file, void *fh,
471 struct v4l2_control *a);
472 int (*vidioc_g_ext_ctrls)(struct file *file, void *fh,
473 struct v4l2_ext_controls *a);
474 int (*vidioc_s_ext_ctrls)(struct file *file, void *fh,
475 struct v4l2_ext_controls *a);
476 int (*vidioc_try_ext_ctrls)(struct file *file, void *fh,
477 struct v4l2_ext_controls *a);
478 int (*vidioc_querymenu)(struct file *file, void *fh,
479 struct v4l2_querymenu *a);
480
481 /* Audio ioctls */
482 int (*vidioc_enumaudio)(struct file *file, void *fh,
483 struct v4l2_audio *a);
484 int (*vidioc_g_audio)(struct file *file, void *fh,
485 struct v4l2_audio *a);
486 int (*vidioc_s_audio)(struct file *file, void *fh,
487 const struct v4l2_audio *a);
488
489 /* Audio out ioctls */
490 int (*vidioc_enumaudout)(struct file *file, void *fh,
491 struct v4l2_audioout *a);
492 int (*vidioc_g_audout)(struct file *file, void *fh,
493 struct v4l2_audioout *a);
494 int (*vidioc_s_audout)(struct file *file, void *fh,
495 const struct v4l2_audioout *a);
496 int (*vidioc_g_modulator)(struct file *file, void *fh,
497 struct v4l2_modulator *a);
498 int (*vidioc_s_modulator)(struct file *file, void *fh,
499 const struct v4l2_modulator *a);
500 /* Crop ioctls */
501 int (*vidioc_g_pixelaspect)(struct file *file, void *fh,
502 int buf_type, struct v4l2_fract *aspect);
503 int (*vidioc_g_selection)(struct file *file, void *fh,
504 struct v4l2_selection *s);
505 int (*vidioc_s_selection)(struct file *file, void *fh,
506 struct v4l2_selection *s);
507 /* Compression ioctls */
508 int (*vidioc_g_jpegcomp)(struct file *file, void *fh,
509 struct v4l2_jpegcompression *a);
510 int (*vidioc_s_jpegcomp)(struct file *file, void *fh,
511 const struct v4l2_jpegcompression *a);
512 int (*vidioc_g_enc_index)(struct file *file, void *fh,
513 struct v4l2_enc_idx *a);
514 int (*vidioc_encoder_cmd)(struct file *file, void *fh,
515 struct v4l2_encoder_cmd *a);
516 int (*vidioc_try_encoder_cmd)(struct file *file, void *fh,
517 struct v4l2_encoder_cmd *a);
518 int (*vidioc_decoder_cmd)(struct file *file, void *fh,
519 struct v4l2_decoder_cmd *a);
520 int (*vidioc_try_decoder_cmd)(struct file *file, void *fh,
521 struct v4l2_decoder_cmd *a);
522
523 /* Stream type-dependent parameter ioctls */
524 int (*vidioc_g_parm)(struct file *file, void *fh,
525 struct v4l2_streamparm *a);
526 int (*vidioc_s_parm)(struct file *file, void *fh,
527 struct v4l2_streamparm *a);
528
529 /* Tuner ioctls */
530 int (*vidioc_g_tuner)(struct file *file, void *fh,
531 struct v4l2_tuner *a);
532 int (*vidioc_s_tuner)(struct file *file, void *fh,
533 const struct v4l2_tuner *a);
534 int (*vidioc_g_frequency)(struct file *file, void *fh,
535 struct v4l2_frequency *a);
536 int (*vidioc_s_frequency)(struct file *file, void *fh,
537 const struct v4l2_frequency *a);
538 int (*vidioc_enum_freq_bands)(struct file *file, void *fh,
539 struct v4l2_frequency_band *band);
540
541 /* Sliced VBI cap */
542 int (*vidioc_g_sliced_vbi_cap)(struct file *file, void *fh,
543 struct v4l2_sliced_vbi_cap *a);
544
545 /* Log status ioctl */
546 int (*vidioc_log_status)(struct file *file, void *fh);
547
548 int (*vidioc_s_hw_freq_seek)(struct file *file, void *fh,
549 const struct v4l2_hw_freq_seek *a);
550
551 /* Debugging ioctls */
552#ifdef CONFIG_VIDEO_ADV_DEBUG
553 int (*vidioc_g_register)(struct file *file, void *fh,
554 struct v4l2_dbg_register *reg);
555 int (*vidioc_s_register)(struct file *file, void *fh,
556 const struct v4l2_dbg_register *reg);
557
558 int (*vidioc_g_chip_info)(struct file *file, void *fh,
559 struct v4l2_dbg_chip_info *chip);
560#endif
561
562 int (*vidioc_enum_framesizes)(struct file *file, void *fh,
563 struct v4l2_frmsizeenum *fsize);
564
565 int (*vidioc_enum_frameintervals)(struct file *file, void *fh,
566 struct v4l2_frmivalenum *fival);
567
568 /* DV Timings IOCTLs */
569 int (*vidioc_s_dv_timings)(struct file *file, void *fh,
570 struct v4l2_dv_timings *timings);
571 int (*vidioc_g_dv_timings)(struct file *file, void *fh,
572 struct v4l2_dv_timings *timings);
573 int (*vidioc_query_dv_timings)(struct file *file, void *fh,
574 struct v4l2_dv_timings *timings);
575 int (*vidioc_enum_dv_timings)(struct file *file, void *fh,
576 struct v4l2_enum_dv_timings *timings);
577 int (*vidioc_dv_timings_cap)(struct file *file, void *fh,
578 struct v4l2_dv_timings_cap *cap);
579 int (*vidioc_g_edid)(struct file *file, void *fh,
580 struct v4l2_edid *edid);
581 int (*vidioc_s_edid)(struct file *file, void *fh,
582 struct v4l2_edid *edid);
583
584 int (*vidioc_subscribe_event)(struct v4l2_fh *fh,
585 const struct v4l2_event_subscription *sub);
586 int (*vidioc_unsubscribe_event)(struct v4l2_fh *fh,
587 const struct v4l2_event_subscription *sub);
588
589 /* For other private ioctls */
590 long (*vidioc_default)(struct file *file, void *fh,
591 bool valid_prio, unsigned int cmd, void *arg);
592};
593
594
595/* v4l debugging and diagnostics */
596
597/* Device debug flags to be used with the video device debug attribute */
598
599/* Just log the ioctl name + error code */
600#define V4L2_DEV_DEBUG_IOCTL 0x01
601/* Log the ioctl name arguments + error code */
602#define V4L2_DEV_DEBUG_IOCTL_ARG 0x02
603/* Log the file operations open, release, mmap and get_unmapped_area */
604#define V4L2_DEV_DEBUG_FOP 0x04
605/* Log the read and write file operations and the VIDIOC_(D)QBUF ioctls */
606#define V4L2_DEV_DEBUG_STREAMING 0x08
607/* Log poll() */
608#define V4L2_DEV_DEBUG_POLL 0x10
609/* Log controls */
610#define V4L2_DEV_DEBUG_CTRL 0x20
611
612/* Video standard functions */
613
614/**
615 * v4l2_norm_to_name - Ancillary routine to analog TV standard name from its ID.
616 *
617 * @id: analog TV standard ID.
618 *
619 * Return: returns a string with the name of the analog TV standard.
620 * If the standard is not found or if @id points to multiple standard,
621 * it returns "Unknown".
622 */
623const char *v4l2_norm_to_name(v4l2_std_id id);
624
625/**
626 * v4l2_video_std_frame_period - Ancillary routine that fills a
627 * struct &v4l2_fract pointer with the default framerate fraction.
628 *
629 * @id: analog TV standard ID.
630 * @frameperiod: struct &v4l2_fract pointer to be filled
631 *
632 */
633void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod);
634
635/**
636 * v4l2_video_std_construct - Ancillary routine that fills in the fields of
637 * a &v4l2_standard structure according to the @id parameter.
638 *
639 * @vs: struct &v4l2_standard pointer to be filled
640 * @id: analog TV standard ID.
641 * @name: name of the standard to be used
642 *
643 * .. note::
644 *
645 * This ancillary routine is obsolete. Shouldn't be used on newer drivers.
646 */
647int v4l2_video_std_construct(struct v4l2_standard *vs,
648 int id, const char *name);
649
650/**
651 * v4l_video_std_enumstd - Ancillary routine that fills in the fields of
652 * a &v4l2_standard structure according to the @id and @vs->index
653 * parameters.
654 *
655 * @vs: struct &v4l2_standard pointer to be filled.
656 * @id: analog TV standard ID.
657 *
658 */
659int v4l_video_std_enumstd(struct v4l2_standard *vs, v4l2_std_id id);
660
661/**
662 * v4l_printk_ioctl - Ancillary routine that prints the ioctl in a
663 * human-readable format.
664 *
665 * @prefix: prefix to be added at the ioctl prints.
666 * @cmd: ioctl name
667 *
668 * .. note::
669 *
670 * If prefix != %NULL, then it will issue a
671 * ``printk(KERN_DEBUG "%s: ", prefix)`` first.
672 */
673void v4l_printk_ioctl(const char *prefix, unsigned int cmd);
674
675struct video_device;
676
677/* names for fancy debug output */
678extern const char *v4l2_field_names[];
679extern const char *v4l2_type_names[];
680
681#ifdef CONFIG_COMPAT
682/**
683 * v4l2_compat_ioctl32 -32 Bits compatibility layer for 64 bits processors
684 *
685 * @file: Pointer to struct &file.
686 * @cmd: Ioctl name.
687 * @arg: Ioctl argument.
688 */
689long int v4l2_compat_ioctl32(struct file *file, unsigned int cmd,
690 unsigned long arg);
691#endif
692
693unsigned int v4l2_compat_translate_cmd(unsigned int cmd);
694int v4l2_compat_get_user(void __user *arg, void *parg, unsigned int cmd);
695int v4l2_compat_put_user(void __user *arg, void *parg, unsigned int cmd);
696int v4l2_compat_get_array_args(struct file *file, void *mbuf,
697 void __user *user_ptr, size_t array_size,
698 unsigned int cmd, void *arg);
699int v4l2_compat_put_array_args(struct file *file, void __user *user_ptr,
700 void *mbuf, size_t array_size,
701 unsigned int cmd, void *arg);
702
703/**
704 * typedef v4l2_kioctl - Typedef used to pass an ioctl handler.
705 *
706 * @file: Pointer to struct &file.
707 * @cmd: Ioctl name.
708 * @arg: Ioctl argument.
709 */
710typedef long (*v4l2_kioctl)(struct file *file, unsigned int cmd, void *arg);
711
712/**
713 * video_usercopy - copies data from/to userspace memory when an ioctl is
714 * issued.
715 *
716 * @file: Pointer to struct &file.
717 * @cmd: Ioctl name.
718 * @arg: Ioctl argument.
719 * @func: function that will handle the ioctl
720 *
721 * .. note::
722 *
723 * This routine should be used only inside the V4L2 core.
724 */
725long int video_usercopy(struct file *file, unsigned int cmd,
726 unsigned long int arg, v4l2_kioctl func);
727
728/**
729 * video_ioctl2 - Handles a V4L2 ioctl.
730 *
731 * @file: Pointer to struct &file.
732 * @cmd: Ioctl name.
733 * @arg: Ioctl argument.
734 *
735 * Method used to hancle an ioctl. Should be used to fill the
736 * &v4l2_ioctl_ops.unlocked_ioctl on all V4L2 drivers.
737 */
738long int video_ioctl2(struct file *file,
739 unsigned int cmd, unsigned long int arg);
740
741/*
742 * The user space interpretation of the 'v4l2_event' differs
743 * based on the 'time_t' definition on 32-bit architectures, so
744 * the kernel has to handle both.
745 * This is the old version for 32-bit architectures.
746 */
747struct v4l2_event_time32 {
748 __u32 type;
749 union {
750 struct v4l2_event_vsync vsync;
751 struct v4l2_event_ctrl ctrl;
752 struct v4l2_event_frame_sync frame_sync;
753 struct v4l2_event_src_change src_change;
754 struct v4l2_event_motion_det motion_det;
755 __u8 data[64];
756 } u;
757 __u32 pending;
758 __u32 sequence;
759 struct old_timespec32 timestamp;
760 __u32 id;
761 __u32 reserved[8];
762};
763
764#define VIDIOC_DQEVENT_TIME32 _IOR('V', 89, struct v4l2_event_time32)
765
766struct v4l2_buffer_time32 {
767 __u32 index;
768 __u32 type;
769 __u32 bytesused;
770 __u32 flags;
771 __u32 field;
772 struct old_timeval32 timestamp;
773 struct v4l2_timecode timecode;
774 __u32 sequence;
775
776 /* memory location */
777 __u32 memory;
778 union {
779 __u32 offset;
780 unsigned long userptr;
781 struct v4l2_plane *planes;
782 __s32 fd;
783 } m;
784 __u32 length;
785 __u32 reserved2;
786 union {
787 __s32 request_fd;
788 __u32 reserved;
789 };
790};
791#define VIDIOC_QUERYBUF_TIME32 _IOWR('V', 9, struct v4l2_buffer_time32)
792#define VIDIOC_QBUF_TIME32 _IOWR('V', 15, struct v4l2_buffer_time32)
793#define VIDIOC_DQBUF_TIME32 _IOWR('V', 17, struct v4l2_buffer_time32)
794#define VIDIOC_PREPARE_BUF_TIME32 _IOWR('V', 93, struct v4l2_buffer_time32)
795
796#endif /* _V4L2_IOCTL_H */
1/*
2 *
3 * V 4 L 2 D R I V E R H E L P E R A P I
4 *
5 * Moved from videodev2.h
6 *
7 * Some commonly needed functions for drivers (v4l2-common.o module)
8 */
9#ifndef _V4L2_IOCTL_H
10#define _V4L2_IOCTL_H
11
12#include <linux/poll.h>
13#include <linux/fs.h>
14#include <linux/mutex.h>
15#include <linux/compiler.h> /* need __user */
16#include <linux/videodev2.h>
17
18struct v4l2_fh;
19
20struct v4l2_ioctl_ops {
21 /* ioctl callbacks */
22
23 /* VIDIOC_QUERYCAP handler */
24 int (*vidioc_querycap)(struct file *file, void *fh, struct v4l2_capability *cap);
25
26 /* VIDIOC_ENUM_FMT handlers */
27 int (*vidioc_enum_fmt_vid_cap) (struct file *file, void *fh,
28 struct v4l2_fmtdesc *f);
29 int (*vidioc_enum_fmt_vid_overlay) (struct file *file, void *fh,
30 struct v4l2_fmtdesc *f);
31 int (*vidioc_enum_fmt_vid_out) (struct file *file, void *fh,
32 struct v4l2_fmtdesc *f);
33 int (*vidioc_enum_fmt_vid_cap_mplane)(struct file *file, void *fh,
34 struct v4l2_fmtdesc *f);
35 int (*vidioc_enum_fmt_vid_out_mplane)(struct file *file, void *fh,
36 struct v4l2_fmtdesc *f);
37 int (*vidioc_enum_fmt_sdr_cap) (struct file *file, void *fh,
38 struct v4l2_fmtdesc *f);
39 int (*vidioc_enum_fmt_sdr_out) (struct file *file, void *fh,
40 struct v4l2_fmtdesc *f);
41
42 /* VIDIOC_G_FMT handlers */
43 int (*vidioc_g_fmt_vid_cap) (struct file *file, void *fh,
44 struct v4l2_format *f);
45 int (*vidioc_g_fmt_vid_overlay)(struct file *file, void *fh,
46 struct v4l2_format *f);
47 int (*vidioc_g_fmt_vid_out) (struct file *file, void *fh,
48 struct v4l2_format *f);
49 int (*vidioc_g_fmt_vid_out_overlay)(struct file *file, void *fh,
50 struct v4l2_format *f);
51 int (*vidioc_g_fmt_vbi_cap) (struct file *file, void *fh,
52 struct v4l2_format *f);
53 int (*vidioc_g_fmt_vbi_out) (struct file *file, void *fh,
54 struct v4l2_format *f);
55 int (*vidioc_g_fmt_sliced_vbi_cap)(struct file *file, void *fh,
56 struct v4l2_format *f);
57 int (*vidioc_g_fmt_sliced_vbi_out)(struct file *file, void *fh,
58 struct v4l2_format *f);
59 int (*vidioc_g_fmt_vid_cap_mplane)(struct file *file, void *fh,
60 struct v4l2_format *f);
61 int (*vidioc_g_fmt_vid_out_mplane)(struct file *file, void *fh,
62 struct v4l2_format *f);
63 int (*vidioc_g_fmt_sdr_cap) (struct file *file, void *fh,
64 struct v4l2_format *f);
65 int (*vidioc_g_fmt_sdr_out) (struct file *file, void *fh,
66 struct v4l2_format *f);
67
68 /* VIDIOC_S_FMT handlers */
69 int (*vidioc_s_fmt_vid_cap) (struct file *file, void *fh,
70 struct v4l2_format *f);
71 int (*vidioc_s_fmt_vid_overlay)(struct file *file, void *fh,
72 struct v4l2_format *f);
73 int (*vidioc_s_fmt_vid_out) (struct file *file, void *fh,
74 struct v4l2_format *f);
75 int (*vidioc_s_fmt_vid_out_overlay)(struct file *file, void *fh,
76 struct v4l2_format *f);
77 int (*vidioc_s_fmt_vbi_cap) (struct file *file, void *fh,
78 struct v4l2_format *f);
79 int (*vidioc_s_fmt_vbi_out) (struct file *file, void *fh,
80 struct v4l2_format *f);
81 int (*vidioc_s_fmt_sliced_vbi_cap)(struct file *file, void *fh,
82 struct v4l2_format *f);
83 int (*vidioc_s_fmt_sliced_vbi_out)(struct file *file, void *fh,
84 struct v4l2_format *f);
85 int (*vidioc_s_fmt_vid_cap_mplane)(struct file *file, void *fh,
86 struct v4l2_format *f);
87 int (*vidioc_s_fmt_vid_out_mplane)(struct file *file, void *fh,
88 struct v4l2_format *f);
89 int (*vidioc_s_fmt_sdr_cap) (struct file *file, void *fh,
90 struct v4l2_format *f);
91 int (*vidioc_s_fmt_sdr_out) (struct file *file, void *fh,
92 struct v4l2_format *f);
93
94 /* VIDIOC_TRY_FMT handlers */
95 int (*vidioc_try_fmt_vid_cap) (struct file *file, void *fh,
96 struct v4l2_format *f);
97 int (*vidioc_try_fmt_vid_overlay)(struct file *file, void *fh,
98 struct v4l2_format *f);
99 int (*vidioc_try_fmt_vid_out) (struct file *file, void *fh,
100 struct v4l2_format *f);
101 int (*vidioc_try_fmt_vid_out_overlay)(struct file *file, void *fh,
102 struct v4l2_format *f);
103 int (*vidioc_try_fmt_vbi_cap) (struct file *file, void *fh,
104 struct v4l2_format *f);
105 int (*vidioc_try_fmt_vbi_out) (struct file *file, void *fh,
106 struct v4l2_format *f);
107 int (*vidioc_try_fmt_sliced_vbi_cap)(struct file *file, void *fh,
108 struct v4l2_format *f);
109 int (*vidioc_try_fmt_sliced_vbi_out)(struct file *file, void *fh,
110 struct v4l2_format *f);
111 int (*vidioc_try_fmt_vid_cap_mplane)(struct file *file, void *fh,
112 struct v4l2_format *f);
113 int (*vidioc_try_fmt_vid_out_mplane)(struct file *file, void *fh,
114 struct v4l2_format *f);
115 int (*vidioc_try_fmt_sdr_cap) (struct file *file, void *fh,
116 struct v4l2_format *f);
117 int (*vidioc_try_fmt_sdr_out) (struct file *file, void *fh,
118 struct v4l2_format *f);
119
120 /* Buffer handlers */
121 int (*vidioc_reqbufs) (struct file *file, void *fh, struct v4l2_requestbuffers *b);
122 int (*vidioc_querybuf)(struct file *file, void *fh, struct v4l2_buffer *b);
123 int (*vidioc_qbuf) (struct file *file, void *fh, struct v4l2_buffer *b);
124 int (*vidioc_expbuf) (struct file *file, void *fh,
125 struct v4l2_exportbuffer *e);
126 int (*vidioc_dqbuf) (struct file *file, void *fh, struct v4l2_buffer *b);
127
128 int (*vidioc_create_bufs)(struct file *file, void *fh, struct v4l2_create_buffers *b);
129 int (*vidioc_prepare_buf)(struct file *file, void *fh, struct v4l2_buffer *b);
130
131 int (*vidioc_overlay) (struct file *file, void *fh, unsigned int i);
132 int (*vidioc_g_fbuf) (struct file *file, void *fh,
133 struct v4l2_framebuffer *a);
134 int (*vidioc_s_fbuf) (struct file *file, void *fh,
135 const struct v4l2_framebuffer *a);
136
137 /* Stream on/off */
138 int (*vidioc_streamon) (struct file *file, void *fh, enum v4l2_buf_type i);
139 int (*vidioc_streamoff)(struct file *file, void *fh, enum v4l2_buf_type i);
140
141 /* Standard handling
142 ENUMSTD is handled by videodev.c
143 */
144 int (*vidioc_g_std) (struct file *file, void *fh, v4l2_std_id *norm);
145 int (*vidioc_s_std) (struct file *file, void *fh, v4l2_std_id norm);
146 int (*vidioc_querystd) (struct file *file, void *fh, v4l2_std_id *a);
147
148 /* Input handling */
149 int (*vidioc_enum_input)(struct file *file, void *fh,
150 struct v4l2_input *inp);
151 int (*vidioc_g_input) (struct file *file, void *fh, unsigned int *i);
152 int (*vidioc_s_input) (struct file *file, void *fh, unsigned int i);
153
154 /* Output handling */
155 int (*vidioc_enum_output) (struct file *file, void *fh,
156 struct v4l2_output *a);
157 int (*vidioc_g_output) (struct file *file, void *fh, unsigned int *i);
158 int (*vidioc_s_output) (struct file *file, void *fh, unsigned int i);
159
160 /* Control handling */
161 int (*vidioc_queryctrl) (struct file *file, void *fh,
162 struct v4l2_queryctrl *a);
163 int (*vidioc_query_ext_ctrl) (struct file *file, void *fh,
164 struct v4l2_query_ext_ctrl *a);
165 int (*vidioc_g_ctrl) (struct file *file, void *fh,
166 struct v4l2_control *a);
167 int (*vidioc_s_ctrl) (struct file *file, void *fh,
168 struct v4l2_control *a);
169 int (*vidioc_g_ext_ctrls) (struct file *file, void *fh,
170 struct v4l2_ext_controls *a);
171 int (*vidioc_s_ext_ctrls) (struct file *file, void *fh,
172 struct v4l2_ext_controls *a);
173 int (*vidioc_try_ext_ctrls) (struct file *file, void *fh,
174 struct v4l2_ext_controls *a);
175 int (*vidioc_querymenu) (struct file *file, void *fh,
176 struct v4l2_querymenu *a);
177
178 /* Audio ioctls */
179 int (*vidioc_enumaudio) (struct file *file, void *fh,
180 struct v4l2_audio *a);
181 int (*vidioc_g_audio) (struct file *file, void *fh,
182 struct v4l2_audio *a);
183 int (*vidioc_s_audio) (struct file *file, void *fh,
184 const struct v4l2_audio *a);
185
186 /* Audio out ioctls */
187 int (*vidioc_enumaudout) (struct file *file, void *fh,
188 struct v4l2_audioout *a);
189 int (*vidioc_g_audout) (struct file *file, void *fh,
190 struct v4l2_audioout *a);
191 int (*vidioc_s_audout) (struct file *file, void *fh,
192 const struct v4l2_audioout *a);
193 int (*vidioc_g_modulator) (struct file *file, void *fh,
194 struct v4l2_modulator *a);
195 int (*vidioc_s_modulator) (struct file *file, void *fh,
196 const struct v4l2_modulator *a);
197 /* Crop ioctls */
198 int (*vidioc_cropcap) (struct file *file, void *fh,
199 struct v4l2_cropcap *a);
200 int (*vidioc_g_crop) (struct file *file, void *fh,
201 struct v4l2_crop *a);
202 int (*vidioc_s_crop) (struct file *file, void *fh,
203 const struct v4l2_crop *a);
204 int (*vidioc_g_selection) (struct file *file, void *fh,
205 struct v4l2_selection *s);
206 int (*vidioc_s_selection) (struct file *file, void *fh,
207 struct v4l2_selection *s);
208 /* Compression ioctls */
209 int (*vidioc_g_jpegcomp) (struct file *file, void *fh,
210 struct v4l2_jpegcompression *a);
211 int (*vidioc_s_jpegcomp) (struct file *file, void *fh,
212 const struct v4l2_jpegcompression *a);
213 int (*vidioc_g_enc_index) (struct file *file, void *fh,
214 struct v4l2_enc_idx *a);
215 int (*vidioc_encoder_cmd) (struct file *file, void *fh,
216 struct v4l2_encoder_cmd *a);
217 int (*vidioc_try_encoder_cmd) (struct file *file, void *fh,
218 struct v4l2_encoder_cmd *a);
219 int (*vidioc_decoder_cmd) (struct file *file, void *fh,
220 struct v4l2_decoder_cmd *a);
221 int (*vidioc_try_decoder_cmd) (struct file *file, void *fh,
222 struct v4l2_decoder_cmd *a);
223
224 /* Stream type-dependent parameter ioctls */
225 int (*vidioc_g_parm) (struct file *file, void *fh,
226 struct v4l2_streamparm *a);
227 int (*vidioc_s_parm) (struct file *file, void *fh,
228 struct v4l2_streamparm *a);
229
230 /* Tuner ioctls */
231 int (*vidioc_g_tuner) (struct file *file, void *fh,
232 struct v4l2_tuner *a);
233 int (*vidioc_s_tuner) (struct file *file, void *fh,
234 const struct v4l2_tuner *a);
235 int (*vidioc_g_frequency) (struct file *file, void *fh,
236 struct v4l2_frequency *a);
237 int (*vidioc_s_frequency) (struct file *file, void *fh,
238 const struct v4l2_frequency *a);
239 int (*vidioc_enum_freq_bands) (struct file *file, void *fh,
240 struct v4l2_frequency_band *band);
241
242 /* Sliced VBI cap */
243 int (*vidioc_g_sliced_vbi_cap) (struct file *file, void *fh,
244 struct v4l2_sliced_vbi_cap *a);
245
246 /* Log status ioctl */
247 int (*vidioc_log_status) (struct file *file, void *fh);
248
249 int (*vidioc_s_hw_freq_seek) (struct file *file, void *fh,
250 const struct v4l2_hw_freq_seek *a);
251
252 /* Debugging ioctls */
253#ifdef CONFIG_VIDEO_ADV_DEBUG
254 int (*vidioc_g_register) (struct file *file, void *fh,
255 struct v4l2_dbg_register *reg);
256 int (*vidioc_s_register) (struct file *file, void *fh,
257 const struct v4l2_dbg_register *reg);
258
259 int (*vidioc_g_chip_info) (struct file *file, void *fh,
260 struct v4l2_dbg_chip_info *chip);
261#endif
262
263 int (*vidioc_enum_framesizes) (struct file *file, void *fh,
264 struct v4l2_frmsizeenum *fsize);
265
266 int (*vidioc_enum_frameintervals) (struct file *file, void *fh,
267 struct v4l2_frmivalenum *fival);
268
269 /* DV Timings IOCTLs */
270 int (*vidioc_s_dv_timings) (struct file *file, void *fh,
271 struct v4l2_dv_timings *timings);
272 int (*vidioc_g_dv_timings) (struct file *file, void *fh,
273 struct v4l2_dv_timings *timings);
274 int (*vidioc_query_dv_timings) (struct file *file, void *fh,
275 struct v4l2_dv_timings *timings);
276 int (*vidioc_enum_dv_timings) (struct file *file, void *fh,
277 struct v4l2_enum_dv_timings *timings);
278 int (*vidioc_dv_timings_cap) (struct file *file, void *fh,
279 struct v4l2_dv_timings_cap *cap);
280 int (*vidioc_g_edid) (struct file *file, void *fh, struct v4l2_edid *edid);
281 int (*vidioc_s_edid) (struct file *file, void *fh, struct v4l2_edid *edid);
282
283 int (*vidioc_subscribe_event) (struct v4l2_fh *fh,
284 const struct v4l2_event_subscription *sub);
285 int (*vidioc_unsubscribe_event)(struct v4l2_fh *fh,
286 const struct v4l2_event_subscription *sub);
287
288 /* For other private ioctls */
289 long (*vidioc_default) (struct file *file, void *fh,
290 bool valid_prio, unsigned int cmd, void *arg);
291};
292
293
294/* v4l debugging and diagnostics */
295
296/* Device debug flags to be used with the video device debug attribute */
297
298/* Just log the ioctl name + error code */
299#define V4L2_DEV_DEBUG_IOCTL 0x01
300/* Log the ioctl name arguments + error code */
301#define V4L2_DEV_DEBUG_IOCTL_ARG 0x02
302/* Log the file operations open, release, mmap and get_unmapped_area */
303#define V4L2_DEV_DEBUG_FOP 0x04
304/* Log the read and write file operations and the VIDIOC_(D)QBUF ioctls */
305#define V4L2_DEV_DEBUG_STREAMING 0x08
306/* Log poll() */
307#define V4L2_DEV_DEBUG_POLL 0x10
308
309/* Video standard functions */
310extern const char *v4l2_norm_to_name(v4l2_std_id id);
311extern void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod);
312extern int v4l2_video_std_construct(struct v4l2_standard *vs,
313 int id, const char *name);
314/* Prints the ioctl in a human-readable format. If prefix != NULL,
315 then do printk(KERN_DEBUG "%s: ", prefix) first. */
316extern void v4l_printk_ioctl(const char *prefix, unsigned int cmd);
317
318/* Internal use only: get the mutex (if any) that we need to lock for the
319 given command. */
320struct video_device;
321extern struct mutex *v4l2_ioctl_get_lock(struct video_device *vdev, unsigned cmd);
322
323/* names for fancy debug output */
324extern const char *v4l2_field_names[];
325extern const char *v4l2_type_names[];
326
327#ifdef CONFIG_COMPAT
328/* 32 Bits compatibility layer for 64 bits processors */
329extern long v4l2_compat_ioctl32(struct file *file, unsigned int cmd,
330 unsigned long arg);
331#endif
332
333typedef long (*v4l2_kioctl)(struct file *file,
334 unsigned int cmd, void *arg);
335
336/* Include support for obsoleted stuff */
337extern long video_usercopy(struct file *file, unsigned int cmd,
338 unsigned long arg, v4l2_kioctl func);
339
340/* Standard handlers for V4L ioctl's */
341extern long video_ioctl2(struct file *file,
342 unsigned int cmd, unsigned long arg);
343
344#endif /* _V4L2_IOCTL_H */