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_TUNE_MODE: 562306a36Sopenharmony_ci 662306a36Sopenharmony_ci******************************* 762306a36Sopenharmony_ciioctl FE_SET_FRONTEND_TUNE_MODE 862306a36Sopenharmony_ci******************************* 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ciName 1162306a36Sopenharmony_ci==== 1262306a36Sopenharmony_ci 1362306a36Sopenharmony_ciFE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend. 1462306a36Sopenharmony_ci 1562306a36Sopenharmony_ciSynopsis 1662306a36Sopenharmony_ci======== 1762306a36Sopenharmony_ci 1862306a36Sopenharmony_ci.. c:macro:: FE_SET_FRONTEND_TUNE_MODE 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci``int ioctl(int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags)`` 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ciArguments 2362306a36Sopenharmony_ci========= 2462306a36Sopenharmony_ci 2562306a36Sopenharmony_ci``fd`` 2662306a36Sopenharmony_ci File descriptor returned by :c:func:`open()`. 2762306a36Sopenharmony_ci 2862306a36Sopenharmony_ci``flags`` 2962306a36Sopenharmony_ci Valid flags: 3062306a36Sopenharmony_ci 3162306a36Sopenharmony_ci - 0 - normal tune mode 3262306a36Sopenharmony_ci 3362306a36Sopenharmony_ci - ``FE_TUNE_MODE_ONESHOT`` - When set, this flag will disable any 3462306a36Sopenharmony_ci zigzagging or other "normal" tuning behaviour. Additionally, 3562306a36Sopenharmony_ci there will be no automatic monitoring of the lock status, and 3662306a36Sopenharmony_ci hence no frontend events will be generated. If a frontend device 3762306a36Sopenharmony_ci is closed, this flag will be automatically turned off when the 3862306a36Sopenharmony_ci device is reopened read-write. 3962306a36Sopenharmony_ci 4062306a36Sopenharmony_ciDescription 4162306a36Sopenharmony_ci=========== 4262306a36Sopenharmony_ci 4362306a36Sopenharmony_ciAllow setting tuner mode flags to the frontend, between 0 (normal) or 4462306a36Sopenharmony_ci``FE_TUNE_MODE_ONESHOT`` mode 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_ciGeneric error codes are described at the 5562306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter. 56