1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _FE_READ_SIGNAL_STRENGTH:
4
5***********************
6FE_READ_SIGNAL_STRENGTH
7***********************
8
9Name
10====
11
12FE_READ_SIGNAL_STRENGTH
13
14.. attention:: This ioctl is deprecated.
15
16Synopsis
17========
18
19.. c:function:: int ioctl( int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)
20    :name: FE_READ_SIGNAL_STRENGTH
21
22
23Arguments
24=========
25
26``fd``
27    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
28
29``strength``
30    The signal strength value is stored into \*strength.
31
32
33Description
34===========
35
36This ioctl call returns the signal strength value for the signal
37currently received by the front-end. For this command, read-only access
38to the device is sufficient.
39
40
41Return Value
42============
43
44On success 0 is returned.
45
46On error -1 is returned, and the ``errno`` variable is set
47appropriately.
48
49Generic error codes are described at the
50:ref:`Generic Error Codes <gen-errors>` chapter.
51