1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _FE_SET_FRONTEND:
4
5***************
6FE_SET_FRONTEND
7***************
8
9.. attention:: This ioctl is deprecated.
10
11Name
12====
13
14FE_SET_FRONTEND
15
16
17Synopsis
18========
19
20.. c:function:: int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)
21    :name: FE_SET_FRONTEND
22
23
24Arguments
25=========
26
27``fd``
28    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
29
30``p``
31    Points to parameters for tuning operation.
32
33
34Description
35===========
36
37This ioctl call starts a tuning operation using specified parameters.
38The result of this call will be successful if the parameters were valid
39and the tuning could be initiated. The result of the tuning operation in
40itself, however, will arrive asynchronously as an event (see
41documentation for :ref:`FE_GET_EVENT` and
42FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
43operation is initiated before the previous one was completed, the
44previous operation will be aborted in favor of the new one. This command
45requires read/write access to the device.
46
47
48Return Value
49============
50
51On success 0 is returned.
52
53On error -1 is returned, and the ``errno`` variable is set
54appropriately.
55
56.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
57
58.. flat-table::
59    :header-rows:  0
60    :stub-columns: 0
61    :widths: 1 16
62
63    -  .. row 1
64
65       -  ``EINVAL``
66
67       -  Maximum supported symbol rate reached.
68
69
70Generic error codes are described at the
71:ref:`Generic Error Codes <gen-errors>` chapter.
72