vidioc-log-status.rst 1.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. .. -*- coding: utf-8; mode: rst -*-
  2. .. _VIDIOC_LOG_STATUS:
  3. ***********************
  4. ioctl VIDIOC_LOG_STATUS
  5. ***********************
  6. Name
  7. ====
  8. VIDIOC_LOG_STATUS - Log driver status information
  9. Synopsis
  10. ========
  11. .. c:function:: int ioctl( int fd, VIDIOC_LOG_STATUS)
  12. :name: VIDIOC_LOG_STATUS
  13. Arguments
  14. =========
  15. ``fd``
  16. File descriptor returned by :ref:`open() <func-open>`.
  17. Description
  18. ===========
  19. As the video/audio devices become more complicated it becomes harder to
  20. debug problems. When this ioctl is called the driver will output the
  21. current device status to the kernel log. This is particular useful when
  22. dealing with problems like no sound, no video and incorrectly tuned
  23. channels. Also many modern devices autodetect video and audio standards
  24. and this ioctl will report what the device thinks what the standard is.
  25. Mismatches may give an indication where the problem is.
  26. This ioctl is optional and not all drivers support it. It was introduced
  27. in Linux 2.6.15.
  28. Return Value
  29. ============
  30. On success 0 is returned, on error -1 and the ``errno`` variable is set
  31. appropriately. The generic error codes are described at the
  32. :ref:`Generic Error Codes <gen-errors>` chapter.