Linux 4.8.3
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / fe-set-frontend-tune-mode.rst
blob411abcf4de582cc73e14606ea6c94c2c2b357c8e
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _FE_SET_FRONTEND_TUNE_MODE:
5 *******************************
6 ioctl FE_SET_FRONTEND_TUNE_MODE
7 *******************************
9 Name
10 ====
12 FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
15 Synopsis
16 ========
18 .. cpp:function:: int ioctl( int fd, int request, unsigned int flags )
21 Arguments
22 =========
24 ``fd``
25     File descriptor returned by :ref:`open() <frontend_f_open>`.
27 ``request``
28     FE_SET_FRONTEND_TUNE_MODE
30 ``flags``
31     Valid flags:
33     -  0 - normal tune mode
35     -  FE_TUNE_MODE_ONESHOT - When set, this flag will disable any
36        zigzagging or other "normal" tuning behaviour. Additionally,
37        there will be no automatic monitoring of the lock status, and
38        hence no frontend events will be generated. If a frontend device
39        is closed, this flag will be automatically turned off when the
40        device is reopened read-write.
43 Description
44 ===========
46 Allow setting tuner mode flags to the frontend, between 0 (normal) or
47 FE_TUNE_MODE_ONESHOT mode
50 Return Value
51 ============
53 On success 0 is returned, on error -1 and the ``errno`` variable is set
54 appropriately. The generic error codes are described at the
55 :ref:`Generic Error Codes <gen-errors>` chapter.