fe-set-frontend.rst 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. .. -*- coding: utf-8; mode: rst -*-
  2. .. _FE_SET_FRONTEND:
  3. ***************
  4. FE_SET_FRONTEND
  5. ***************
  6. .. attention:: This ioctl is deprecated.
  7. Name
  8. ====
  9. FE_SET_FRONTEND
  10. Synopsis
  11. ========
  12. .. c:function:: int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)
  13. :name: FE_SET_FRONTEND
  14. Arguments
  15. =========
  16. ``fd``
  17. File descriptor returned by :c:func:`open() <dvb-fe-open>`.
  18. ``p``
  19. Points to parameters for tuning operation.
  20. Description
  21. ===========
  22. This ioctl call starts a tuning operation using specified parameters.
  23. The result of this call will be successful if the parameters were valid
  24. and the tuning could be initiated. The result of the tuning operation in
  25. itself, however, will arrive asynchronously as an event (see
  26. documentation for :ref:`FE_GET_EVENT` and
  27. FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
  28. operation is initiated before the previous one was completed, the
  29. previous operation will be aborted in favor of the new one. This command
  30. requires read/write access to the device.
  31. Return Value
  32. ============
  33. On success 0 is returned, on error -1 and the ``errno`` variable is set
  34. appropriately. The generic error codes are described at the
  35. :ref:`Generic Error Codes <gen-errors>` chapter.
  36. .. flat-table::
  37. :header-rows: 0
  38. :stub-columns: 0
  39. - .. row 1
  40. - ``EINVAL``
  41. - Maximum supported symbol rate reached.