1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 2f9b2e8aaSMauro Carvalho Chehab.. c:namespace:: DTV.fe 354f38fcaSMauro Carvalho Chehab 454f38fcaSMauro Carvalho Chehab.. _FE_SET_FRONTEND_TUNE_MODE: 554f38fcaSMauro Carvalho Chehab 654f38fcaSMauro Carvalho Chehab******************************* 754f38fcaSMauro Carvalho Chehabioctl FE_SET_FRONTEND_TUNE_MODE 854f38fcaSMauro Carvalho Chehab******************************* 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho ChehabName 1154f38fcaSMauro Carvalho Chehab==== 1254f38fcaSMauro Carvalho Chehab 1354f38fcaSMauro Carvalho ChehabFE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend. 1454f38fcaSMauro Carvalho Chehab 1554f38fcaSMauro Carvalho ChehabSynopsis 1654f38fcaSMauro Carvalho Chehab======== 1754f38fcaSMauro Carvalho Chehab 18f9b2e8aaSMauro Carvalho Chehab.. c:macro:: FE_SET_FRONTEND_TUNE_MODE 1954f38fcaSMauro Carvalho Chehab 20f9b2e8aaSMauro Carvalho Chehab``int ioctl(int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags)`` 2154f38fcaSMauro Carvalho Chehab 2254f38fcaSMauro Carvalho ChehabArguments 2354f38fcaSMauro Carvalho Chehab========= 2454f38fcaSMauro Carvalho Chehab 2554f38fcaSMauro Carvalho Chehab``fd`` 26f9b2e8aaSMauro Carvalho Chehab File descriptor returned by :c:func:`open()`. 2754f38fcaSMauro Carvalho Chehab 2854f38fcaSMauro Carvalho Chehab``flags`` 2954f38fcaSMauro Carvalho Chehab Valid flags: 3054f38fcaSMauro Carvalho Chehab 3154f38fcaSMauro Carvalho Chehab - 0 - normal tune mode 3254f38fcaSMauro Carvalho Chehab 3354f38fcaSMauro Carvalho Chehab - ``FE_TUNE_MODE_ONESHOT`` - When set, this flag will disable any 3454f38fcaSMauro Carvalho Chehab zigzagging or other "normal" tuning behaviour. Additionally, 3554f38fcaSMauro Carvalho Chehab there will be no automatic monitoring of the lock status, and 3654f38fcaSMauro Carvalho Chehab hence no frontend events will be generated. If a frontend device 3754f38fcaSMauro Carvalho Chehab is closed, this flag will be automatically turned off when the 3854f38fcaSMauro Carvalho Chehab device is reopened read-write. 3954f38fcaSMauro Carvalho Chehab 4054f38fcaSMauro Carvalho ChehabDescription 4154f38fcaSMauro Carvalho Chehab=========== 4254f38fcaSMauro Carvalho Chehab 4354f38fcaSMauro Carvalho ChehabAllow setting tuner mode flags to the frontend, between 0 (normal) or 4454f38fcaSMauro Carvalho Chehab``FE_TUNE_MODE_ONESHOT`` mode 4554f38fcaSMauro Carvalho Chehab 4654f38fcaSMauro Carvalho ChehabReturn Value 4754f38fcaSMauro Carvalho Chehab============ 4854f38fcaSMauro Carvalho Chehab 4954f38fcaSMauro Carvalho ChehabOn success 0 is returned. 5054f38fcaSMauro Carvalho Chehab 5154f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set 5254f38fcaSMauro Carvalho Chehabappropriately. 5354f38fcaSMauro Carvalho Chehab 5454f38fcaSMauro Carvalho ChehabGeneric error codes are described at the 5554f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 56