^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) .. c:namespace:: DTV.fe
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _FE_SET_FRONTEND_TUNE_MODE:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) *******************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) ioctl FE_SET_FRONTEND_TUNE_MODE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) *******************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) ====
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Synopsis
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) ========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) .. c:macro:: FE_SET_FRONTEND_TUNE_MODE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) ``int ioctl(int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Arguments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) =========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) ``fd``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) File descriptor returned by :c:func:`open()`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ``flags``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Valid flags:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) - 0 - normal tune mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) - ``FE_TUNE_MODE_ONESHOT`` - When set, this flag will disable any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) zigzagging or other "normal" tuning behaviour. Additionally,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) there will be no automatic monitoring of the lock status, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) hence no frontend events will be generated. If a frontend device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) is closed, this flag will be automatically turned off when the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) device is reopened read-write.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Allow setting tuner mode flags to the frontend, between 0 (normal) or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) ``FE_TUNE_MODE_ONESHOT`` mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) Return Value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) ============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) On success 0 is returned.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) On error -1 is returned, and the ``errno`` variable is set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) appropriately.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Generic error codes are described at the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) :ref:`Generic Error Codes <gen-errors>` chapter.