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