Documentation/userspace-api/media/v4l/vidioc-log-status.rst

   1 .. Permission is granted to copy, distribute and/or modify this
   2 .. document under the terms of the GNU Free Documentation License,
   3 .. Version 1.1 or any later version published by the Free Software
   4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
   5 .. and no Back-Cover Texts. A copy of the license is included at
   6 .. Documentation/userspace-api/media/fdl-appendix.rst.
   7 ..
   8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
   9
  10 .. _VIDIOC_LOG_STATUS:
  11
  12 ***********************
  13 ioctl VIDIOC_LOG_STATUS
  14 ***********************
  15
  16 Name
  17 ====
  18
  19 VIDIOC_LOG_STATUS - Log driver status information
  20
  21
  22 Synopsis
  23 ========
  24
  25 .. c:function:: int ioctl( int fd, VIDIOC_LOG_STATUS)
  26     :name: VIDIOC_LOG_STATUS
  27
  28
  29 Arguments
  30 =========
  31
  32 ``fd``
  33     File descriptor returned by :ref:`open() <func-open>`.
  34
  35
  36 Description
  37 ===========
  38
  39 As the video/audio devices become more complicated it becomes harder to
  40 debug problems. When this ioctl is called the driver will output the
  41 current device status to the kernel log. This is particular useful when
  42 dealing with problems like no sound, no video and incorrectly tuned
  43 channels. Also many modern devices autodetect video and audio standards
  44 and this ioctl will report what the device thinks what the standard is.
  45 Mismatches may give an indication where the problem is.
  46
  47 This ioctl is optional and not all drivers support it. It was introduced
  48 in Linux 2.6.15.
  49
  50
  51 Return Value
  52 ============
  53
  54 On success 0 is returned, on error -1 and the ``errno`` variable is set
  55 appropriately. The generic error codes are described at the
  56 :ref:`Generic Error Codes <gen-errors>` chapter.