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