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