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