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