154f38fcaSMauro Carvalho Chehab.. Permission is granted to copy, distribute and/or modify this 254f38fcaSMauro Carvalho Chehab.. document under the terms of the GNU Free Documentation License, 354f38fcaSMauro Carvalho Chehab.. Version 1.1 or any later version published by the Free Software 454f38fcaSMauro Carvalho Chehab.. Foundation, with no Invariant Sections, no Front-Cover Texts 554f38fcaSMauro Carvalho Chehab.. and no Back-Cover Texts. A copy of the license is included at 654f38fcaSMauro Carvalho Chehab.. Documentation/userspace-api/media/fdl-appendix.rst. 754f38fcaSMauro Carvalho Chehab.. 854f38fcaSMauro Carvalho Chehab.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho Chehab.. _VIDIOC_LOG_STATUS: 1154f38fcaSMauro Carvalho Chehab 1254f38fcaSMauro Carvalho Chehab*********************** 1354f38fcaSMauro Carvalho Chehabioctl VIDIOC_LOG_STATUS 1454f38fcaSMauro Carvalho Chehab*********************** 1554f38fcaSMauro Carvalho Chehab 1654f38fcaSMauro Carvalho ChehabName 1754f38fcaSMauro Carvalho Chehab==== 1854f38fcaSMauro Carvalho Chehab 1954f38fcaSMauro Carvalho ChehabVIDIOC_LOG_STATUS - Log driver status information 2054f38fcaSMauro Carvalho Chehab 2154f38fcaSMauro Carvalho Chehab 2254f38fcaSMauro Carvalho ChehabSynopsis 2354f38fcaSMauro Carvalho Chehab======== 2454f38fcaSMauro Carvalho Chehab 2554f38fcaSMauro Carvalho Chehab.. c:function:: int ioctl( int fd, VIDIOC_LOG_STATUS) 2654f38fcaSMauro Carvalho Chehab :name: VIDIOC_LOG_STATUS 2754f38fcaSMauro Carvalho Chehab 2854f38fcaSMauro Carvalho Chehab 2954f38fcaSMauro Carvalho ChehabArguments 3054f38fcaSMauro Carvalho Chehab========= 3154f38fcaSMauro Carvalho Chehab 3254f38fcaSMauro Carvalho Chehab``fd`` 3354f38fcaSMauro Carvalho Chehab File descriptor returned by :ref:`open() <func-open>`. 3454f38fcaSMauro Carvalho Chehab 3554f38fcaSMauro Carvalho Chehab 3654f38fcaSMauro Carvalho ChehabDescription 3754f38fcaSMauro Carvalho Chehab=========== 3854f38fcaSMauro Carvalho Chehab 3954f38fcaSMauro Carvalho ChehabAs the video/audio devices become more complicated it becomes harder to 4054f38fcaSMauro Carvalho Chehabdebug problems. When this ioctl is called the driver will output the 4154f38fcaSMauro Carvalho Chehabcurrent device status to the kernel log. This is particular useful when 4254f38fcaSMauro Carvalho Chehabdealing with problems like no sound, no video and incorrectly tuned 4354f38fcaSMauro Carvalho Chehabchannels. Also many modern devices autodetect video and audio standards 4454f38fcaSMauro Carvalho Chehaband this ioctl will report what the device thinks what the standard is. 4554f38fcaSMauro Carvalho ChehabMismatches may give an indication where the problem is. 4654f38fcaSMauro Carvalho Chehab 4754f38fcaSMauro Carvalho ChehabThis ioctl is optional and not all drivers support it. It was introduced 4854f38fcaSMauro Carvalho Chehabin Linux 2.6.15. 4954f38fcaSMauro Carvalho Chehab 5054f38fcaSMauro Carvalho Chehab 5154f38fcaSMauro Carvalho ChehabReturn Value 5254f38fcaSMauro Carvalho Chehab============ 5354f38fcaSMauro Carvalho Chehab 5454f38fcaSMauro Carvalho ChehabOn success 0 is returned, on error -1 and the ``errno`` variable is set 5554f38fcaSMauro Carvalho Chehabappropriately. The generic error codes are described at the 5654f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 57