1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 2*f9b2e8aaSMauro Carvalho Chehab.. c:namespace:: DTV.fe 354f38fcaSMauro Carvalho Chehab 454f38fcaSMauro Carvalho Chehab.. _FE_READ_SIGNAL_STRENGTH: 554f38fcaSMauro Carvalho Chehab 654f38fcaSMauro Carvalho Chehab*********************** 754f38fcaSMauro Carvalho ChehabFE_READ_SIGNAL_STRENGTH 854f38fcaSMauro Carvalho Chehab*********************** 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho ChehabName 1154f38fcaSMauro Carvalho Chehab==== 1254f38fcaSMauro Carvalho Chehab 1354f38fcaSMauro Carvalho ChehabFE_READ_SIGNAL_STRENGTH 1454f38fcaSMauro Carvalho Chehab 1554f38fcaSMauro Carvalho Chehab.. attention:: This ioctl is deprecated. 1654f38fcaSMauro Carvalho Chehab 1754f38fcaSMauro Carvalho ChehabSynopsis 1854f38fcaSMauro Carvalho Chehab======== 1954f38fcaSMauro Carvalho Chehab 20*f9b2e8aaSMauro Carvalho Chehab.. c:macro:: FE_READ_SIGNAL_STRENGTH 2154f38fcaSMauro Carvalho Chehab 22*f9b2e8aaSMauro Carvalho Chehab``int ioctl(int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)`` 2354f38fcaSMauro Carvalho Chehab 2454f38fcaSMauro Carvalho ChehabArguments 2554f38fcaSMauro Carvalho Chehab========= 2654f38fcaSMauro Carvalho Chehab 2754f38fcaSMauro Carvalho Chehab``fd`` 28*f9b2e8aaSMauro Carvalho Chehab File descriptor returned by :c:func:`open()`. 2954f38fcaSMauro Carvalho Chehab 3054f38fcaSMauro Carvalho Chehab``strength`` 3154f38fcaSMauro Carvalho Chehab The signal strength value is stored into \*strength. 3254f38fcaSMauro Carvalho Chehab 3354f38fcaSMauro Carvalho ChehabDescription 3454f38fcaSMauro Carvalho Chehab=========== 3554f38fcaSMauro Carvalho Chehab 3654f38fcaSMauro Carvalho ChehabThis ioctl call returns the signal strength value for the signal 3754f38fcaSMauro Carvalho Chehabcurrently received by the front-end. For this command, read-only access 3854f38fcaSMauro Carvalho Chehabto the device is sufficient. 3954f38fcaSMauro Carvalho Chehab 4054f38fcaSMauro Carvalho ChehabReturn Value 4154f38fcaSMauro Carvalho Chehab============ 4254f38fcaSMauro Carvalho Chehab 4354f38fcaSMauro Carvalho ChehabOn success 0 is returned. 4454f38fcaSMauro Carvalho Chehab 4554f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set 4654f38fcaSMauro Carvalho Chehabappropriately. 4754f38fcaSMauro Carvalho Chehab 4854f38fcaSMauro Carvalho ChehabGeneric error codes are described at the 4954f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 50