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_GET_PROPERTY: 4 .. _FE_GET_PROPERTY:
5 5
6 ************************************** 6 **************************************
7 ioctl FE_SET_PROPERTY, FE_GET_PROPERTY 7 ioctl FE_SET_PROPERTY, FE_GET_PROPERTY
8 ************************************** 8 **************************************
9 9
10 Name 10 Name
11 ==== 11 ====
12 12
13 FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PRO 13 FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties.
14 14
15 Synopsis 15 Synopsis
16 ======== 16 ========
17 17
18 .. c:macro:: FE_GET_PROPERTY 18 .. c:macro:: FE_GET_PROPERTY
19 19
20 ``int ioctl(int fd, FE_GET_PROPERTY, struct dt 20 ``int ioctl(int fd, FE_GET_PROPERTY, struct dtv_properties *argp)``
21 21
22 .. c:macro:: FE_SET_PROPERTY 22 .. c:macro:: FE_SET_PROPERTY
23 23
24 ``int ioctl(int fd, FE_SET_PROPERTY, struct dt 24 ``int ioctl(int fd, FE_SET_PROPERTY, struct dtv_properties *argp)``
25 25
26 Arguments 26 Arguments
27 ========= 27 =========
28 28
29 ``fd`` 29 ``fd``
30 File descriptor returned by :c:func:`open( 30 File descriptor returned by :c:func:`open()`.
31 31
32 ``argp`` 32 ``argp``
33 Pointer to struct :c:type:`dtv_properties` 33 Pointer to struct :c:type:`dtv_properties`.
34 34
35 Description 35 Description
36 =========== 36 ===========
37 37
38 All Digital TV frontend devices support the `` 38 All Digital TV frontend devices support the ``FE_SET_PROPERTY`` and
39 ``FE_GET_PROPERTY`` ioctls. The supported prop 39 ``FE_GET_PROPERTY`` ioctls. The supported properties and statistics
40 depends on the delivery system and on the devi 40 depends on the delivery system and on the device:
41 41
42 - ``FE_SET_PROPERTY:`` 42 - ``FE_SET_PROPERTY:``
43 43
44 - This ioctl is used to set one or more fr 44 - This ioctl is used to set one or more frontend properties.
45 45
46 - This is the basic command to request the 46 - This is the basic command to request the frontend to tune into
47 some frequency and to start decoding the 47 some frequency and to start decoding the digital TV signal.
48 48
49 - This call requires read/write access to 49 - This call requires read/write access to the device.
50 50
51 .. note:: 51 .. note::
52 52
53 At return, the values aren't updated to ref 53 At return, the values aren't updated to reflect the actual
54 parameters used. If the actual parameters a 54 parameters used. If the actual parameters are needed, an explicit
55 call to ``FE_GET_PROPERTY`` is needed. 55 call to ``FE_GET_PROPERTY`` is needed.
56 56
57 - ``FE_GET_PROPERTY:`` 57 - ``FE_GET_PROPERTY:``
58 58
59 - This ioctl is used to get properties and 59 - This ioctl is used to get properties and statistics from the
60 frontend. 60 frontend.
61 61
62 - No properties are changed, and statistic 62 - No properties are changed, and statistics aren't reset.
63 63
64 - This call only requires read-only access 64 - This call only requires read-only access to the device.
65 65
66 Return Value 66 Return Value
67 ============ 67 ============
68 68
69 On success 0 is returned. 69 On success 0 is returned.
70 70
71 On error -1 is returned, and the ``errno`` var 71 On error -1 is returned, and the ``errno`` variable is set
72 appropriately. 72 appropriately.
73 73
74 Generic error codes are described at the 74 Generic error codes are described at the
75 :ref:`Generic Error Codes <gen-errors>` chapte 75 :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.