Merge tag 'for-v4.21' of git://git.kernel.org/pub/scm/linux/kernel/git/sre/linux...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / dvb / fe-diseqc-reset-overload.rst
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/media/uapi/fdl-appendix.rst.
7 ..
8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10 .. _FE_DISEQC_RESET_OVERLOAD:
11
12 ******************************
13 ioctl FE_DISEQC_RESET_OVERLOAD
14 ******************************
15
16 Name
17 ====
18
19 FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload.
20
21
22 Synopsis
23 ========
24
25 .. c:function:: int ioctl( int fd, FE_DISEQC_RESET_OVERLOAD, NULL )
26     :name: FE_DISEQC_RESET_OVERLOAD
27
28
29 Arguments
30 =========
31
32 ``fd``
33     File descriptor returned by :ref:`open() <frontend_f_open>`.
34
35 Description
36 ===========
37
38 If the bus has been automatically powered off due to power overload,
39 this ioctl call restores the power to the bus. The call requires
40 read/write access to the device. This call has no effect if the device
41 is manually powered off. Not all Digital TV adapters support this ioctl.
42
43
44 Return Value
45 ============
46
47 On success 0 is returned.
48
49 On error -1 is returned, and the ``errno`` variable is set
50 appropriately.
51
52 Generic error codes are described at the
53 :ref:`Generic Error Codes <gen-errors>` chapter.