162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
262306a36Sopenharmony_ci.. c:namespace:: V4L
362306a36Sopenharmony_ci
462306a36Sopenharmony_ci.. _VIDIOC_LOG_STATUS:
562306a36Sopenharmony_ci
662306a36Sopenharmony_ci***********************
762306a36Sopenharmony_ciioctl VIDIOC_LOG_STATUS
862306a36Sopenharmony_ci***********************
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ciName
1162306a36Sopenharmony_ci====
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ciVIDIOC_LOG_STATUS - Log driver status information
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ciSynopsis
1662306a36Sopenharmony_ci========
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ci.. c:macro:: VIDIOC_LOG_STATUS
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_ci``int ioctl(int fd, VIDIOC_LOG_STATUS)``
2162306a36Sopenharmony_ci
2262306a36Sopenharmony_ciArguments
2362306a36Sopenharmony_ci=========
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ci``fd``
2662306a36Sopenharmony_ci    File descriptor returned by :c:func:`open()`.
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ciDescription
2962306a36Sopenharmony_ci===========
3062306a36Sopenharmony_ci
3162306a36Sopenharmony_ciAs the video/audio devices become more complicated it becomes harder to
3262306a36Sopenharmony_cidebug problems. When this ioctl is called the driver will output the
3362306a36Sopenharmony_cicurrent device status to the kernel log. This is particular useful when
3462306a36Sopenharmony_cidealing with problems like no sound, no video and incorrectly tuned
3562306a36Sopenharmony_cichannels. Also many modern devices autodetect video and audio standards
3662306a36Sopenharmony_ciand this ioctl will report what the device thinks what the standard is.
3762306a36Sopenharmony_ciMismatches may give an indication where the problem is.
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ciThis ioctl is optional and not all drivers support it. It was introduced
4062306a36Sopenharmony_ciin Linux 2.6.15.
4162306a36Sopenharmony_ci
4262306a36Sopenharmony_ciReturn Value
4362306a36Sopenharmony_ci============
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ciOn success 0 is returned, on error -1 and the ``errno`` variable is set
4662306a36Sopenharmony_ciappropriately. The generic error codes are described at the
4762306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
48