linux/Documentation/DocBook/media/v4l/vidioc-log-status.xml
Mauro Carvalho Chehab 43c1daa47d [media] DocBook: Use the generic ioctl error codes for all V4L ioctl's
Be sure that all VIDIOC_* ioctl are using the return error macro, and
aren't specifying generic error codes internally.

Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
2011-07-27 17:53:35 -03:00

42 lines
1.2 KiB
XML

<refentry id="vidioc-log-status">
<refmeta>
<refentrytitle>ioctl VIDIOC_LOG_STATUS</refentrytitle>
&manvol;
</refmeta>
<refnamediv>
<refname>VIDIOC_LOG_STATUS</refname>
<refpurpose>Log driver status information</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ioctl</function></funcdef>
<paramdef>int <parameter>fd</parameter></paramdef>
<paramdef>int <parameter>request</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>As the video/audio devices become more complicated it
becomes harder to debug problems. When this ioctl is called the driver
will output the current device status to the kernel log. This is
particular useful when dealing with problems like no sound, no video
and incorrectly tuned channels. Also many modern devices autodetect
video and audio standards and this ioctl will report what the device
thinks what the standard is. Mismatches may give an indication where
the problem is.</para>
<para>This ioctl is optional and not all drivers support it. It
was introduced in Linux 2.6.15.</para>
</refsect1>
<refsect1>
&return-value;
</refsect1>
</refentry>