699f19e3f1
The usage of the term "DVB" at the dvb API docs is confusing, as, right now, it can refer to either the European digital TV standard or to the subsystem. So, prefer calling it as "Digital TV" on most places, to avoid ambiguity. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
74 lines
1.7 KiB
ReStructuredText
74 lines
1.7 KiB
ReStructuredText
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _FE_GET_PROPERTY:
|
|
|
|
**************************************
|
|
ioctl FE_SET_PROPERTY, FE_GET_PROPERTY
|
|
**************************************
|
|
|
|
Name
|
|
====
|
|
|
|
FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties.
|
|
|
|
|
|
Synopsis
|
|
========
|
|
|
|
.. c:function:: int ioctl( int fd, FE_GET_PROPERTY, struct dtv_properties *argp )
|
|
:name: FE_GET_PROPERTY
|
|
|
|
.. c:function:: int ioctl( int fd, FE_SET_PROPERTY, struct dtv_properties *argp )
|
|
:name: FE_SET_PROPERTY
|
|
|
|
|
|
Arguments
|
|
=========
|
|
|
|
``fd``
|
|
File descriptor returned by :ref:`open() <frontend_f_open>`.
|
|
|
|
``argp``
|
|
Pointer to struct :c:type:`dtv_properties`.
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
All Digital TV frontend devices support the ``FE_SET_PROPERTY`` and
|
|
``FE_GET_PROPERTY`` ioctls. The supported properties and statistics
|
|
depends on the delivery system and on the device:
|
|
|
|
- ``FE_SET_PROPERTY:``
|
|
|
|
- This ioctl is used to set one or more frontend properties.
|
|
|
|
- This is the basic command to request the frontend to tune into
|
|
some frequency and to start decoding the digital TV signal.
|
|
|
|
- This call requires read/write access to the device.
|
|
|
|
- At return, the values are updated to reflect the actual parameters
|
|
used.
|
|
|
|
- ``FE_GET_PROPERTY:``
|
|
|
|
- This ioctl is used to get properties and statistics from the
|
|
frontend.
|
|
|
|
- No properties are changed, and statistics aren't reset.
|
|
|
|
- This call only requires read-only access to the device.
|
|
|
|
|
|
Return Value
|
|
============
|
|
|
|
On success 0 is returned.
|
|
|
|
On error -1 is returned, and the ``errno`` variable is set
|
|
appropriately.
|
|
|
|
Generic error codes are described at the
|
|
:ref:`Generic Error Codes <gen-errors>` chapter.
|