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