Merge tag 'drm-intel-next-2016-08-08' of git://anongit.freedesktop.org/drm-intel...
[cascardo/linux.git] / Documentation / media / uapi / v4l / vidioc-log-status.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _VIDIOC_LOG_STATUS:
4
5 ***********************
6 ioctl VIDIOC_LOG_STATUS
7 ***********************
8
9 Name
10 ====
11
12 VIDIOC_LOG_STATUS - Log driver status information
13
14
15 Synopsis
16 ========
17
18 .. cpp:function:: int ioctl( int fd, int request )
19
20
21 Arguments
22 =========
23
24
25
26 Description
27 ===========
28
29 As the video/audio devices become more complicated it becomes harder to
30 debug problems. When this ioctl is called the driver will output the
31 current device status to the kernel log. This is particular useful when
32 dealing with problems like no sound, no video and incorrectly tuned
33 channels. Also many modern devices autodetect video and audio standards
34 and this ioctl will report what the device thinks what the standard is.
35 Mismatches may give an indication where the problem is.
36
37 This ioctl is optional and not all drivers support it. It was introduced
38 in Linux 2.6.15.
39
40
41 Return Value
42 ============
43
44 On success 0 is returned, on error -1 and the ``errno`` variable is set
45 appropriately. The generic error codes are described at the
46 :ref:`Generic Error Codes <gen-errors>` chapter.