xref: /linux/Documentation/userspace-api/media/dvb/fe-get-info.rst (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
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.
60