1.. Permission is granted to copy, distribute and/or modify this
2.. document under the terms of the GNU Free Documentation License,
3.. Version 1.1 or any later version published by the Free Software
4.. Foundation, with no Invariant Sections, no Front-Cover Texts
5.. and no Back-Cover Texts. A copy of the license is included at
6.. Documentation/userspace-api/media/fdl-appendix.rst.
7..
8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10.. _FE_SET_FRONTEND_TUNE_MODE:
11
12*******************************
13ioctl FE_SET_FRONTEND_TUNE_MODE
14*******************************
15
16Name
17====
18
19FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
20
21
22Synopsis
23========
24
25.. c:function:: int ioctl( int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags )
26    :name: FE_SET_FRONTEND_TUNE_MODE
27
28
29Arguments
30=========
31
32``fd``
33    File descriptor returned by :ref:`open() <frontend_f_open>`.
34
35``flags``
36    Valid flags:
37
38    -  0 - normal tune mode
39
40    -  ``FE_TUNE_MODE_ONESHOT`` - When set, this flag will disable any
41       zigzagging or other "normal" tuning behaviour. Additionally,
42       there will be no automatic monitoring of the lock status, and
43       hence no frontend events will be generated. If a frontend device
44       is closed, this flag will be automatically turned off when the
45       device is reopened read-write.
46
47
48Description
49===========
50
51Allow setting tuner mode flags to the frontend, between 0 (normal) or
52``FE_TUNE_MODE_ONESHOT`` mode
53
54
55Return Value
56============
57
58On success 0 is returned.
59
60On error -1 is returned, and the ``errno`` variable is set
61appropriately.
62
63Generic error codes are described at the
64:ref:`Generic Error Codes <gen-errors>` chapter.
65