0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.fe
0003
0004 .. _FE_SET_FRONTEND_TUNE_MODE:
0005
0006 *******************************
0007 ioctl FE_SET_FRONTEND_TUNE_MODE
0008 *******************************
0009
0010 Name
0011 ====
0012
0013 FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
0014
0015 Synopsis
0016 ========
0017
0018 .. c:macro:: FE_SET_FRONTEND_TUNE_MODE
0019
0020 ``int ioctl(int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags)``
0021
0022 Arguments
0023 =========
0024
0025 ``fd``
0026 File descriptor returned by :c:func:`open()`.
0027
0028 ``flags``
0029 Valid flags:
0030
0031 - 0 - normal tune mode
0032
0033 - ``FE_TUNE_MODE_ONESHOT`` - When set, this flag will disable any
0034 zigzagging or other "normal" tuning behaviour. Additionally,
0035 there will be no automatic monitoring of the lock status, and
0036 hence no frontend events will be generated. If a frontend device
0037 is closed, this flag will be automatically turned off when the
0038 device is reopened read-write.
0039
0040 Description
0041 ===========
0042
0043 Allow setting tuner mode flags to the frontend, between 0 (normal) or
0044 ``FE_TUNE_MODE_ONESHOT`` mode
0045
0046 Return Value
0047 ============
0048
0049 On success 0 is returned.
0050
0051 On error -1 is returned, and the ``errno`` variable is set
0052 appropriately.
0053
0054 Generic error codes are described at the
0055 :ref:`Generic Error Codes <gen-errors>` chapter.
