154f38fcaSMauro Carvalho Chehab.. Permission is granted to copy, distribute and/or modify this 254f38fcaSMauro Carvalho Chehab.. document under the terms of the GNU Free Documentation License, 354f38fcaSMauro Carvalho Chehab.. Version 1.1 or any later version published by the Free Software 454f38fcaSMauro Carvalho Chehab.. Foundation, with no Invariant Sections, no Front-Cover Texts 554f38fcaSMauro Carvalho Chehab.. and no Back-Cover Texts. A copy of the license is included at 654f38fcaSMauro Carvalho Chehab.. Documentation/userspace-api/media/fdl-appendix.rst. 754f38fcaSMauro Carvalho Chehab.. 854f38fcaSMauro Carvalho Chehab.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho Chehab.. _FE_GET_INFO: 1154f38fcaSMauro Carvalho Chehab 1254f38fcaSMauro Carvalho Chehab***************** 1354f38fcaSMauro Carvalho Chehabioctl FE_GET_INFO 1454f38fcaSMauro Carvalho Chehab***************** 1554f38fcaSMauro Carvalho Chehab 1654f38fcaSMauro Carvalho ChehabName 1754f38fcaSMauro Carvalho Chehab==== 1854f38fcaSMauro Carvalho Chehab 1954f38fcaSMauro Carvalho ChehabFE_GET_INFO - Query Digital TV frontend capabilities and returns information 2054f38fcaSMauro Carvalho Chehababout the - front-end. This call only requires read-only access to the device. 2154f38fcaSMauro Carvalho Chehab 2254f38fcaSMauro Carvalho Chehab 2354f38fcaSMauro Carvalho ChehabSynopsis 2454f38fcaSMauro Carvalho Chehab======== 2554f38fcaSMauro Carvalho Chehab 2654f38fcaSMauro Carvalho Chehab.. c:function:: int ioctl( int fd, FE_GET_INFO, struct dvb_frontend_info *argp ) 2754f38fcaSMauro Carvalho Chehab :name: FE_GET_INFO 2854f38fcaSMauro Carvalho Chehab 2954f38fcaSMauro Carvalho Chehab 3054f38fcaSMauro Carvalho ChehabArguments 3154f38fcaSMauro Carvalho Chehab========= 3254f38fcaSMauro Carvalho Chehab 3354f38fcaSMauro Carvalho Chehab``fd`` 3454f38fcaSMauro Carvalho Chehab File descriptor returned by :ref:`open() <frontend_f_open>`. 3554f38fcaSMauro Carvalho Chehab 3654f38fcaSMauro Carvalho Chehab``argp`` 37b4cc96f9SRandy Dunlap pointer to struct :c:type:`dvb_frontend_info` 3854f38fcaSMauro Carvalho Chehab 3954f38fcaSMauro Carvalho Chehab 4054f38fcaSMauro Carvalho ChehabDescription 4154f38fcaSMauro Carvalho Chehab=========== 4254f38fcaSMauro Carvalho Chehab 4354f38fcaSMauro Carvalho ChehabAll Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is 4454f38fcaSMauro Carvalho Chehabused to identify kernel devices compatible with this specification and to 4554f38fcaSMauro Carvalho Chehabobtain information about driver and hardware capabilities. The ioctl 4654f38fcaSMauro Carvalho Chehabtakes a pointer to dvb_frontend_info which is filled by the driver. 4754f38fcaSMauro Carvalho ChehabWhen the driver is not compatible with this specification the ioctl 4854f38fcaSMauro Carvalho Chehabreturns an error. 4954f38fcaSMauro Carvalho Chehab 5054f38fcaSMauro Carvalho Chehab 5154f38fcaSMauro Carvalho Chehabfrontend capabilities 5254f38fcaSMauro Carvalho Chehab===================== 5354f38fcaSMauro Carvalho Chehab 5454f38fcaSMauro Carvalho ChehabCapabilities describe what a frontend can do. Some capabilities are 5554f38fcaSMauro Carvalho Chehabsupported only on some specific frontend types. 5654f38fcaSMauro Carvalho Chehab 5754f38fcaSMauro Carvalho ChehabThe frontend capabilities are described at :c:type:`fe_caps`. 5854f38fcaSMauro Carvalho Chehab 5954f38fcaSMauro Carvalho Chehab 6054f38fcaSMauro Carvalho ChehabReturn Value 6154f38fcaSMauro Carvalho Chehab============ 6254f38fcaSMauro Carvalho Chehab 6354f38fcaSMauro Carvalho ChehabOn success 0 is returned. 6454f38fcaSMauro Carvalho Chehab 6554f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set 6654f38fcaSMauro Carvalho Chehabappropriately. 6754f38fcaSMauro Carvalho Chehab 6854f38fcaSMauro Carvalho ChehabGeneric error codes are described at the 6954f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 70