18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 28c2ecf20Sopenharmony_ci.. c:namespace:: DTV.fe 38c2ecf20Sopenharmony_ci 48c2ecf20Sopenharmony_ci.. _FE_SET_FRONTEND: 58c2ecf20Sopenharmony_ci 68c2ecf20Sopenharmony_ci*************** 78c2ecf20Sopenharmony_ciFE_SET_FRONTEND 88c2ecf20Sopenharmony_ci*************** 98c2ecf20Sopenharmony_ci 108c2ecf20Sopenharmony_ci.. attention:: This ioctl is deprecated. 118c2ecf20Sopenharmony_ci 128c2ecf20Sopenharmony_ciName 138c2ecf20Sopenharmony_ci==== 148c2ecf20Sopenharmony_ci 158c2ecf20Sopenharmony_ciFE_SET_FRONTEND 168c2ecf20Sopenharmony_ci 178c2ecf20Sopenharmony_ciSynopsis 188c2ecf20Sopenharmony_ci======== 198c2ecf20Sopenharmony_ci 208c2ecf20Sopenharmony_ci.. c:macro:: FE_SET_FRONTEND 218c2ecf20Sopenharmony_ci 228c2ecf20Sopenharmony_ci``int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)`` 238c2ecf20Sopenharmony_ci 248c2ecf20Sopenharmony_ciArguments 258c2ecf20Sopenharmony_ci========= 268c2ecf20Sopenharmony_ci 278c2ecf20Sopenharmony_ci``fd`` 288c2ecf20Sopenharmony_ci File descriptor returned by :c:func:`open()`. 298c2ecf20Sopenharmony_ci 308c2ecf20Sopenharmony_ci``p`` 318c2ecf20Sopenharmony_ci Points to parameters for tuning operation. 328c2ecf20Sopenharmony_ci 338c2ecf20Sopenharmony_ciDescription 348c2ecf20Sopenharmony_ci=========== 358c2ecf20Sopenharmony_ci 368c2ecf20Sopenharmony_ciThis ioctl call starts a tuning operation using specified parameters. 378c2ecf20Sopenharmony_ciThe result of this call will be successful if the parameters were valid 388c2ecf20Sopenharmony_ciand the tuning could be initiated. The result of the tuning operation in 398c2ecf20Sopenharmony_ciitself, however, will arrive asynchronously as an event (see 408c2ecf20Sopenharmony_cidocumentation for :ref:`FE_GET_EVENT` and 418c2ecf20Sopenharmony_ciFrontendEvent.) If a new :ref:`FE_SET_FRONTEND` 428c2ecf20Sopenharmony_cioperation is initiated before the previous one was completed, the 438c2ecf20Sopenharmony_ciprevious operation will be aborted in favor of the new one. This command 448c2ecf20Sopenharmony_cirequires read/write access to the device. 458c2ecf20Sopenharmony_ci 468c2ecf20Sopenharmony_ciReturn Value 478c2ecf20Sopenharmony_ci============ 488c2ecf20Sopenharmony_ci 498c2ecf20Sopenharmony_ciOn success 0 is returned. 508c2ecf20Sopenharmony_ci 518c2ecf20Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set 528c2ecf20Sopenharmony_ciappropriately. 538c2ecf20Sopenharmony_ci 548c2ecf20Sopenharmony_ci.. tabularcolumns:: |p{2.5cm}|p{15.0cm}| 558c2ecf20Sopenharmony_ci 568c2ecf20Sopenharmony_ci.. flat-table:: 578c2ecf20Sopenharmony_ci :header-rows: 0 588c2ecf20Sopenharmony_ci :stub-columns: 0 598c2ecf20Sopenharmony_ci :widths: 1 16 608c2ecf20Sopenharmony_ci 618c2ecf20Sopenharmony_ci - .. row 1 628c2ecf20Sopenharmony_ci 638c2ecf20Sopenharmony_ci - ``EINVAL`` 648c2ecf20Sopenharmony_ci 658c2ecf20Sopenharmony_ci - Maximum supported symbol rate reached. 668c2ecf20Sopenharmony_ci 678c2ecf20Sopenharmony_ciGeneric error codes are described at the 688c2ecf20Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter. 69