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 struct
38    :c:type:`dvb_frontend_info`
39
40
41Description
42===========
43
44All Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is
45used to identify kernel devices compatible with this specification and to
46obtain information about driver and hardware capabilities. The ioctl
47takes a pointer to dvb_frontend_info which is filled by the driver.
48When the driver is not compatible with this specification the ioctl
49returns an error.
50
51
52frontend capabilities
53=====================
54
55Capabilities describe what a frontend can do. Some capabilities are
56supported only on some specific frontend types.
57
58The frontend capabilities are described at :c:type:`fe_caps`.
59
60
61Return Value
62============
63
64On success 0 is returned.
65
66On error -1 is returned, and the ``errno`` variable is set
67appropriately.
68
69Generic error codes are described at the
70:ref:`Generic Error Codes <gen-errors>` chapter.
71