fe-get-info.rst (1421B)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 2.. c:namespace:: DTV.fe 3 4.. _FE_GET_INFO: 5 6***************** 7ioctl FE_GET_INFO 8***************** 9 10Name 11==== 12 13FE_GET_INFO - Query Digital TV frontend capabilities and returns information 14about the - front-end. This call only requires read-only access to the device. 15 16Synopsis 17======== 18 19.. c:macro:: FE_GET_INFO 20 21``int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)`` 22 23Arguments 24========= 25 26``fd`` 27 File descriptor returned by :c:func:`open()`. 28 29``argp`` 30 pointer to struct :c:type:`dvb_frontend_info` 31 32Description 33=========== 34 35All Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is 36used to identify kernel devices compatible with this specification and to 37obtain information about driver and hardware capabilities. The ioctl 38takes a pointer to dvb_frontend_info which is filled by the driver. 39When the driver is not compatible with this specification the ioctl 40returns an error. 41 42frontend capabilities 43===================== 44 45Capabilities describe what a frontend can do. Some capabilities are 46supported only on some specific frontend types. 47 48The frontend capabilities are described at :c:type:`fe_caps`. 49 50Return Value 51============ 52 53On success 0 is returned. 54 55On error -1 is returned, and the ``errno`` variable is set 56appropriately. 57 58Generic error codes are described at the 59:ref:`Generic Error Codes <gen-errors>` chapter.