xref: /linux/Documentation/userspace-api/media/dvb/fe-read-uncorrected-blocks.rst (revision 2c739ced5886cd8c8361faa79a9522ec05174ed0)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _FE_READ_UNCORRECTED_BLOCKS:
4
5**************************
6FE_READ_UNCORRECTED_BLOCKS
7**************************
8
9Name
10====
11
12FE_READ_UNCORRECTED_BLOCKS
13
14.. attention:: This ioctl is deprecated.
15
16Synopsis
17========
18
19.. c:function:: int ioctl( int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)
20    :name: FE_READ_UNCORRECTED_BLOCKS
21
22
23Arguments
24=========
25
26``fd``
27    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
28
29``ublocks``
30    The total number of uncorrected blocks seen by the driver so far.
31
32
33Description
34===========
35
36This ioctl call returns the number of uncorrected blocks detected by the
37device driver during its lifetime. For meaningful measurements, the
38increment in block count during a specific time interval should be
39calculated. For this command, read-only access to the device is
40sufficient.
41
42
43Return Value
44============
45
46On success 0 is returned.
47
48On error -1 is returned, and the ``errno`` variable is set
49appropriately.
50
51Generic error codes are described at the
52:ref:`Generic Error Codes <gen-errors>` chapter.
53