Linux 4.11-rc6
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / fe-read-snr.rst
blob2aed487f5c993612151d334bb6fcbdffa07b9cb0
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _FE_READ_SNR:
5 ***********
6 FE_READ_SNR
7 ***********
9 Name
10 ====
12 FE_READ_SNR
14 .. attention:: This ioctl is deprecated.
16 Synopsis
17 ========
19 .. c:function:: int  ioctl(int fd, FE_READ_SNR, int16_t *snr)
20     :name: FE_READ_SNR
23 Arguments
24 =========
26 ``fd``
27     File descriptor returned by :c:func:`open() <dvb-fe-open>`.
29 ``snr``
30     The signal-to-noise ratio is stored into \*snr.
33 Description
34 ===========
36 This ioctl call returns the signal-to-noise ratio for the signal
37 currently received by the front-end. For this command, read-only access
38 to the device is sufficient.
41 Return Value
42 ============
44 On success 0 is returned, on error -1 and the ``errno`` variable is set
45 appropriately. The generic error codes are described at the
46 :ref:`Generic Error Codes <gen-errors>` chapter.