162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 262306a36Sopenharmony_ci.. c:namespace:: DTV.fe 362306a36Sopenharmony_ci 462306a36Sopenharmony_ci.. _FE_SET_FRONTEND: 562306a36Sopenharmony_ci 662306a36Sopenharmony_ci*************** 762306a36Sopenharmony_ciFE_SET_FRONTEND 862306a36Sopenharmony_ci*************** 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ci.. attention:: This ioctl is deprecated. 1162306a36Sopenharmony_ci 1262306a36Sopenharmony_ciName 1362306a36Sopenharmony_ci==== 1462306a36Sopenharmony_ci 1562306a36Sopenharmony_ciFE_SET_FRONTEND 1662306a36Sopenharmony_ci 1762306a36Sopenharmony_ciSynopsis 1862306a36Sopenharmony_ci======== 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci.. c:macro:: FE_SET_FRONTEND 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ci``int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)`` 2362306a36Sopenharmony_ci 2462306a36Sopenharmony_ciArguments 2562306a36Sopenharmony_ci========= 2662306a36Sopenharmony_ci 2762306a36Sopenharmony_ci``fd`` 2862306a36Sopenharmony_ci File descriptor returned by :c:func:`open()`. 2962306a36Sopenharmony_ci 3062306a36Sopenharmony_ci``p`` 3162306a36Sopenharmony_ci Points to parameters for tuning operation. 3262306a36Sopenharmony_ci 3362306a36Sopenharmony_ciDescription 3462306a36Sopenharmony_ci=========== 3562306a36Sopenharmony_ci 3662306a36Sopenharmony_ciThis ioctl call starts a tuning operation using specified parameters. 3762306a36Sopenharmony_ciThe result of this call will be successful if the parameters were valid 3862306a36Sopenharmony_ciand the tuning could be initiated. The result of the tuning operation in 3962306a36Sopenharmony_ciitself, however, will arrive asynchronously as an event (see 4062306a36Sopenharmony_cidocumentation for :ref:`FE_GET_EVENT` and 4162306a36Sopenharmony_ciFrontendEvent.) If a new :ref:`FE_SET_FRONTEND` 4262306a36Sopenharmony_cioperation is initiated before the previous one was completed, the 4362306a36Sopenharmony_ciprevious operation will be aborted in favor of the new one. This command 4462306a36Sopenharmony_cirequires read/write access to the device. 4562306a36Sopenharmony_ci 4662306a36Sopenharmony_ciReturn Value 4762306a36Sopenharmony_ci============ 4862306a36Sopenharmony_ci 4962306a36Sopenharmony_ciOn success 0 is returned. 5062306a36Sopenharmony_ci 5162306a36Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set 5262306a36Sopenharmony_ciappropriately. 5362306a36Sopenharmony_ci 5462306a36Sopenharmony_ci.. tabularcolumns:: |p{2.5cm}|p{15.0cm}| 5562306a36Sopenharmony_ci 5662306a36Sopenharmony_ci.. flat-table:: 5762306a36Sopenharmony_ci :header-rows: 0 5862306a36Sopenharmony_ci :stub-columns: 0 5962306a36Sopenharmony_ci :widths: 1 16 6062306a36Sopenharmony_ci 6162306a36Sopenharmony_ci - .. row 1 6262306a36Sopenharmony_ci 6362306a36Sopenharmony_ci - ``EINVAL`` 6462306a36Sopenharmony_ci 6562306a36Sopenharmony_ci - Maximum supported symbol rate reached. 6662306a36Sopenharmony_ci 6762306a36Sopenharmony_ciGeneric error codes are described at the 6862306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter. 69