Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _FE_READ_UNCORRECTED_BLOCKS:
   4
   5 **************************
   6 FE_READ_UNCORRECTED_BLOCKS
   7 **************************
   8
   9 Description
  10 -----------
  11
  12 This ioctl call returns the number of uncorrected blocks detected by the
  13 device driver during its lifetime. For meaningful measurements, the
  14 increment in block count during a specific time interval should be
  15 calculated. For this command, read-only access to the device is
  16 sufficient.
  17
  18 Synopsis
  19 --------
  20
  21 .. c:function:: int ioctl( int fd, int request =FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)
  22
  23 Arguments
  24 ----------
  25
  26
  27
  28 .. flat-table::
  29     :header-rows:  0
  30     :stub-columns: 0
  31
  32
  33     -  .. row 1
  34
  35        -  int fd
  36
  37        -  File descriptor returned by a previous call to open().
  38
  39     -  .. row 2
  40
  41        -  int request
  42
  43        -  Equals
  44           :ref:`FE_READ_UNCORRECTED_BLOCKS`
  45           for this command.
  46
  47     -  .. row 3
  48
  49        -  uint32_t \*ublocks
  50
  51        -  The total number of uncorrected blocks seen by the driver so far.
  52
  53
  54 Return Value
  55 ------------
  56
  57 On success 0 is returned, on error -1 and the ``errno`` variable is set
  58 appropriately. The generic error codes are described at the
  59 :ref:`Generic Error Codes <gen-errors>` chapter.