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.. _dvb-fe-read-status:
11
12***************************************
13Querying frontend status and statistics
14***************************************
15
16Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
17frontend will run a kernel thread that will periodically check for the
18tuner lock status and provide statistics about the quality of the
19signal.
20
21The information about the frontend tuner locking status can be queried
22using :ref:`FE_READ_STATUS`.
23
24Signal statistics are provided via
25:ref:`FE_GET_PROPERTY`.
26
27.. note::
28
29   Most statistics require the demodulator to be fully locked
30   (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
31   :ref:`Frontend statistics indicators <frontend-stat-properties>` for
32   more details.
33