1.. Permission is granted to copy, distribute and/or modify this
2.. document under the terms of the GNU Free Documentation License,
3.. Version 1.1 or any later version published by the Free Software
4.. Foundation, with no Invariant Sections, no Front-Cover Texts
5.. and no Back-Cover Texts. A copy of the license is included at
6.. Documentation/userspace-api/media/fdl-appendix.rst.
7..
8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10.. _FE_GET_INFO:
11
12*****************
13ioctl FE_GET_INFO
14*****************
15
16Name
17====
18
19FE_GET_INFO - Query Digital TV frontend capabilities and returns information
20about the - front-end. This call only requires read-only access to the device.
21
22
23Synopsis
24========
25
26.. c:function:: int ioctl( int fd, FE_GET_INFO, struct dvb_frontend_info *argp )
27    :name: FE_GET_INFO
28
29
30Arguments
31=========
32
33``fd``
34    File descriptor returned by :ref:`open() <frontend_f_open>`.
35
36``argp``
37    pointer to struct :c:type:`dvb_frontend_info`
38
39
40Description
41===========
42
43All Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is
44used to identify kernel devices compatible with this specification and to
45obtain information about driver and hardware capabilities. The ioctl
46takes a pointer to dvb_frontend_info which is filled by the driver.
47When the driver is not compatible with this specification the ioctl
48returns an error.
49
50
51frontend capabilities
52=====================
53
54Capabilities describe what a frontend can do. Some capabilities are
55supported only on some specific frontend types.
56
57The frontend capabilities are described at :c:type:`fe_caps`.
58
59
60Return Value
61============
62
63On success 0 is returned.
64
65On error -1 is returned, and the ``errno`` variable is set
66appropriately.
67
68Generic error codes are described at the
69:ref:`Generic Error Codes <gen-errors>` chapter.
70