blob: d96d5e4f242a1b98c921e60e7860cd5ff00ac3a8 [file] [log] [blame]
Markus Heiser5377d912016-06-30 15:18:56 +02001.. -*- coding: utf-8; mode: rst -*-
2
Mauro Carvalho Chehabaf4a4d02016-07-01 13:42:29 -03003.. _VIDIOC_LOG_STATUS:
Markus Heiser5377d912016-06-30 15:18:56 +02004
5***********************
6ioctl VIDIOC_LOG_STATUS
7***********************
8
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -03009NAME
10====
Markus Heiser5377d912016-06-30 15:18:56 +020011
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030012VIDIOC_LOG_STATUS - Log driver status information
Markus Heiser5377d912016-06-30 15:18:56 +020013
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030014SYNOPSIS
Markus Heiser5377d912016-06-30 15:18:56 +020015========
16
Mauro Carvalho Chehabb7e67f62016-07-02 09:49:16 -030017.. cpp:function:: int ioctl( int fd, int request )
Markus Heiser5377d912016-06-30 15:18:56 +020018
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030019
20ARGUMENTS
21=========
22
23
24
25DESCRIPTION
Markus Heiser5377d912016-06-30 15:18:56 +020026===========
27
28As the video/audio devices become more complicated it becomes harder to
29debug problems. When this ioctl is called the driver will output the
30current device status to the kernel log. This is particular useful when
31dealing with problems like no sound, no video and incorrectly tuned
32channels. Also many modern devices autodetect video and audio standards
33and this ioctl will report what the device thinks what the standard is.
34Mismatches may give an indication where the problem is.
35
36This ioctl is optional and not all drivers support it. It was introduced
37in Linux 2.6.15.
38
39
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030040RETURN VALUE
Markus Heiser5377d912016-06-30 15:18:56 +020041============
42
43On success 0 is returned, on error -1 and the ``errno`` variable is set
44appropriately. The generic error codes are described at the
45:ref:`Generic Error Codes <gen-errors>` chapter.