Documentation/userspace-api/media/dvb/fe-read-uncorrected-blocks.rst

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