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