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_GET_INFO: 554f38fcaSMauro Carvalho Chehab 654f38fcaSMauro Carvalho Chehab***************** 754f38fcaSMauro Carvalho Chehabioctl FE_GET_INFO 854f38fcaSMauro Carvalho Chehab***************** 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho ChehabName 1154f38fcaSMauro Carvalho Chehab==== 1254f38fcaSMauro Carvalho Chehab 1354f38fcaSMauro Carvalho ChehabFE_GET_INFO - Query Digital TV frontend capabilities and returns information 1454f38fcaSMauro Carvalho Chehababout the - front-end. This call only requires read-only access to the device. 1554f38fcaSMauro Carvalho Chehab 1654f38fcaSMauro Carvalho ChehabSynopsis 1754f38fcaSMauro Carvalho Chehab======== 1854f38fcaSMauro Carvalho Chehab 19f9b2e8aaSMauro Carvalho Chehab.. c:macro:: FE_GET_INFO 2054f38fcaSMauro Carvalho Chehab 21f9b2e8aaSMauro Carvalho Chehab``int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)`` 2254f38fcaSMauro Carvalho Chehab 2354f38fcaSMauro Carvalho ChehabArguments 2454f38fcaSMauro Carvalho Chehab========= 2554f38fcaSMauro Carvalho Chehab 2654f38fcaSMauro Carvalho Chehab``fd`` 27f9b2e8aaSMauro Carvalho Chehab File descriptor returned by :c:func:`open()`. 2854f38fcaSMauro Carvalho Chehab 2954f38fcaSMauro Carvalho Chehab``argp`` 30b4cc96f9SRandy Dunlap pointer to struct :c:type:`dvb_frontend_info` 3154f38fcaSMauro Carvalho Chehab 3254f38fcaSMauro Carvalho ChehabDescription 3354f38fcaSMauro Carvalho Chehab=========== 3454f38fcaSMauro Carvalho Chehab 3554f38fcaSMauro Carvalho ChehabAll Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is 3654f38fcaSMauro Carvalho Chehabused to identify kernel devices compatible with this specification and to 3754f38fcaSMauro Carvalho Chehabobtain information about driver and hardware capabilities. The ioctl 3854f38fcaSMauro Carvalho Chehabtakes a pointer to dvb_frontend_info which is filled by the driver. 3954f38fcaSMauro Carvalho ChehabWhen the driver is not compatible with this specification the ioctl 4054f38fcaSMauro Carvalho Chehabreturns an error. 4154f38fcaSMauro Carvalho Chehab 4254f38fcaSMauro Carvalho Chehabfrontend capabilities 4354f38fcaSMauro Carvalho Chehab===================== 4454f38fcaSMauro Carvalho Chehab 4554f38fcaSMauro Carvalho ChehabCapabilities describe what a frontend can do. Some capabilities are 4654f38fcaSMauro Carvalho Chehabsupported only on some specific frontend types. 4754f38fcaSMauro Carvalho Chehab 4854f38fcaSMauro Carvalho ChehabThe frontend capabilities are described at :c:type:`fe_caps`. 4954f38fcaSMauro Carvalho Chehab 5054f38fcaSMauro Carvalho ChehabReturn Value 5154f38fcaSMauro Carvalho Chehab============ 5254f38fcaSMauro Carvalho Chehab 5354f38fcaSMauro Carvalho ChehabOn success 0 is returned. 5454f38fcaSMauro Carvalho Chehab 5554f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set 5654f38fcaSMauro Carvalho Chehabappropriately. 5754f38fcaSMauro Carvalho Chehab 5854f38fcaSMauro Carvalho ChehabGeneric error codes are described at the 5954f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 60