xref: /linux/Documentation/userspace-api/media/dvb/fe-get-frontend.rst (revision 24bce201d79807b668bf9d9e0aca801c5c0d5f78)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: DTV.fe
3
4.. _FE_GET_FRONTEND:
5
6***************
7FE_GET_FRONTEND
8***************
9
10Name
11====
12
13FE_GET_FRONTEND
14
15.. attention:: This ioctl is deprecated.
16
17Synopsis
18========
19
20.. c:macro:: FE_GET_FRONTEND
21
22``int ioctl(int fd, FE_GET_FRONTEND, struct dvb_frontend_parameters *p)``
23
24Arguments
25=========
26
27``fd``
28    File descriptor returned by :c:func:`open()`.
29
30``p``
31    Points to parameters for tuning operation.
32
33Description
34===========
35
36This ioctl call queries the currently effective frontend parameters. For
37this command, read-only access to the device is sufficient.
38
39Return Value
40============
41
42On success 0 is returned.
43
44On error -1 is returned, and the ``errno`` variable is set
45appropriately.
46
47.. flat-table::
48    :header-rows:  0
49    :stub-columns: 0
50
51    -  .. row 1
52
53       -  ``EINVAL``
54
55       -  Maximum supported symbol rate reached.
56
57Generic error codes are described at the
58:ref:`Generic Error Codes <gen-errors>` chapter.
59