fe-read-uncorrected-blocks.rst 1.1 KB

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