fe-read-uncorrected-blocks.rst 1.1 KB

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