1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
254f38fcaSMauro Carvalho Chehab
354f38fcaSMauro Carvalho Chehab.. _VIDIOC_LOG_STATUS:
454f38fcaSMauro Carvalho Chehab
554f38fcaSMauro Carvalho Chehab***********************
654f38fcaSMauro Carvalho Chehabioctl VIDIOC_LOG_STATUS
754f38fcaSMauro Carvalho Chehab***********************
854f38fcaSMauro Carvalho Chehab
954f38fcaSMauro Carvalho ChehabName
1054f38fcaSMauro Carvalho Chehab====
1154f38fcaSMauro Carvalho Chehab
1254f38fcaSMauro Carvalho ChehabVIDIOC_LOG_STATUS - Log driver status information
1354f38fcaSMauro Carvalho Chehab
1454f38fcaSMauro Carvalho Chehab
1554f38fcaSMauro Carvalho ChehabSynopsis
1654f38fcaSMauro Carvalho Chehab========
1754f38fcaSMauro Carvalho Chehab
1854f38fcaSMauro Carvalho Chehab.. c:function:: int ioctl( int fd, VIDIOC_LOG_STATUS)
1954f38fcaSMauro Carvalho Chehab    :name: VIDIOC_LOG_STATUS
2054f38fcaSMauro Carvalho Chehab
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho ChehabArguments
2354f38fcaSMauro Carvalho Chehab=========
2454f38fcaSMauro Carvalho Chehab
2554f38fcaSMauro Carvalho Chehab``fd``
2654f38fcaSMauro Carvalho Chehab    File descriptor returned by :ref:`open() <func-open>`.
2754f38fcaSMauro Carvalho Chehab
2854f38fcaSMauro Carvalho Chehab
2954f38fcaSMauro Carvalho ChehabDescription
3054f38fcaSMauro Carvalho Chehab===========
3154f38fcaSMauro Carvalho Chehab
3254f38fcaSMauro Carvalho ChehabAs the video/audio devices become more complicated it becomes harder to
3354f38fcaSMauro Carvalho Chehabdebug problems. When this ioctl is called the driver will output the
3454f38fcaSMauro Carvalho Chehabcurrent device status to the kernel log. This is particular useful when
3554f38fcaSMauro Carvalho Chehabdealing with problems like no sound, no video and incorrectly tuned
3654f38fcaSMauro Carvalho Chehabchannels. Also many modern devices autodetect video and audio standards
3754f38fcaSMauro Carvalho Chehaband this ioctl will report what the device thinks what the standard is.
3854f38fcaSMauro Carvalho ChehabMismatches may give an indication where the problem is.
3954f38fcaSMauro Carvalho Chehab
4054f38fcaSMauro Carvalho ChehabThis ioctl is optional and not all drivers support it. It was introduced
4154f38fcaSMauro Carvalho Chehabin Linux 2.6.15.
4254f38fcaSMauro Carvalho Chehab
4354f38fcaSMauro Carvalho Chehab
4454f38fcaSMauro Carvalho ChehabReturn Value
4554f38fcaSMauro Carvalho Chehab============
4654f38fcaSMauro Carvalho Chehab
4754f38fcaSMauro Carvalho ChehabOn success 0 is returned, on error -1 and the ``errno`` variable is set
4854f38fcaSMauro Carvalho Chehabappropriately. The generic error codes are described at the
4954f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter.
50