Skip to content

L
linux
Commit 586027ce authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files
Options

doc-rst: linux_tv: reformat all syscall pages 

The syscall pages are written to be used also as man-pages.

However, they don't match the format used by kernel-doc
generated pages from DocBook. Rewrite them to match it.

One side effect is that now all such pages at the book
will have the same format, reducing the format differences
between DVB and the other parts of the book.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 47d23e36
Expand all Show whitespace changes
Inline Side-by-side
Showing with 2261 additions and 1904 deletions
Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst
View file @ 586027ce
...@@ -6,27 +6,19 @@ ...@@ -6,27 +6,19 @@
FE_DISHNETWORK_SEND_LEGACY_CMD FE_DISHNETWORK_SEND_LEGACY_CMD
****************************** ******************************
Description NAME
----------- ====
WARNING: This is a very obscure legacy command, used only at stv0299 FE_DISHNETWORK_SEND_LEGACY_CMD
driver. Should not be used on newer drivers.
It provides a non-standard method for selecting Diseqc voltage on the
frontend, for Dish Network legacy switches.
As support for this ioctl were added in 2004, this means that such
dishes were already legacy in 2004.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl(int fd, int request = FE_DISHNETWORK_SEND_LEGACY_CMD, unsigned long cmd) .. c:function:: int ioctl(int fd, int request = FE_DISHNETWORK_SEND_LEGACY_CMD, unsigned long cmd)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -40,8 +32,21 @@ Arguments ...@@ -40,8 +32,21 @@ Arguments
- sends the specified raw cmd to the dish via DISEqC. - sends the specified raw cmd to the dish via DISEqC.
Return Value DESCRIPTION
------------ ===========
WARNING: This is a very obscure legacy command, used only at stv0299
driver. Should not be used on newer drivers.
It provides a non-standard method for selecting Diseqc voltage on the
frontend, for Dish Network legacy switches.
As support for this ioctl were added in 2004, this means that such
dishes were already legacy in 2004.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst
View file @ 586027ce
...@@ -6,24 +6,19 @@ ...@@ -6,24 +6,19 @@
FE_GET_EVENT FE_GET_EVENT
************ ************
Description NAME
----------- ====
This ioctl call returns a frontend event if available. If an event is FE_GET_EVENT
not available, the behavior depends on whether the device is in blocking
or non-blocking mode. In the latter case, the call fails immediately
with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until
an event becomes available.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl(int fd, int request = QPSK_GET_EVENT, struct dvb_frontend_event *ev) .. c:function:: int ioctl(int fd, int request = QPSK_GET_EVENT, struct dvb_frontend_event *ev)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -54,8 +49,18 @@ Arguments ...@@ -54,8 +49,18 @@ Arguments
- if any, is to be stored. - if any, is to be stored.
Return Value DESCRIPTION
------------ ===========
This ioctl call returns a frontend event if available. If an event is
not available, the behavior depends on whether the device is in blocking
or non-blocking mode. In the latter case, the call fails immediately
with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until
an event becomes available.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst
View file @ 586027ce
...@@ -6,21 +6,19 @@ ...@@ -6,21 +6,19 @@
FE_GET_FRONTEND FE_GET_FRONTEND
*************** ***************
Description NAME
----------- ====
This ioctl call queries the currently effective frontend parameters. For FE_GET_FRONTEND
this command, read-only access to the device is sufficient.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl(int fd, int request = FE_GET_FRONTEND, struct dvb_frontend_parameters *p) .. c:function:: int ioctl(int fd, int request = FE_GET_FRONTEND, struct dvb_frontend_parameters *p)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,8 +45,15 @@ Arguments ...@@ -47,8 +45,15 @@ Arguments
- Points to parameters for tuning operation. - Points to parameters for tuning operation.
Return Value DESCRIPTION
------------ ===========
This ioctl call queries the currently effective frontend parameters. For
this command, read-only access to the device is sufficient.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst
View file @ 586027ce
...@@ -6,22 +6,19 @@ ...@@ -6,22 +6,19 @@
FE_READ_SIGNAL_STRENGTH FE_READ_SIGNAL_STRENGTH
*********************** ***********************
Description NAME
----------- ====
This ioctl call returns the signal strength value for the signal FE_READ_SIGNAL_STRENGTH
currently received by the front-end. For this command, read-only access
to the device is sufficient.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl( int fd, int request = FE_READ_SIGNAL_STRENGTH, uint16_t *strength) .. c:function:: int ioctl( int fd, int request = FE_READ_SIGNAL_STRENGTH, uint16_t *strength)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -49,8 +46,16 @@ Arguments ...@@ -49,8 +46,16 @@ Arguments
- The signal strength value is stored into \*strength. - The signal strength value is stored into \*strength.
Return Value DESCRIPTION
------------ ===========
This ioctl call returns the signal strength value for the signal
currently received by the front-end. For this command, read-only access
to the device is sufficient.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_READ_SNR.rst
View file @ 586027ce
...@@ -6,22 +6,19 @@ ...@@ -6,22 +6,19 @@
FE_READ_SNR FE_READ_SNR
*********** ***********
Description NAME
----------- ====
This ioctl call returns the signal-to-noise ratio for the signal FE_READ_SNR
currently received by the front-end. For this command, read-only access
to the device is sufficient.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl(int fd, int request = FE_READ_SNR, int16_t *snr) .. c:function:: int ioctl(int fd, int request = FE_READ_SNR, int16_t *snr)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,8 +44,16 @@ Arguments ...@@ -47,8 +44,16 @@ Arguments
- The signal-to-noise ratio is stored into \*snr. - The signal-to-noise ratio is stored into \*snr.
Return Value DESCRIPTION
------------ ===========
This ioctl call returns the signal-to-noise ratio for the signal
currently received by the front-end. For this command, read-only access
to the device is sufficient.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst
View file @ 586027ce
...@@ -6,24 +6,19 @@ ...@@ -6,24 +6,19 @@
FE_READ_UNCORRECTED_BLOCKS FE_READ_UNCORRECTED_BLOCKS
************************** **************************
Description NAME
----------- ====
This ioctl call returns the number of uncorrected blocks detected by the FE_READ_UNCORRECTED_BLOCKS
device driver during its lifetime. For meaningful measurements, the
increment in block count during a specific time interval should be
calculated. For this command, read-only access to the device is
sufficient.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl( int fd, int request =FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks) .. c:function:: int ioctl( int fd, int request =FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -51,8 +46,18 @@ Arguments ...@@ -51,8 +46,18 @@ Arguments
- The total number of uncorrected blocks seen by the driver so far. - The total number of uncorrected blocks seen by the driver so far.
Return Value DESCRIPTION
------------ ===========
This ioctl call returns the number of uncorrected blocks detected by the
device driver during its lifetime. For meaningful measurements, the
increment in block count during a specific time interval should be
calculated. For this command, read-only access to the device is
sufficient.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst
View file @ 586027ce
...@@ -6,28 +6,19 @@ ...@@ -6,28 +6,19 @@
FE_SET_FRONTEND FE_SET_FRONTEND
*************** ***************
Description NAME
----------- ====
This ioctl call starts a tuning operation using specified parameters. FE_SET_FRONTEND
The result of this call will be successful if the parameters were valid
and the tuning could be initiated. The result of the tuning operation in
itself, however, will arrive asynchronously as an event (see
documentation for :ref:`FE_GET_EVENT` and
FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
operation is initiated before the previous one was completed, the
previous operation will be aborted in favor of the new one. This command
requires read/write access to the device.
Synopsis SYNOPSIS
-------- ========
.. c:function:: int ioctl(int fd, int request = FE_SET_FRONTEND, struct dvb_frontend_parameters *p) .. c:function:: int ioctl(int fd, int request = FE_SET_FRONTEND, struct dvb_frontend_parameters *p)
Arguments
----------
ARGUMENTS
=========
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -54,8 +45,22 @@ Arguments ...@@ -54,8 +45,22 @@ Arguments
- Points to parameters for tuning operation. - Points to parameters for tuning operation.
Return Value DESCRIPTION
------------ ===========
This ioctl call starts a tuning operation using specified parameters.
The result of this call will be successful if the parameters were valid
and the tuning could be initiated. The result of the tuning operation in
itself, however, will arrive asynchronously as an event (see
documentation for :ref:`FE_GET_EVENT` and
FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
operation is initiated before the previous one was completed, the
previous operation will be aborted in favor of the new one. This command
requires read/write access to the device.
RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/audio-bilingual-channel-select.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _AUDIO_BILINGUAL_CHANNEL_SELECT: .. _AUDIO_BILINGUAL_CHANNEL_SELECT:
==============================
AUDIO_BILINGUAL_CHANNEL_SELECT AUDIO_BILINGUAL_CHANNEL_SELECT
============================== ==============================
Description NAME
----------- ----
This ioctl is obsolete. Do not use in new drivers. It has been replaced
by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control
for MPEG decoders controlled through V4L2.
This ioctl call asks the Audio Device to select the requested channel AUDIO_BILINGUAL_CHANNEL_SELECT
for bilingual streams if possible.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_BILINGUAL_CHANNEL_SELECT, audio_channel_select_t) .. c:function:: int ioctl(int fd, int request = AUDIO_BILINGUAL_CHANNEL_SELECT, audio_channel_select_t)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -49,11 +44,20 @@ Arguments ...@@ -49,11 +44,20 @@ Arguments
- Select the output format of the audio (mono left/right, stereo). - Select the output format of the audio (mono left/right, stereo).
Return Value DESCRIPTION
-----------
This ioctl is obsolete. Do not use in new drivers. It has been replaced
by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control
for MPEG decoders controlled through V4L2.
This ioctl call asks the Audio Device to select the requested channel
for bilingual streams if possible.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-channel-select.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _AUDIO_CHANNEL_SELECT: .. _AUDIO_CHANNEL_SELECT:
====================
AUDIO_CHANNEL_SELECT AUDIO_CHANNEL_SELECT
==================== ====================
Description NAME
----------- ----
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead.
This ioctl call asks the Audio Device to select the requested channel if AUDIO_CHANNEL_SELECT
possible.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_CHANNEL_SELECT, audio_channel_select_t) .. c:function:: int ioctl(int fd, int request = AUDIO_CHANNEL_SELECT, audio_channel_select_t)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -48,11 +44,19 @@ Arguments ...@@ -48,11 +44,19 @@ Arguments
- Select the output format of the audio (mono left/right, stereo). - Select the output format of the audio (mono left/right, stereo).
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead.
This ioctl call asks the Audio Device to select the requested channel if
possible.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-clear-buffer.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_CLEAR_BUFFER: .. _AUDIO_CLEAR_BUFFER:
==================
AUDIO_CLEAR_BUFFER AUDIO_CLEAR_BUFFER
================== ==================
Description NAME
----------- ----
This ioctl call asks the Audio Device to clear all software and hardware AUDIO_CLEAR_BUFFER
buffers of the audio decoder device.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_CLEAR_BUFFER) .. c:function:: int ioctl(int fd, int request = AUDIO_CLEAR_BUFFER)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,11 +38,16 @@ Arguments ...@@ -39,11 +38,16 @@ Arguments
- Equals AUDIO_CLEAR_BUFFER for this command. - Equals AUDIO_CLEAR_BUFFER for this command.
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to clear all software and hardware
buffers of the audio decoder device.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-continue.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_CONTINUE: .. _AUDIO_CONTINUE:
==============
AUDIO_CONTINUE AUDIO_CONTINUE
============== ==============
Description NAME
----------- ----
This ioctl restarts the decoding and playing process previously paused AUDIO_CONTINUE
with AUDIO_PAUSE command.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_CONTINUE) .. c:function:: int ioctl(int fd, int request = AUDIO_CONTINUE)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,11 +38,16 @@ Arguments ...@@ -39,11 +38,16 @@ Arguments
- Equals AUDIO_CONTINUE for this command. - Equals AUDIO_CONTINUE for this command.
Return Value DESCRIPTION
-----------
This ioctl restarts the decoding and playing process previously paused
with AUDIO_PAUSE command.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-fclose.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _audio_fclose: .. _audio_fclose:
=================
DVB audio close() DVB audio close()
================= =================
Description NAME
----------- ----
This system call closes a previously opened audio device. DVB audio close()
Synopsis SYNOPSIS
-------- --------
.. c:function:: int close(int fd) .. c:function:: int close(int fd)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -32,10 +32,14 @@ Arguments ...@@ -32,10 +32,14 @@ Arguments
- File descriptor returned by a previous call to open(). - File descriptor returned by a previous call to open().
Return Value DESCRIPTION
------------ -----------
This system call closes a previously opened audio device.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,6 +51,3 @@ Return Value ...@@ -47,6 +51,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/audio-fopen.rst
View file @ 586027ce
...@@ -2,35 +2,23 @@ ...@@ -2,35 +2,23 @@
.. _audio_fopen: .. _audio_fopen:
================
DVB audio open() DVB audio open()
================ ================
Description NAME
----------- ----
This system call opens a named audio device (e.g. DVB audio open()
/dev/dvb/adapter0/audio0) for subsequent use. When an open() call has
succeeded, the device will be ready for use. The significance of
blocking or non-blocking mode is described in the documentation for
functions where there is a difference. It does not affect the semantics
of the open() call itself. A device opened in blocking mode can later be
put into non-blocking mode (and vice versa) using the F_SETFL command
of the fcntl system call. This is a standard system call, documented in
the Linux manual page for fcntl. Only one user can open the Audio Device
in O_RDWR mode. All other attempts to open the device in this mode will
fail, and an error code will be returned. If the Audio Device is opened
in O_RDONLY mode, the only ioctl call that can be used is
AUDIO_GET_STATUS. All other call will return with an error code.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int open(const char *deviceName, int flags) .. c:function:: int open(const char *deviceName, int flags)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -70,11 +58,27 @@ Arguments ...@@ -70,11 +58,27 @@ Arguments
- (blocking mode is the default) - (blocking mode is the default)
Return Value DESCRIPTION
------------ -----------
This system call opens a named audio device (e.g.
/dev/dvb/adapter0/audio0) for subsequent use. When an open() call has
succeeded, the device will be ready for use. The significance of
blocking or non-blocking mode is described in the documentation for
functions where there is a difference. It does not affect the semantics
of the open() call itself. A device opened in blocking mode can later be
put into non-blocking mode (and vice versa) using the F_SETFL command
of the fcntl system call. This is a standard system call, documented in
the Linux manual page for fcntl. Only one user can open the Audio Device
in O_RDWR mode. All other attempts to open the device in this mode will
fail, and an error code will be returned. If the Audio Device is opened
in O_RDONLY mode, the only ioctl call that can be used is
AUDIO_GET_STATUS. All other call will return with an error code.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -97,6 +101,3 @@ Return Value ...@@ -97,6 +101,3 @@ Return Value
- ``EINVAL`` - ``EINVAL``
- Invalid argument. - Invalid argument.
Documentation/linux_tv/media/dvb/audio-fwrite.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _audio_fwrite: .. _audio_fwrite:
=================
DVB audio write() DVB audio write()
================= =================
Description NAME
----------- ----
This system call can only be used if AUDIO_SOURCE_MEMORY is selected DVB audio write()
in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
PES format. If O_NONBLOCK is not specified the function will block
until buffer space is available. The amount of data to be transferred is
implied by count.
Synopsis SYNOPSIS
-------- --------
.. c:function:: size_t write(int fd, const void *buf, size_t count) .. c:function:: size_t write(int fd, const void *buf, size_t count)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -48,11 +44,19 @@ Arguments ...@@ -48,11 +44,19 @@ Arguments
- Size of buf. - Size of buf.
Return Value DESCRIPTION
------------ -----------
This system call can only be used if AUDIO_SOURCE_MEMORY is selected
in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
PES format. If O_NONBLOCK is not specified the function will block
until buffer space is available. The amount of data to be transferred is
implied by count.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -75,6 +79,3 @@ Return Value ...@@ -75,6 +79,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/audio-get-capabilities.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_GET_CAPABILITIES: .. _AUDIO_GET_CAPABILITIES:
======================
AUDIO_GET_CAPABILITIES AUDIO_GET_CAPABILITIES
====================== ======================
Description NAME
----------- ----
This ioctl call asks the Audio Device to tell us about the decoding AUDIO_GET_CAPABILITIES
capabilities of the audio hardware.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_GET_CAPABILITIES, unsigned int *cap) .. c:function:: int ioctl(int fd, int request = AUDIO_GET_CAPABILITIES, unsigned int *cap)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,11 +44,16 @@ Arguments ...@@ -45,11 +44,16 @@ Arguments
- Returns a bit array of supported sound formats. - Returns a bit array of supported sound formats.
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to tell us about the decoding
capabilities of the audio hardware.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-get-pts.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _AUDIO_GET_PTS: .. _AUDIO_GET_PTS:
=============
AUDIO_GET_PTS AUDIO_GET_PTS
============= =============
Description NAME
----------- ----
This ioctl is obsolete. Do not use in new drivers. If you need this
functionality, then please contact the linux-media mailing list
(`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__).
This ioctl call asks the Audio Device to return the current PTS AUDIO_GET_PTS
timestamp.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_GET_PTS, __u64 *pts) .. c:function:: int ioctl(int fd, int request = AUDIO_GET_PTS, __u64 *pts)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -54,11 +49,20 @@ Arguments ...@@ -54,11 +49,20 @@ Arguments
decoded frame or the last PTS extracted by the PES parser. decoded frame or the last PTS extracted by the PES parser.
Return Value DESCRIPTION
-----------
This ioctl is obsolete. Do not use in new drivers. If you need this
functionality, then please contact the linux-media mailing list
(`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__).
This ioctl call asks the Audio Device to return the current PTS
timestamp.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-get-status.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_GET_STATUS: .. _AUDIO_GET_STATUS:
================
AUDIO_GET_STATUS AUDIO_GET_STATUS
================ ================
Description NAME
----------- ----
This ioctl call asks the Audio Device to return the current state of the AUDIO_GET_STATUS
Audio Device.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_GET_STATUS, struct audio_status *status) .. c:function:: int ioctl(int fd, int request = AUDIO_GET_STATUS, struct audio_status *status)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,11 +44,16 @@ Arguments ...@@ -45,11 +44,16 @@ Arguments
- Returns the current state of Audio Device. - Returns the current state of Audio Device.
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to return the current state of the
Audio Device.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-pause.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _AUDIO_PAUSE: .. _AUDIO_PAUSE:
===========
AUDIO_PAUSE AUDIO_PAUSE
=========== ===========
Description NAME
----------- ----
This ioctl call suspends the audio stream being played. Decoding and AUDIO_PAUSE
playing are paused. It is then possible to restart again decoding and
playing process of the audio stream using AUDIO_CONTINUE command.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_PAUSE) .. c:function:: int ioctl(int fd, int request = AUDIO_PAUSE)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -40,11 +38,17 @@ Arguments ...@@ -40,11 +38,17 @@ Arguments
- Equals AUDIO_PAUSE for this command. - Equals AUDIO_PAUSE for this command.
Return Value DESCRIPTION
-----------
This ioctl call suspends the audio stream being played. Decoding and
playing are paused. It is then possible to restart again decoding and
playing process of the audio stream using AUDIO_CONTINUE command.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-play.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_PLAY: .. _AUDIO_PLAY:
==========
AUDIO_PLAY AUDIO_PLAY
========== ==========
Description NAME
----------- ----
This ioctl call asks the Audio Device to start playing an audio stream AUDIO_PLAY
from the selected source.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_PLAY) .. c:function:: int ioctl(int fd, int request = AUDIO_PLAY)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,11 +38,16 @@ Arguments ...@@ -39,11 +38,16 @@ Arguments
- Equals AUDIO_PLAY for this command. - Equals AUDIO_PLAY for this command.
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to start playing an audio stream
from the selected source.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-select-source.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _AUDIO_SELECT_SOURCE: .. _AUDIO_SELECT_SOURCE:
===================
AUDIO_SELECT_SOURCE AUDIO_SELECT_SOURCE
=================== ===================
Description NAME
----------- ----
This ioctl call informs the audio device which source shall be used for AUDIO_SELECT_SOURCE
the input data. The possible sources are demux or memory. If
AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device
through the write command.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SELECT_SOURCE, audio_stream_source_t source) .. c:function:: int ioctl(int fd, int request = AUDIO_SELECT_SOURCE, audio_stream_source_t source)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,11 +44,18 @@ Arguments ...@@ -47,11 +44,18 @@ Arguments
- Indicates the source that shall be used for the Audio stream. - Indicates the source that shall be used for the Audio stream.
Return Value DESCRIPTION
-----------
This ioctl call informs the audio device which source shall be used for
the input data. The possible sources are demux or memory. If
AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device
through the write command.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-attributes.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_SET_ATTRIBUTES: .. _AUDIO_SET_ATTRIBUTES:
====================
AUDIO_SET_ATTRIBUTES AUDIO_SET_ATTRIBUTES
==================== ====================
Description NAME
----------- ----
This ioctl is intended for DVD playback and allows you to set certain AUDIO_SET_ATTRIBUTES
information about the audio stream.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = AUDIO_SET_ATTRIBUTES, audio_attributes_t attr ) .. c:function:: int ioctl(fd, int request = AUDIO_SET_ATTRIBUTES, audio_attributes_t attr )
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,7 +44,14 @@ Arguments ...@@ -45,7 +44,14 @@ Arguments
- audio attributes according to section ?? - audio attributes according to section ??
Return Value DESCRIPTION
-----------
This ioctl is intended for DVD playback and allows you to set certain
information about the audio stream.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the ...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- attr is not a valid or supported attribute setting. - attr is not a valid or supported attribute setting.
Documentation/linux_tv/media/dvb/audio-set-av-sync.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_SET_AV_SYNC: .. _AUDIO_SET_AV_SYNC:
=================
AUDIO_SET_AV_SYNC AUDIO_SET_AV_SYNC
================= =================
Description NAME
----------- ----
This ioctl call asks the Audio Device to turn ON or OFF A/V AUDIO_SET_AV_SYNC
synchronization.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SET_AV_SYNC, boolean state) .. c:function:: int ioctl(int fd, int request = AUDIO_SET_AV_SYNC, boolean state)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -55,11 +54,16 @@ Arguments ...@@ -55,11 +54,16 @@ Arguments
- FALSE AV-sync OFF - FALSE AV-sync OFF
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to turn ON or OFF A/V
synchronization.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-bypass-mode.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _AUDIO_SET_BYPASS_MODE: .. _AUDIO_SET_BYPASS_MODE:
=====================
AUDIO_SET_BYPASS_MODE AUDIO_SET_BYPASS_MODE
===================== =====================
Description NAME
----------- ----
This ioctl call asks the Audio Device to bypass the Audio decoder and AUDIO_SET_BYPASS_MODE
forward the stream without decoding. This mode shall be used if streams
that can’t be handled by the DVB system shall be decoded. Dolby
DigitalTM streams are automatically forwarded by the DVB subsystem if
the hardware can handle it.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SET_BYPASS_MODE, boolean mode) .. c:function:: int ioctl(int fd, int request = AUDIO_SET_BYPASS_MODE, boolean mode)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -59,11 +55,19 @@ Arguments ...@@ -59,11 +55,19 @@ Arguments
- FALSE Bypass is enabled - FALSE Bypass is enabled
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to bypass the Audio decoder and
forward the stream without decoding. This mode shall be used if streams
that can’t be handled by the DVB system shall be decoded. Dolby
DigitalTM streams are automatically forwarded by the DVB subsystem if
the hardware can handle it.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-ext-id.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_SET_EXT_ID: .. _AUDIO_SET_EXT_ID:
================
AUDIO_SET_EXT_ID AUDIO_SET_EXT_ID
================ ================
Description NAME
----------- ----
This ioctl can be used to set the extension id for MPEG streams in DVD AUDIO_SET_EXT_ID
playback. Only the first 3 bits are recognized.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = AUDIO_SET_EXT_ID, int id) .. c:function:: int ioctl(fd, int request = AUDIO_SET_EXT_ID, int id)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,7 +44,14 @@ Arguments ...@@ -45,7 +44,14 @@ Arguments
- audio sub_stream_id - audio sub_stream_id
Return Value DESCRIPTION
-----------
This ioctl can be used to set the extension id for MPEG streams in DVD
playback. Only the first 3 bits are recognized.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the ...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- id is not a valid id. - id is not a valid id.
Documentation/linux_tv/media/dvb/audio-set-id.rst
View file @ 586027ce
...@@ -2,29 +2,23 @@ ...@@ -2,29 +2,23 @@
.. _AUDIO_SET_ID: .. _AUDIO_SET_ID:
============
AUDIO_SET_ID AUDIO_SET_ID
============ ============
Description NAME
----------- ----
This ioctl selects which sub-stream is to be decoded if a program or AUDIO_SET_ID
system stream is sent to the video device. If no audio stream type is
set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for
AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for
other stream types. If the stream type is set the id just specifies the
substream id of the audio stream and only the first 5 bits are
recognized.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SET_ID, int id) .. c:function:: int ioctl(int fd, int request = AUDIO_SET_ID, int id)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -50,11 +44,21 @@ Arguments ...@@ -50,11 +44,21 @@ Arguments
- audio sub-stream id - audio sub-stream id
Return Value DESCRIPTION
-----------
This ioctl selects which sub-stream is to be decoded if a program or
system stream is sent to the video device. If no audio stream type is
set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for
AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for
other stream types. If the stream type is set the id just specifies the
substream id of the audio stream and only the first 5 bits are
recognized.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-karaoke.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _AUDIO_SET_KARAOKE: .. _AUDIO_SET_KARAOKE:
=================
AUDIO_SET_KARAOKE AUDIO_SET_KARAOKE
================= =================
Description NAME
----------- ----
This ioctl allows one to set the mixer settings for a karaoke DVD. AUDIO_SET_KARAOKE
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = AUDIO_SET_KARAOKE, audio_karaoke_t *karaoke) .. c:function:: int ioctl(fd, int request = AUDIO_SET_KARAOKE, audio_karaoke_t *karaoke)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,7 +44,13 @@ Arguments ...@@ -44,7 +44,13 @@ Arguments
- karaoke settings according to section ??. - karaoke settings according to section ??.
Return Value DESCRIPTION
-----------
This ioctl allows one to set the mixer settings for a karaoke DVD.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
......
Documentation/linux_tv/media/dvb/audio-set-mixer.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _AUDIO_SET_MIXER: .. _AUDIO_SET_MIXER:
===============
AUDIO_SET_MIXER AUDIO_SET_MIXER
=============== ===============
Description NAME
----------- ----
This ioctl lets you adjust the mixer settings of the audio decoder. AUDIO_SET_MIXER
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SET_MIXER, audio_mixer_t *mix) .. c:function:: int ioctl(int fd, int request = AUDIO_SET_MIXER, audio_mixer_t *mix)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- mixer settings. - mixer settings.
Return Value DESCRIPTION
-----------
This ioctl lets you adjust the mixer settings of the audio decoder.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-mute.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _AUDIO_SET_MUTE: .. _AUDIO_SET_MUTE:
==============
AUDIO_SET_MUTE AUDIO_SET_MUTE
============== ==============
Description NAME
----------- ----
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` with the
``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead.
This ioctl call asks the audio device to mute the stream that is AUDIO_SET_MUTE
currently being played.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_SET_MUTE, boolean state) .. c:function:: int ioctl(int fd, int request = AUDIO_SET_MUTE, boolean state)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -59,11 +54,20 @@ Arguments ...@@ -59,11 +54,20 @@ Arguments
- FALSE Audio Un-mute - FALSE Audio Un-mute
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` with the
``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead.
This ioctl call asks the audio device to mute the stream that is
currently being played.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/audio-set-streamtype.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _AUDIO_SET_STREAMTYPE: .. _AUDIO_SET_STREAMTYPE:
====================
AUDIO_SET_STREAMTYPE AUDIO_SET_STREAMTYPE
==================== ====================
Description NAME
----------- ----
This ioctl tells the driver which kind of audio stream to expect. This AUDIO_SET_STREAMTYPE
is useful if the stream offers several audio sub-streams like LPCM and
AC3.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = AUDIO_SET_STREAMTYPE, int type) .. c:function:: int ioctl(fd, int request = AUDIO_SET_STREAMTYPE, int type)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,7 +44,15 @@ Arguments ...@@ -46,7 +44,15 @@ Arguments
- stream type - stream type
Return Value DESCRIPTION
-----------
This ioctl tells the driver which kind of audio stream to expect. This
is useful if the stream offers several audio sub-streams like LPCM and
AC3.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the ...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- type is not a valid or supported stream type. - type is not a valid or supported stream type.
Documentation/linux_tv/media/dvb/audio-stop.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _AUDIO_STOP: .. _AUDIO_STOP:
==========
AUDIO_STOP AUDIO_STOP
========== ==========
Description NAME
----------- ----
This ioctl call asks the Audio Device to stop playing the current AUDIO_STOP
stream.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = AUDIO_STOP) .. c:function:: int ioctl(int fd, int request = AUDIO_STOP)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,11 +38,16 @@ Arguments ...@@ -39,11 +38,16 @@ Arguments
- Equals AUDIO_STOP for this command. - Equals AUDIO_STOP for this command.
Return Value DESCRIPTION
-----------
This ioctl call asks the Audio Device to stop playing the current
stream.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-fclose.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _ca_fclose: .. _ca_fclose:
==============
DVB CA close() DVB CA close()
============== ==============
Description NAME
----------- ----
This system call closes a previously opened audio device. DVB CA close()
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int close(int fd) .. cpp:function:: int close(int fd)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -32,10 +32,14 @@ Arguments ...@@ -32,10 +32,14 @@ Arguments
- File descriptor returned by a previous call to open(). - File descriptor returned by a previous call to open().
Return Value DESCRIPTION
------------ -----------
This system call closes a previously opened audio device.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,6 +51,3 @@ Return Value ...@@ -47,6 +51,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/ca-fopen.rst
View file @ 586027ce
...@@ -2,34 +2,23 @@ ...@@ -2,34 +2,23 @@
.. _ca_fopen: .. _ca_fopen:
=============
DVB CA open() DVB CA open()
============= =============
Description NAME
----------- ----
This system call opens a named ca device (e.g. /dev/ost/ca) for
subsequent use.
When an open() call has succeeded, the device will be ready for use. The DVB CA open()
significance of blocking or non-blocking mode is described in the
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call. This is a standard
system call, documented in the Linux manual page for fcntl. Only one
user can open the CA Device in O_RDWR mode. All other attempts to open
the device in this mode will fail, and an error code will be returned.
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int open(const char *deviceName, int flags) .. cpp:function:: int open(const char *deviceName, int flags)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -69,10 +58,25 @@ Arguments ...@@ -69,10 +58,25 @@ Arguments
- (blocking mode is the default) - (blocking mode is the default)
Return Value DESCRIPTION
------------ -----------
This system call opens a named ca device (e.g. /dev/ost/ca) for
subsequent use.
When an open() call has succeeded, the device will be ready for use. The
significance of blocking or non-blocking mode is described in the
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call. This is a standard
system call, documented in the Linux manual page for fcntl. Only one
user can open the CA Device in O_RDWR mode. All other attempts to open
the device in this mode will fail, and an error code will be returned.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -102,6 +106,3 @@ Return Value ...@@ -102,6 +106,3 @@ Return Value
- ``EINVAL`` - ``EINVAL``
- Invalid argument. - Invalid argument.
Documentation/linux_tv/media/dvb/ca-get-cap.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_GET_CAP: .. _CA_GET_CAP:
==========
CA_GET_CAP CA_GET_CAP
========== ==========
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_GET_CAP
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_GET_CAP, ca_caps_t *) .. cpp:function:: int ioctl(fd, int request = CA_GET_CAP, ca_caps_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-get-descr-info.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_GET_DESCR_INFO: .. _CA_GET_DESCR_INFO:
=================
CA_GET_DESCR_INFO CA_GET_DESCR_INFO
================= =================
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_GET_DESCR_INFO
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_GET_DESCR_INFO, ca_descr_info_t *) .. cpp:function:: int ioctl(fd, int request = CA_GET_DESCR_INFO, ca_descr_info_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-get-msg.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_GET_MSG: .. _CA_GET_MSG:
==========
CA_GET_MSG CA_GET_MSG
========== ==========
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_GET_MSG
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_GET_MSG, ca_msg_t *) .. cpp:function:: int ioctl(fd, int request = CA_GET_MSG, ca_msg_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-get-slot-info.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_GET_SLOT_INFO: .. _CA_GET_SLOT_INFO:
================
CA_GET_SLOT_INFO CA_GET_SLOT_INFO
================ ================
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_GET_SLOT_INFO
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_GET_SLOT_INFO, ca_slot_info_t *) .. cpp:function:: int ioctl(fd, int request = CA_GET_SLOT_INFO, ca_slot_info_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-reset.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_RESET: .. _CA_RESET:
========
CA_RESET CA_RESET
======== ========
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_RESET
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_RESET) .. cpp:function:: int ioctl(fd, int request = CA_RESET)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -38,11 +38,15 @@ Arguments ...@@ -38,11 +38,15 @@ Arguments
- Equals CA_RESET for this command. - Equals CA_RESET for this command.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-send-msg.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_SEND_MSG: .. _CA_SEND_MSG:
===========
CA_SEND_MSG CA_SEND_MSG
=========== ===========
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_SEND_MSG
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_SEND_MSG, ca_msg_t *) .. cpp:function:: int ioctl(fd, int request = CA_SEND_MSG, ca_msg_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-set-descr.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_SET_DESCR: .. _CA_SET_DESCR:
============
CA_SET_DESCR CA_SET_DESCR
============ ============
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_SET_DESCR
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_SET_DESCR, ca_descr_t *) .. cpp:function:: int ioctl(fd, int request = CA_SET_DESCR, ca_descr_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/ca-set-pid.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _CA_SET_PID: .. _CA_SET_PID:
==========
CA_SET_PID CA_SET_PID
========== ==========
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. CA_SET_PID
Synopsis SYNOPSIS
-------- --------
.. cpp:function:: int ioctl(fd, int request = CA_SET_PID, ca_pid_t *) .. cpp:function:: int ioctl(fd, int request = CA_SET_PID, ca_pid_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,7 +44,13 @@ Arguments ...@@ -44,7 +44,13 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
......
Documentation/linux_tv/media/dvb/dmx-add-pid.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _DMX_ADD_PID: .. _DMX_ADD_PID:
===========
DMX_ADD_PID DMX_ADD_PID
=========== ===========
Description NAME
----------- ----
This ioctl call allows to add multiple PIDs to a transport stream filter DMX_ADD_PID
previously set up with DMX_SET_PES_FILTER and output equal to
DMX_OUT_TSDEMUX_TAP.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = DMX_ADD_PID, __u16 *) .. c:function:: int ioctl(fd, int request = DMX_ADD_PID, __u16 *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,11 +44,17 @@ Arguments ...@@ -46,11 +44,17 @@ Arguments
- PID number to be filtered. - PID number to be filtered.
Return Value DESCRIPTION
-----------
This ioctl call allows to add multiple PIDs to a transport stream filter
previously set up with DMX_SET_PES_FILTER and output equal to
DMX_OUT_TSDEMUX_TAP.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-fclose.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _dmx_fclose: .. _dmx_fclose:
=================
DVB demux close() DVB demux close()
================= =================
Description NAME
----------- ----
This system call deactivates and deallocates a filter that was DVB demux close()
previously allocated via the open() call.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int close(int fd) .. c:function:: int close(int fd)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -33,11 +32,16 @@ Arguments ...@@ -33,11 +32,16 @@ Arguments
- File descriptor returned by a previous call to open(). - File descriptor returned by a previous call to open().
Return Value DESCRIPTION
------------ -----------
This system call deactivates and deallocates a filter that was
previously allocated via the open() call.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -48,6 +52,3 @@ Return Value ...@@ -48,6 +52,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/dmx-fopen.rst
View file @ 586027ce
...@@ -2,38 +2,23 @@ ...@@ -2,38 +2,23 @@
.. _dmx_fopen: .. _dmx_fopen:
================
DVB demux open() DVB demux open()
================ ================
Description NAME
----------- ----
This system call, used with a device name of /dev/dvb/adapter0/demux0,
allocates a new filter and returns a handle which can be used for
subsequent control of that filter. This call has to be made for each
filter to be used, i.e. every returned file descriptor is a reference to
a single filter. /dev/dvb/adapter0/dvr0 is a logical device to be used
for retrieving Transport Streams for digital video recording. When
reading from this device a transport stream containing the packets from
all PES filters set in the corresponding demux device
(/dev/dvb/adapter0/demux0) having the output set to DMX_OUT_TS_TAP. A
recorded Transport Stream is replayed by writing to this device.
The significance of blocking or non-blocking mode is described in the DVB demux open()
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int open(const char *deviceName, int flags) .. c:function:: int open(const char *deviceName, int flags)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -68,11 +53,30 @@ Arguments ...@@ -68,11 +53,30 @@ Arguments
- (blocking mode is the default) - (blocking mode is the default)
Return Value DESCRIPTION
------------ -----------
This system call, used with a device name of /dev/dvb/adapter0/demux0,
allocates a new filter and returns a handle which can be used for
subsequent control of that filter. This call has to be made for each
filter to be used, i.e. every returned file descriptor is a reference to
a single filter. /dev/dvb/adapter0/dvr0 is a logical device to be used
for retrieving Transport Streams for digital video recording. When
reading from this device a transport stream containing the packets from
all PES filters set in the corresponding demux device
(/dev/dvb/adapter0/demux0) having the output set to DMX_OUT_TS_TAP. A
recorded Transport Stream is replayed by writing to this device.
The significance of blocking or non-blocking mode is described in the
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -101,6 +105,3 @@ Return Value ...@@ -101,6 +105,3 @@ Return Value
- ``ENOMEM`` - ``ENOMEM``
- The driver failed to allocate enough memory. - The driver failed to allocate enough memory.
Documentation/linux_tv/media/dvb/dmx-fread.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _dmx_fread: .. _dmx_fread:
================
DVB demux read() DVB demux read()
================ ================
Description NAME
----------- ----
This system call returns filtered data, which might be section or PES DVB demux read()
data. The filtered data is transferred from the driver’s internal
circular buffer to buf. The maximum amount of data to be transferred is
implied by count.
Synopsis SYNOPSIS
-------- --------
.. c:function:: size_t read(int fd, void *buf, size_t count) .. c:function:: size_t read(int fd, void *buf, size_t count)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,11 +44,18 @@ Arguments ...@@ -47,11 +44,18 @@ Arguments
- Size of buf. - Size of buf.
Return Value DESCRIPTION
------------ -----------
This system call returns filtered data, which might be section or PES
data. The filtered data is transferred from the driver’s internal
circular buffer to buf. The maximum amount of data to be transferred is
implied by count.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -101,6 +105,3 @@ Return Value ...@@ -101,6 +105,3 @@ Return Value
- The driver failed to write to the callers buffer due to an invalid - The driver failed to write to the callers buffer due to an invalid
\*buf pointer. \*buf pointer.
Documentation/linux_tv/media/dvb/dmx-fwrite.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _dmx_fwrite: .. _dmx_fwrite:
=================
DVB demux write() DVB demux write()
================= =================
Description NAME
----------- ----
This system call is only provided by the logical device DVB demux write()
/dev/dvb/adapter0/dvr0, associated with the physical demux device that
provides the actual DVR functionality. It is used for replay of a
digitally recorded Transport Stream. Matching filters have to be defined
in the corresponding physical demux device, /dev/dvb/adapter0/demux0.
The amount of data to be transferred is implied by count.
Synopsis SYNOPSIS
-------- --------
.. c:function:: ssize_t write(int fd, const void *buf, size_t count) .. c:function:: ssize_t write(int fd, const void *buf, size_t count)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -49,11 +44,20 @@ Arguments ...@@ -49,11 +44,20 @@ Arguments
- Size of buf. - Size of buf.
Return Value DESCRIPTION
------------ -----------
This system call is only provided by the logical device
/dev/dvb/adapter0/dvr0, associated with the physical demux device that
provides the actual DVR functionality. It is used for replay of a
digitally recorded Transport Stream. Matching filters have to be defined
in the corresponding physical demux device, /dev/dvb/adapter0/demux0.
The amount of data to be transferred is implied by count.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -82,6 +86,3 @@ Return Value ...@@ -82,6 +86,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/dmx-get-caps.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _DMX_GET_CAPS: .. _DMX_GET_CAPS:
============
DMX_GET_CAPS DMX_GET_CAPS
============ ============
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. DMX_GET_CAPS
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = DMX_GET_CAPS, dmx_caps_t *) .. c:function:: int ioctl(fd, int request = DMX_GET_CAPS, dmx_caps_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-get-event.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _DMX_GET_EVENT: .. _DMX_GET_EVENT:
=============
DMX_GET_EVENT DMX_GET_EVENT
============= =============
Description NAME
----------- ----
This ioctl call returns an event if available. If an event is not DMX_GET_EVENT
available, the behavior depends on whether the device is in blocking or
non-blocking mode. In the latter case, the call fails immediately with
errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an
event becomes available.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_GET_EVENT, struct dmx_event *ev) .. c:function:: int ioctl( int fd, int request = DMX_GET_EVENT, struct dmx_event *ev)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -48,7 +44,17 @@ Arguments ...@@ -48,7 +44,17 @@ Arguments
- Pointer to the location where the event is to be stored. - Pointer to the location where the event is to be stored.
Return Value DESCRIPTION
-----------
This ioctl call returns an event if available. If an event is not
available, the behavior depends on whether the device is in blocking or
non-blocking mode. In the latter case, the call fails immediately with
errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an
event becomes available.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -67,6 +73,3 @@ appropriately. The generic error codes are described at the ...@@ -67,6 +73,3 @@ appropriately. The generic error codes are described at the
- ``EWOULDBLOCK`` - ``EWOULDBLOCK``
- There is no event pending, and the device is in non-blocking mode. - There is no event pending, and the device is in non-blocking mode.
Documentation/linux_tv/media/dvb/dmx-get-pes-pids.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _DMX_GET_PES_PIDS: .. _DMX_GET_PES_PIDS:
================
DMX_GET_PES_PIDS DMX_GET_PES_PIDS
================ ================
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. DMX_GET_PES_PIDS
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5]) .. c:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5])
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-get-stc.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _DMX_GET_STC: .. _DMX_GET_STC:
===========
DMX_GET_STC DMX_GET_STC
=========== ===========
Description NAME
----------- ----
This ioctl call returns the current value of the system time counter DMX_GET_STC
(which is driven by a PES filter of type DMX_PES_PCR). Some hardware
supports more than one STC, so you must specify which one by setting the
num field of stc before the ioctl (range 0...n). The result is returned
in form of a ratio with a 64 bit numerator and a 32 bit denominator, so
the real 90kHz STC value is stc->stc / stc->base .
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_GET_STC, struct dmx_stc *stc) .. c:function:: int ioctl( int fd, int request = DMX_GET_STC, struct dmx_stc *stc)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -49,7 +44,18 @@ Arguments ...@@ -49,7 +44,18 @@ Arguments
- Pointer to the location where the stc is to be stored. - Pointer to the location where the stc is to be stored.
Return Value DESCRIPTION
-----------
This ioctl call returns the current value of the system time counter
(which is driven by a PES filter of type DMX_PES_PCR). Some hardware
supports more than one STC, so you must specify which one by setting the
num field of stc before the ioctl (range 0...n). The result is returned
in form of a ratio with a 64 bit numerator and a 32 bit denominator, so
the real 90kHz STC value is stc->stc / stc->base .
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the ...@@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- Invalid stc number. - Invalid stc number.
Documentation/linux_tv/media/dvb/dmx-remove-pid.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _DMX_REMOVE_PID: .. _DMX_REMOVE_PID:
==============
DMX_REMOVE_PID DMX_REMOVE_PID
============== ==============
Description NAME
----------- ----
This ioctl call allows to remove a PID when multiple PIDs are set on a DMX_REMOVE_PID
transport stream filter, e. g. a filter previously set up with output
equal to DMX_OUT_TSDEMUX_TAP, created via either
DMX_SET_PES_FILTER or DMX_ADD_PID.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = DMX_REMOVE_PID, __u16 *) .. c:function:: int ioctl(fd, int request = DMX_REMOVE_PID, __u16 *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,7 +44,16 @@ Arguments ...@@ -47,7 +44,16 @@ Arguments
- PID of the PES filter to be removed. - PID of the PES filter to be removed.
Return Value DESCRIPTION
-----------
This ioctl call allows to remove a PID when multiple PIDs are set on a
transport stream filter, e. g. a filter previously set up with output
equal to DMX_OUT_TSDEMUX_TAP, created via either
DMX_SET_PES_FILTER or DMX_ADD_PID.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
......
Documentation/linux_tv/media/dvb/dmx-set-buffer-size.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _DMX_SET_BUFFER_SIZE: .. _DMX_SET_BUFFER_SIZE:
===================
DMX_SET_BUFFER_SIZE DMX_SET_BUFFER_SIZE
=================== ===================
Description NAME
----------- ----
This ioctl call is used to set the size of the circular buffer used for DMX_SET_BUFFER_SIZE
filtered data. The default size is two maximum sized sections, i.e. if
this function is not called a buffer size of 2 \* 4096 bytes will be
used.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_SET_BUFFER_SIZE, unsigned long size) .. c:function:: int ioctl( int fd, int request = DMX_SET_BUFFER_SIZE, unsigned long size)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,11 +44,18 @@ Arguments ...@@ -47,11 +44,18 @@ Arguments
- Size of circular buffer. - Size of circular buffer.
Return Value DESCRIPTION
-----------
This ioctl call is used to set the size of the circular buffer used for
filtered data. The default size is two maximum sized sections, i.e. if
this function is not called a buffer size of 2 \* 4096 bytes will be
used.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-set-filter.rst
View file @ 586027ce
...@@ -2,32 +2,23 @@ ...@@ -2,32 +2,23 @@
.. _DMX_SET_FILTER: .. _DMX_SET_FILTER:
==============
DMX_SET_FILTER DMX_SET_FILTER
============== ==============
Description NAME
----------- ----
This ioctl call sets up a filter according to the filter and mask DMX_SET_FILTER
parameters provided. A timeout may be defined stating number of seconds
to wait for a section to be loaded. A value of 0 means that no timeout
should be applied. Finally there is a flag field where it is possible to
state whether a section should be CRC-checked, whether the filter should
be a ”one-shot” filter, i.e. if the filtering operation should be
stopped after the first section is received, and whether the filtering
operation should be started immediately (without waiting for a
DMX_START ioctl call). If a filter was previously set-up, this filter
will be canceled, and the receive buffer will be flushed.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_SET_FILTER, struct dmx_sct_filter_params *params) .. c:function:: int ioctl( int fd, int request = DMX_SET_FILTER, struct dmx_sct_filter_params *params)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -53,11 +44,24 @@ Arguments ...@@ -53,11 +44,24 @@ Arguments
- Pointer to structure containing filter parameters. - Pointer to structure containing filter parameters.
Return Value DESCRIPTION
-----------
This ioctl call sets up a filter according to the filter and mask
parameters provided. A timeout may be defined stating number of seconds
to wait for a section to be loaded. A value of 0 means that no timeout
should be applied. Finally there is a flag field where it is possible to
state whether a section should be CRC-checked, whether the filter should
be a ”one-shot” filter, i.e. if the filtering operation should be
stopped after the first section is received, and whether the filtering
operation should be started immediately (without waiting for a
DMX_START ioctl call). If a filter was previously set-up, this filter
will be canceled, and the receive buffer will be flushed.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-set-pes-filter.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _DMX_SET_PES_FILTER: .. _DMX_SET_PES_FILTER:
==================
DMX_SET_PES_FILTER DMX_SET_PES_FILTER
================== ==================
Description NAME
----------- ----
This ioctl call sets up a PES filter according to the parameters DMX_SET_PES_FILTER
provided. By a PES filter is meant a filter that is based just on the
packet identifier (PID), i.e. no PES header or payload filtering
capability is supported.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_SET_PES_FILTER, struct dmx_pes_filter_params *params) .. c:function:: int ioctl( int fd, int request = DMX_SET_PES_FILTER, struct dmx_pes_filter_params *params)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,7 +44,16 @@ Arguments ...@@ -47,7 +44,16 @@ Arguments
- Pointer to structure containing filter parameters. - Pointer to structure containing filter parameters.
Return Value DESCRIPTION
-----------
This ioctl call sets up a PES filter according to the parameters
provided. By a PES filter is meant a filter that is based just on the
packet identifier (PID), i.e. no PES header or payload filtering
capability is supported.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -69,6 +75,3 @@ appropriately. The generic error codes are described at the ...@@ -69,6 +75,3 @@ appropriately. The generic error codes are described at the
There are active filters filtering data from another input source. There are active filters filtering data from another input source.
Make sure that these filters are stopped before starting this Make sure that these filters are stopped before starting this
filter. filter.
Documentation/linux_tv/media/dvb/dmx-set-source.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _DMX_SET_SOURCE: .. _DMX_SET_SOURCE:
==============
DMX_SET_SOURCE DMX_SET_SOURCE
============== ==============
Description NAME
----------- ----
This ioctl is undocumented. Documentation is welcome. DMX_SET_SOURCE
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = DMX_SET_SOURCE, dmx_source_t *) .. c:function:: int ioctl(fd, int request = DMX_SET_SOURCE, dmx_source_t *)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Undocumented. - Undocumented.
Return Value DESCRIPTION
-----------
This ioctl is undocumented. Documentation is welcome.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/dmx-start.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _DMX_START: .. _DMX_START:
=========
DMX_START DMX_START
========= =========
Description NAME
----------- ----
This ioctl call is used to start the actual filtering operation defined DMX_START
via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_START) .. c:function:: int ioctl( int fd, int request = DMX_START)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,7 +38,14 @@ Arguments ...@@ -39,7 +38,14 @@ Arguments
- Equals DMX_START for this command. - Equals DMX_START for this command.
Return Value DESCRIPTION
-----------
This ioctl call is used to start the actual filtering operation defined
via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the ...@@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the
There are active filters filtering data from another input source. There are active filters filtering data from another input source.
Make sure that these filters are stopped before starting this Make sure that these filters are stopped before starting this
filter. filter.
Documentation/linux_tv/media/dvb/dmx-stop.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _DMX_STOP: .. _DMX_STOP:
========
DMX_STOP DMX_STOP
======== ========
Description NAME
----------- ----
This ioctl call is used to stop the actual filtering operation defined DMX_STOP
via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER and
started via the DMX_START command.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl( int fd, int request = DMX_STOP) .. c:function:: int ioctl( int fd, int request = DMX_STOP)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -40,11 +38,17 @@ Arguments ...@@ -40,11 +38,17 @@ Arguments
- Equals DMX_STOP for this command. - Equals DMX_STOP for this command.
Return Value DESCRIPTION
-----------
This ioctl call is used to stop the actual filtering operation defined
via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER and
started via the DMX_START command.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_DISEQC_RECV_SLAVE_REPLY ioctl FE_DISEQC_RECV_SLAVE_REPLY
******************************** ********************************
*man FE_DISEQC_RECV_SLAVE_REPLY(2)* NAME
====
Receives reply from a DiSEqC 2.0 command FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_slave_reply *argp ) .. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_slave_reply *argp )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -30,12 +31,14 @@ Arguments ...@@ -30,12 +31,14 @@ Arguments
:ref:`dvb_diseqc_slave_reply <dvb-diseqc-slave-reply>` :ref:`dvb_diseqc_slave_reply <dvb-diseqc-slave-reply>`
Description DESCRIPTION
=========== ===========
Receives reply from a DiSEqC 2.0 command. Receives reply from a DiSEqC 2.0 command.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst
View file @ 586027ce
...@@ -6,18 +6,18 @@ ...@@ -6,18 +6,18 @@
ioctl FE_DISEQC_RESET_OVERLOAD ioctl FE_DISEQC_RESET_OVERLOAD
****************************** ******************************
*man FE_DISEQC_RESET_OVERLOAD(2)* NAME
====
Restores the power to the antenna subsystem, if it was powered off due FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload.
to power overload.
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, NULL ) .. cpp:function:: int ioctl( int fd, int request, NULL )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -27,7 +27,7 @@ Arguments ...@@ -27,7 +27,7 @@ Arguments
FE_DISEQC_RESET_OVERLOAD FE_DISEQC_RESET_OVERLOAD
Description DESCRIPTION
=========== ===========
If the bus has been automatically powered off due to power overload, If the bus has been automatically powered off due to power overload,
...@@ -35,7 +35,9 @@ this ioctl call restores the power to the bus. The call requires ...@@ -35,7 +35,9 @@ this ioctl call restores the power to the bus. The call requires
read/write access to the device. This call has no effect if the device read/write access to the device. This call has no effect if the device
is manually powered off. Not all DVB adapters support this ioctl. is manually powered off. Not all DVB adapters support this ioctl.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_DISEQC_SEND_BURST ioctl FE_DISEQC_SEND_BURST
************************** **************************
*man FE_DISEQC_SEND_BURST(2)* NAME
====
Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection. FE_DISEQC_SEND_BURST - Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection.
SYNOPSIS
Synopsis
======== ========
.. c:function:: int ioctl( int fd, int request, enum fe_sec_mini_cmd *tone ) .. c:function:: int ioctl( int fd, int request, enum fe_sec_mini_cmd *tone )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -29,7 +30,7 @@ Arguments ...@@ -29,7 +30,7 @@ Arguments
pointer to enum :ref:`fe_sec_mini_cmd <fe-sec-mini-cmd>` pointer to enum :ref:`fe_sec_mini_cmd <fe-sec-mini-cmd>`
Description DESCRIPTION
=========== ===========
This ioctl is used to set the generation of a 22kHz tone burst for mini This ioctl is used to set the generation of a 22kHz tone burst for mini
...@@ -39,7 +40,9 @@ read/write permissions. ...@@ -39,7 +40,9 @@ read/write permissions.
It provides support for what's specified at It provides support for what's specified at
`Digital Satellite Equipment Control (DiSEqC) - Simple "ToneBurst" Detection Circuit specification. <http://www.eutelsat.com/files/contributed/satellites/pdf/Diseqc/associated%20docs/simple_tone_burst_detec.pdf>`__ `Digital Satellite Equipment Control (DiSEqC) - Simple "ToneBurst" Detection Circuit specification. <http://www.eutelsat.com/files/contributed/satellites/pdf/Diseqc/associated%20docs/simple_tone_burst_detec.pdf>`__
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_DISEQC_SEND_MASTER_CMD ioctl FE_DISEQC_SEND_MASTER_CMD
******************************* *******************************
*man FE_DISEQC_SEND_MASTER_CMD(2)* NAME
====
Sends a DiSEqC command FE_DISEQC_SEND_MASTER_CMD - Sends a DiSEqC command
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_master_cmd *argp ) .. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_master_cmd *argp )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -30,12 +31,14 @@ Arguments ...@@ -30,12 +31,14 @@ Arguments
:ref:`dvb_diseqc_master_cmd <dvb-diseqc-master-cmd>` :ref:`dvb_diseqc_master_cmd <dvb-diseqc-master-cmd>`
Description DESCRIPTION
=========== ===========
Sends a DiSEqC command to the antenna subsystem. Sends a DiSEqC command to the antenna subsystem.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst
View file @ 586027ce
...@@ -6,18 +6,18 @@ ...@@ -6,18 +6,18 @@
ioctl FE_ENABLE_HIGH_LNB_VOLTAGE ioctl FE_ENABLE_HIGH_LNB_VOLTAGE
******************************** ********************************
*man FE_ENABLE_HIGH_LNB_VOLTAGE(2)* NAME
====
Select output DC level between normal LNBf voltages or higher LNBf
voltages.
FE_ENABLE_HIGH_LNB_VOLTAGE - Select output DC level between normal LNBf voltages or higher LNBf - voltages.
Synopsis SYNOPSIS
======== ========
.. cpp:function:: int ioctl( int fd, int request, unsigned int high ) .. cpp:function:: int ioctl( int fd, int request, unsigned int high )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -35,14 +35,16 @@ Arguments ...@@ -35,14 +35,16 @@ Arguments
to compensate for long antenna cables. to compensate for long antenna cables.
Description DESCRIPTION
=========== ===========
Select output DC level between normal LNBf voltages or higher LNBf Select output DC level between normal LNBf voltages or higher LNBf
voltages between 0 (normal) or a value grater than 0 for higher voltages between 0 (normal) or a value grater than 0 for higher
voltages. voltages.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-get-info.rst
View file @ 586027ce
...@@ -6,18 +6,18 @@ ...@@ -6,18 +6,18 @@
ioctl FE_GET_INFO ioctl FE_GET_INFO
***************** *****************
*man FE_GET_INFO(2)* NAME
====
Query DVB frontend capabilities and returns information about the FE_GET_INFO - Query DVB frontend capabilities and returns information about the - front-end. This call only requires read-only access to the device
front-end. This call only requires read-only access to the device
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dvb_frontend_info *argp ) .. cpp:function:: int ioctl( int fd, int request, struct dvb_frontend_info *argp )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -31,7 +31,7 @@ Arguments ...@@ -31,7 +31,7 @@ Arguments
:ref:`dvb_frontend_info <dvb-frontend-info>` :ref:`dvb_frontend_info <dvb-frontend-info>`
Description DESCRIPTION
=========== ===========
All DVB frontend devices support the ``FE_GET_INFO`` ioctl. It is used All DVB frontend devices support the ``FE_GET_INFO`` ioctl. It is used
...@@ -41,7 +41,9 @@ takes a pointer to dvb_frontend_info which is filled by the driver. ...@@ -41,7 +41,9 @@ takes a pointer to dvb_frontend_info which is filled by the driver.
When the driver is not compatible with this specification the ioctl When the driver is not compatible with this specification the ioctl
returns an error. returns an error.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-get-property.rst
View file @ 586027ce
...@@ -6,19 +6,18 @@ ...@@ -6,19 +6,18 @@
ioctl FE_SET_PROPERTY, FE_GET_PROPERTY ioctl FE_SET_PROPERTY, FE_GET_PROPERTY
************************************** **************************************
*man FE_SET_PROPERTY(2)* NAME
====
FE_GET_PROPERTY FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties.
FE_SET_PROPERTY sets one or more frontend properties.
FE_GET_PROPERTY returns one or more frontend properties.
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dtv_properties *argp ) .. cpp:function:: int ioctl( int fd, int request, struct dtv_properties *argp )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -31,7 +30,7 @@ Arguments ...@@ -31,7 +30,7 @@ Arguments
pointer to struct :ref:`dtv_properties <dtv-properties>` pointer to struct :ref:`dtv_properties <dtv-properties>`
Description DESCRIPTION
=========== ===========
All DVB frontend devices support the ``FE_SET_PROPERTY`` and All DVB frontend devices support the ``FE_SET_PROPERTY`` and
...@@ -59,7 +58,9 @@ depends on the delivery system and on the device: ...@@ -59,7 +58,9 @@ depends on the delivery system and on the device:
- This call only requires read-only access to the device. - This call only requires read-only access to the device.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-read-status.rst
View file @ 586027ce
...@@ -6,18 +6,18 @@ ...@@ -6,18 +6,18 @@
ioctl FE_READ_STATUS ioctl FE_READ_STATUS
******************** ********************
*man FE_READ_STATUS(2)* NAME
====
Returns status information about the front-end. This call only requires FE_READ_STATUS - Returns status information about the front-end. This call only requires - read-only access to the device
read-only access to the device
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, unsigned int *status ) .. cpp:function:: int ioctl( int fd, int request, unsigned int *status )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -31,7 +31,7 @@ Arguments ...@@ -31,7 +31,7 @@ Arguments
:ref:`fe_status <fe-status>`. :ref:`fe_status <fe-status>`.
Description DESCRIPTION
=========== ===========
All DVB frontend devices support the ``FE_READ_STATUS`` ioctl. It is All DVB frontend devices support the ``FE_READ_STATUS`` ioctl. It is
...@@ -43,7 +43,9 @@ NOTE: the size of status is actually sizeof(enum fe_status), with ...@@ -43,7 +43,9 @@ NOTE: the size of status is actually sizeof(enum fe_status), with
varies according with the architecture. This needs to be fixed in the varies according with the architecture. This needs to be fixed in the
future. future.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_SET_FRONTEND_TUNE_MODE ioctl FE_SET_FRONTEND_TUNE_MODE
******************************* *******************************
*man FE_SET_FRONTEND_TUNE_MODE(2)* NAME
====
Allow setting tuner mode flags to the frontend. FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, unsigned int flags ) .. cpp:function:: int ioctl( int fd, int request, unsigned int flags )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -38,13 +39,15 @@ Arguments ...@@ -38,13 +39,15 @@ Arguments
device is reopened read-write. device is reopened read-write.
Description DESCRIPTION
=========== ===========
Allow setting tuner mode flags to the frontend, between 0 (normal) or Allow setting tuner mode flags to the frontend, between 0 (normal) or
FE_TUNE_MODE_ONESHOT mode FE_TUNE_MODE_ONESHOT mode
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-set-tone.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_SET_TONE ioctl FE_SET_TONE
***************** *****************
*man FE_SET_TONE(2)* NAME
====
Sets/resets the generation of the continuous 22kHz tone. FE_SET_TONE - Sets/resets the generation of the continuous 22kHz tone.
SYNOPSIS
Synopsis
======== ========
.. c:function:: int ioctl( int fd, int request, enum fe_sec_tone_mode *tone ) .. c:function:: int ioctl( int fd, int request, enum fe_sec_tone_mode *tone )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -29,7 +30,7 @@ Arguments ...@@ -29,7 +30,7 @@ Arguments
pointer to enum :ref:`fe_sec_tone_mode <fe-sec-tone-mode>` pointer to enum :ref:`fe_sec_tone_mode <fe-sec-tone-mode>`
Description DESCRIPTION
=========== ===========
This ioctl is used to set the generation of the continuous 22kHz tone. This ioctl is used to set the generation of the continuous 22kHz tone.
...@@ -45,7 +46,9 @@ a tone may interfere on other devices, as they may lose the capability ...@@ -45,7 +46,9 @@ a tone may interfere on other devices, as they may lose the capability
of selecting the band. So, it is recommended that applications would of selecting the band. So, it is recommended that applications would
change to SEC_TONE_OFF when the device is not used. change to SEC_TONE_OFF when the device is not used.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/fe-set-voltage.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl FE_SET_VOLTAGE ioctl FE_SET_VOLTAGE
******************** ********************
*man FE_SET_VOLTAGE(2)* NAME
====
Allow setting the DC level sent to the antenna subsystem. FE_SET_VOLTAGE - Allow setting the DC level sent to the antenna subsystem.
SYNOPSIS
Synopsis
======== ========
.. c:function:: int ioctl( int fd, int request, enum fe_sec_voltage *voltage ) .. c:function:: int ioctl( int fd, int request, enum fe_sec_voltage *voltage )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -32,7 +33,7 @@ Arguments ...@@ -32,7 +33,7 @@ Arguments
:ref:`fe_sec_voltage <fe-sec-voltage>`. :ref:`fe_sec_voltage <fe-sec-voltage>`.
Description DESCRIPTION
=========== ===========
This ioctl allows to set the DC voltage level sent through the antenna This ioctl allows to set the DC voltage level sent through the antenna
...@@ -52,7 +53,9 @@ capability of setting polarization or IF. So, on those cases, setting ...@@ -52,7 +53,9 @@ capability of setting polarization or IF. So, on those cases, setting
the voltage to SEC_VOLTAGE_OFF while the device is not is used is the voltage to SEC_VOLTAGE_OFF while the device is not is used is
recommended. recommended.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/frontend_f_close.rst
View file @ 586027ce
...@@ -6,12 +6,12 @@ ...@@ -6,12 +6,12 @@
DVB frontend close() DVB frontend close()
******************** ********************
*man fe-close(2)* NAME
====
Close a frontend device fe-close - Close a frontend device
SYNOPSIS
Synopsis
======== ========
.. code-block:: c .. code-block:: c
...@@ -21,14 +21,15 @@ Synopsis ...@@ -21,14 +21,15 @@ Synopsis
.. cpp:function:: int close( int fd ) .. cpp:function:: int close( int fd )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
File descriptor returned by :ref:`open() <func-open>`. File descriptor returned by :ref:`open() <func-open>`.
Description DESCRIPTION
=========== ===========
This system call closes a previously opened front-end device. After This system call closes a previously opened front-end device. After
...@@ -36,7 +37,7 @@ closing a front-end device, its corresponding hardware might be powered ...@@ -36,7 +37,7 @@ closing a front-end device, its corresponding hardware might be powered
down automatically. down automatically.
Return Value RETURN VALUE
============ ============
The function returns 0 on success, -1 on failure and the ``errno`` is The function returns 0 on success, -1 on failure and the ``errno`` is
......
Documentation/linux_tv/media/dvb/frontend_f_open.rst
View file @ 586027ce
...@@ -6,12 +6,12 @@ ...@@ -6,12 +6,12 @@
DVB frontend open() DVB frontend open()
******************* *******************
*man fe-open(2)* NAME
====
Open a frontend device fe-open - Open a frontend device
SYNOPSIS
Synopsis
======== ========
.. code-block:: c .. code-block:: c
...@@ -21,7 +21,8 @@ Synopsis ...@@ -21,7 +21,8 @@ Synopsis
.. cpp:function:: int open( const char *device_name, int flags ) .. cpp:function:: int open( const char *device_name, int flags )
Arguments
ARGUMENTS
========= =========
``device_name`` ``device_name``
...@@ -43,7 +44,7 @@ Arguments ...@@ -43,7 +44,7 @@ Arguments
Other flags have no effect. Other flags have no effect.
Description DESCRIPTION
=========== ===========
This system call opens a named frontend device This system call opens a named frontend device
...@@ -69,7 +70,7 @@ powered up, and that other front-ends may have been powered down to make ...@@ -69,7 +70,7 @@ powered up, and that other front-ends may have been powered down to make
that possible. that possible.
Return Value RETURN VALUE
============ ============
On success :ref:`open() <frontend_f_open>` returns the new file descriptor. On success :ref:`open() <frontend_f_open>` returns the new file descriptor.
......
Documentation/linux_tv/media/dvb/net-add-if.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl NET_ADD_IF ioctl NET_ADD_IF
**************** ****************
*man NET_ADD_IF(2)* NAME
====
Creates a new network interface for a given Packet ID. NET_ADD_IF - Creates a new network interface for a given Packet ID.
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if ) .. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -29,7 +30,7 @@ Arguments ...@@ -29,7 +30,7 @@ Arguments
pointer to struct :ref:`dvb_net_if <dvb-net-if>` pointer to struct :ref:`dvb_net_if <dvb-net-if>`
Description DESCRIPTION
=========== ===========
The NET_ADD_IF ioctl system call selects the Packet ID (PID) that The NET_ADD_IF ioctl system call selects the Packet ID (PID) that
...@@ -80,7 +81,9 @@ struct dvb_net_if description ...@@ -80,7 +81,9 @@ struct dvb_net_if description
``DVB_NET_FEEDTYPE_MPE`` for MPE encoding or ``DVB_NET_FEEDTYPE_MPE`` for MPE encoding or
``DVB_NET_FEEDTYPE_ULE`` for ULE encoding. ``DVB_NET_FEEDTYPE_ULE`` for ULE encoding.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/net-get-if.rst
View file @ 586027ce
.. -*- coding: utf-8; mode: rst -*- .. -*- coding: utf-8; mode: rst -*-
.. _NET_GET_IF: .. _NET_GET_IF:
**************** ****************
ioctl NET_GET_IF ioctl NET_GET_IF
**************** ****************
*man NET_GET_IF(2)* NAME
====
Read the configuration data of an interface created via
:ref:`NET_ADD_IF <net>`.
NET_GET_IF - Read the configuration data of an interface created via - :ref:`NET_ADD_IF <net>`.
Synopsis SYNOPSIS
======== ========
.. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if ) .. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -31,7 +30,7 @@ Arguments ...@@ -31,7 +30,7 @@ Arguments
pointer to struct :ref:`dvb_net_if <dvb-net-if>` pointer to struct :ref:`dvb_net_if <dvb-net-if>`
Description DESCRIPTION
=========== ===========
The NET_GET_IF ioctl uses the interface number given by the struct The NET_GET_IF ioctl uses the interface number given by the struct
...@@ -41,7 +40,9 @@ encapsulation type used on such interface. If the interface was not ...@@ -41,7 +40,9 @@ encapsulation type used on such interface. If the interface was not
created yet with :ref:`NET_ADD_IF <net>`, it will return -1 and fill created yet with :ref:`NET_ADD_IF <net>`, it will return -1 and fill
the ``errno`` with ``EINVAL`` error code. the ``errno`` with ``EINVAL`` error code.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/net-remove-if.rst
View file @ 586027ce
...@@ -6,17 +6,18 @@ ...@@ -6,17 +6,18 @@
ioctl NET_REMOVE_IF ioctl NET_REMOVE_IF
******************* *******************
*man NET_REMOVE_IF(2)* NAME
====
Removes a network interface. NET_REMOVE_IF - Removes a network interface.
SYNOPSIS
Synopsis
======== ========
.. cpp:function:: int ioctl( int fd, int request, int ifnum ) .. cpp:function:: int ioctl( int fd, int request, int ifnum )
Arguments
ARGUMENTS
========= =========
``fd`` ``fd``
...@@ -29,13 +30,15 @@ Arguments ...@@ -29,13 +30,15 @@ Arguments
number of the interface to be removed number of the interface to be removed
Description DESCRIPTION
=========== ===========
The NET_REMOVE_IF ioctl deletes an interface previously created via The NET_REMOVE_IF ioctl deletes an interface previously created via
:ref:`NET_ADD_IF <net>`. :ref:`NET_ADD_IF <net>`.
RETURN VALUE RETURN VALUE
============
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
......
Documentation/linux_tv/media/dvb/video-clear-buffer.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _VIDEO_CLEAR_BUFFER: .. _VIDEO_CLEAR_BUFFER:
==================
VIDEO_CLEAR_BUFFER VIDEO_CLEAR_BUFFER
================== ==================
Description NAME
----------- ----
This ioctl call clears all video buffers in the driver and in the VIDEO_CLEAR_BUFFER
decoder hardware.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_CLEAR_BUFFER) .. c:function:: int ioctl(fd, int request = VIDEO_CLEAR_BUFFER)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -39,11 +38,16 @@ Arguments ...@@ -39,11 +38,16 @@ Arguments
- Equals VIDEO_CLEAR_BUFFER for this command. - Equals VIDEO_CLEAR_BUFFER for this command.
Return Value DESCRIPTION
-----------
This ioctl call clears all video buffers in the driver and in the
decoder hardware.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-command.rst
View file @ 586027ce
...@@ -2,30 +2,23 @@ ...@@ -2,30 +2,23 @@
.. _VIDEO_COMMAND: .. _VIDEO_COMMAND:
=============
VIDEO_COMMAND VIDEO_COMMAND
============= =============
Description NAME
----------- ----
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders VIDEO_COMMAND
this ioctl has been replaced by the
:ref:`VIDIOC_DECODER_CMD` ioctl.
This ioctl commands the decoder. The ``video_command`` struct is a
subset of the ``v4l2_decoder_cmd`` struct, so refer to the
:ref:`VIDIOC_DECODER_CMD` documentation for
more information.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_COMMAND, struct video_command *cmd) .. c:function:: int ioctl(int fd, int request = VIDEO_COMMAND, struct video_command *cmd)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -51,11 +44,22 @@ Arguments ...@@ -51,11 +44,22 @@ Arguments
- Commands the decoder. - Commands the decoder.
Return Value DESCRIPTION
-----------
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
this ioctl has been replaced by the
:ref:`VIDIOC_DECODER_CMD` ioctl.
This ioctl commands the decoder. The ``video_command`` struct is a
subset of the ``v4l2_decoder_cmd`` struct, so refer to the
:ref:`VIDIOC_DECODER_CMD` documentation for
more information.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-continue.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _VIDEO_CONTINUE: .. _VIDEO_CONTINUE:
==============
VIDEO_CONTINUE VIDEO_CONTINUE
============== ==============
Description NAME
----------- ----
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call restarts decoding and playing processes of the video VIDEO_CONTINUE
stream which was played before a call to VIDEO_FREEZE was made.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_CONTINUE) .. c:function:: int ioctl(fd, int request = VIDEO_CONTINUE)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -42,11 +38,19 @@ Arguments ...@@ -42,11 +38,19 @@ Arguments
- Equals VIDEO_CONTINUE for this command. - Equals VIDEO_CONTINUE for this command.
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call restarts decoding and playing processes of the video
stream which was played before a call to VIDEO_FREEZE was made.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-fast-forward.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _VIDEO_FAST_FORWARD: .. _VIDEO_FAST_FORWARD:
==================
VIDEO_FAST_FORWARD VIDEO_FAST_FORWARD
================== ==================
Description NAME
----------- ----
This ioctl call asks the Video Device to skip decoding of N number of VIDEO_FAST_FORWARD
I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is
selected.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_FAST_FORWARD, int nFrames) .. c:function:: int ioctl(fd, int request = VIDEO_FAST_FORWARD, int nFrames)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,7 +44,15 @@ Arguments ...@@ -46,7 +44,15 @@ Arguments
- The number of frames to skip. - The number of frames to skip.
Return Value DESCRIPTION
-----------
This ioctl call asks the Video Device to skip decoding of N number of
I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is
selected.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the ...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the
- ``EPERM`` - ``EPERM``
- Mode VIDEO_SOURCE_MEMORY not selected. - Mode VIDEO_SOURCE_MEMORY not selected.
Documentation/linux_tv/media/dvb/video-fclose.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _video_fclose: .. _video_fclose:
=================
dvb video close() dvb video close()
================= =================
Description NAME
----------- ----
This system call closes a previously opened video device. dvb video close()
Synopsis SYNOPSIS
-------- --------
.. c:function:: int close(int fd) .. c:function:: int close(int fd)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -32,10 +32,14 @@ Arguments ...@@ -32,10 +32,14 @@ Arguments
- File descriptor returned by a previous call to open(). - File descriptor returned by a previous call to open().
Return Value DESCRIPTION
------------ -----------
This system call closes a previously opened video device.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,6 +51,3 @@ Return Value ...@@ -47,6 +51,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/video-fopen.rst
View file @ 586027ce
...@@ -2,35 +2,23 @@ ...@@ -2,35 +2,23 @@
.. _video_fopen: .. _video_fopen:
================
dvb video open() dvb video open()
================ ================
Description NAME
----------- ----
This system call opens a named video device (e.g.
/dev/dvb/adapter0/video0) for subsequent use.
When an open() call has succeeded, the device will be ready for use. The dvb video open()
significance of blocking or non-blocking mode is described in the
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call. This is a standard
system call, documented in the Linux manual page for fcntl. Only one
user can open the Video Device in O_RDWR mode. All other attempts to
open the device in this mode will fail, and an error-code will be
returned. If the Video Device is opened in O_RDONLY mode, the only
ioctl call that can be used is VIDEO_GET_STATUS. All other call will
return an error code.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int open(const char *deviceName, int flags) .. c:function:: int open(const char *deviceName, int flags)
Arguments
---------- ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -70,11 +58,29 @@ Arguments ...@@ -70,11 +58,29 @@ Arguments
- (blocking mode is the default) - (blocking mode is the default)
Return Value DESCRIPTION
------------ -----------
This system call opens a named video device (e.g.
/dev/dvb/adapter0/video0) for subsequent use.
When an open() call has succeeded, the device will be ready for use. The
significance of blocking or non-blocking mode is described in the
documentation for functions where there is a difference. It does not
affect the semantics of the open() call itself. A device opened in
blocking mode can later be put into non-blocking mode (and vice versa)
using the F_SETFL command of the fcntl system call. This is a standard
system call, documented in the Linux manual page for fcntl. Only one
user can open the Video Device in O_RDWR mode. All other attempts to
open the device in this mode will fail, and an error-code will be
returned. If the Video Device is opened in O_RDONLY mode, the only
ioctl call that can be used is VIDEO_GET_STATUS. All other call will
return an error code.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -103,6 +109,3 @@ Return Value ...@@ -103,6 +109,3 @@ Return Value
- ``EINVAL`` - ``EINVAL``
- Invalid argument. - Invalid argument.
Documentation/linux_tv/media/dvb/video-freeze.rst
View file @ 586027ce
...@@ -2,31 +2,23 @@ ...@@ -2,31 +2,23 @@
.. _VIDEO_FREEZE: .. _VIDEO_FREEZE:
============
VIDEO_FREEZE VIDEO_FREEZE
============ ============
Description NAME
----------- ----
This ioctl is for DVB devices only. To control a V4L2 decoder use the VIDEO_FREEZE
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call suspends the live video stream being played. Decoding
and playing are frozen. It is then possible to restart the decoding and
playing process of the video stream using the VIDEO_CONTINUE command.
If VIDEO_SOURCE_MEMORY is selected in the ioctl call
VIDEO_SELECT_SOURCE, the DVB subsystem will not decode any more data
until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_FREEZE) .. c:function:: int ioctl(fd, int request = VIDEO_FREEZE)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,11 +38,23 @@ Arguments ...@@ -46,11 +38,23 @@ Arguments
- Equals VIDEO_FREEZE for this command. - Equals VIDEO_FREEZE for this command.
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call suspends the live video stream being played. Decoding
and playing are frozen. It is then possible to restart the decoding and
playing process of the video stream using the VIDEO_CONTINUE command.
If VIDEO_SOURCE_MEMORY is selected in the ioctl call
VIDEO_SELECT_SOURCE, the DVB subsystem will not decode any more data
until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-fwrite.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _video_fwrite: .. _video_fwrite:
=================
dvb video write() dvb video write()
================= =================
Description NAME
----------- ----
This system call can only be used if VIDEO_SOURCE_MEMORY is selected dvb video write()
in the ioctl call VIDEO_SELECT_SOURCE. The data provided shall be in
PES format, unless the capability allows other formats. If O_NONBLOCK
is not specified the function will block until buffer space is
available. The amount of data to be transferred is implied by count.
Synopsis SYNOPSIS
-------- --------
.. c:function:: size_t write(int fd, const void *buf, size_t count) .. c:function:: size_t write(int fd, const void *buf, size_t count)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -48,11 +44,19 @@ Arguments ...@@ -48,11 +44,19 @@ Arguments
- Size of buf. - Size of buf.
Return Value DESCRIPTION
------------ -----------
This system call can only be used if VIDEO_SOURCE_MEMORY is selected
in the ioctl call VIDEO_SELECT_SOURCE. The data provided shall be in
PES format, unless the capability allows other formats. If O_NONBLOCK
is not specified the function will block until buffer space is
available. The amount of data to be transferred is implied by count.
RETURN VALUE
------------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
...@@ -75,6 +79,3 @@ Return Value ...@@ -75,6 +79,3 @@ Return Value
- ``EBADF`` - ``EBADF``
- fd is not a valid open file descriptor. - fd is not a valid open file descriptor.
Documentation/linux_tv/media/dvb/video-get-capabilities.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _VIDEO_GET_CAPABILITIES: .. _VIDEO_GET_CAPABILITIES:
======================
VIDEO_GET_CAPABILITIES VIDEO_GET_CAPABILITIES
====================== ======================
Description NAME
----------- ----
This ioctl call asks the video device about its decoding capabilities. VIDEO_GET_CAPABILITIES
On success it returns and integer which has bits set according to the
defines in section ??.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_GET_CAPABILITIES, unsigned int *cap) .. c:function:: int ioctl(fd, int request = VIDEO_GET_CAPABILITIES, unsigned int *cap)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,11 +44,17 @@ Arguments ...@@ -46,11 +44,17 @@ Arguments
- Pointer to a location where to store the capability information. - Pointer to a location where to store the capability information.
Return Value DESCRIPTION
-----------
This ioctl call asks the video device about its decoding capabilities.
On success it returns and integer which has bits set according to the
defines in section ??.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-get-event.rst
View file @ 586027ce
...@@ -2,35 +2,23 @@ ...@@ -2,35 +2,23 @@
.. _VIDEO_GET_EVENT: .. _VIDEO_GET_EVENT:
===============
VIDEO_GET_EVENT VIDEO_GET_EVENT
=============== ===============
Description NAME
----------- ----
This ioctl is for DVB devices only. To get events from a V4L2 decoder
use the V4L2 :ref:`VIDIOC_DQEVENT` ioctl instead.
This ioctl call returns an event of type video_event if available. If VIDEO_GET_EVENT
an event is not available, the behavior depends on whether the device is
in blocking or non-blocking mode. In the latter case, the call fails
immediately with errno set to ``EWOULDBLOCK``. In the former case, the call
blocks until an event becomes available. The standard Linux poll()
and/or select() system calls can be used with the device file descriptor
to watch for new events. For select(), the file descriptor should be
included in the exceptfds argument, and for poll(), POLLPRI should be
specified as the wake-up condition. Read-only permissions are sufficient
for this ioctl call.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_GET_EVENT, struct video_event *ev) .. c:function:: int ioctl(fd, int request = VIDEO_GET_EVENT, struct video_event *ev)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -56,7 +44,25 @@ Arguments ...@@ -56,7 +44,25 @@ Arguments
- Points to the location where the event, if any, is to be stored. - Points to the location where the event, if any, is to be stored.
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To get events from a V4L2 decoder
use the V4L2 :ref:`VIDIOC_DQEVENT` ioctl instead.
This ioctl call returns an event of type video_event if available. If
an event is not available, the behavior depends on whether the device is
in blocking or non-blocking mode. In the latter case, the call fails
immediately with errno set to ``EWOULDBLOCK``. In the former case, the call
blocks until an event becomes available. The standard Linux poll()
and/or select() system calls can be used with the device file descriptor
to watch for new events. For select(), the file descriptor should be
included in the exceptfds argument, and for poll(), POLLPRI should be
specified as the wake-up condition. Read-only permissions are sufficient
for this ioctl call.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -81,6 +87,3 @@ appropriately. The generic error codes are described at the ...@@ -81,6 +87,3 @@ appropriately. The generic error codes are described at the
- ``EOVERFLOW`` - ``EOVERFLOW``
- Overflow in event queue - one or more events were lost. - Overflow in event queue - one or more events were lost.
Documentation/linux_tv/media/dvb/video-get-frame-count.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _VIDEO_GET_FRAME_COUNT: .. _VIDEO_GET_FRAME_COUNT:
=====================
VIDEO_GET_FRAME_COUNT VIDEO_GET_FRAME_COUNT
===================== =====================
Description NAME
----------- ----
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_FRAME``
control.
This ioctl call asks the Video Device to return the number of displayed VIDEO_GET_FRAME_COUNT
frames since the decoder was started.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_COUNT, __u64 *pts) .. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_COUNT, __u64 *pts)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -50,11 +45,20 @@ Arguments ...@@ -50,11 +45,20 @@ Arguments
started. started.
Return Value DESCRIPTION
-----------
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_FRAME``
control.
This ioctl call asks the Video Device to return the number of displayed
frames since the decoder was started.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-get-frame-rate.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _VIDEO_GET_FRAME_RATE: .. _VIDEO_GET_FRAME_RATE:
====================
VIDEO_GET_FRAME_RATE VIDEO_GET_FRAME_RATE
==================== ====================
Description NAME
----------- ----
This ioctl call asks the Video Device to return the current framerate. VIDEO_GET_FRAME_RATE
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_RATE, unsigned int *rate) .. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_RATE, unsigned int *rate)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Returns the framerate in number of frames per 1000 seconds. - Returns the framerate in number of frames per 1000 seconds.
Return Value DESCRIPTION
-----------
This ioctl call asks the Video Device to return the current framerate.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-get-navi.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _VIDEO_GET_NAVI: .. _VIDEO_GET_NAVI:
==============
VIDEO_GET_NAVI VIDEO_GET_NAVI
============== ==============
Description NAME
----------- ----
This ioctl returns navigational information from the DVD stream. This is VIDEO_GET_NAVI
especially needed if an encoded stream has to be decoded by the
hardware.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_GET_NAVI , video_navi_pack_t *navipack) .. c:function:: int ioctl(fd, int request = VIDEO_GET_NAVI , video_navi_pack_t *navipack)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,7 +44,15 @@ Arguments ...@@ -46,7 +44,15 @@ Arguments
- PCI or DSI pack (private stream 2) according to section ??. - PCI or DSI pack (private stream 2) according to section ??.
Return Value DESCRIPTION
-----------
This ioctl returns navigational information from the DVD stream. This is
especially needed if an encoded stream has to be decoded by the
hardware.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the ...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the
- ``EFAULT`` - ``EFAULT``
- driver is not able to return navigational information - driver is not able to return navigational information
Documentation/linux_tv/media/dvb/video-get-pts.rst
View file @ 586027ce
...@@ -2,28 +2,23 @@ ...@@ -2,28 +2,23 @@
.. _VIDEO_GET_PTS: .. _VIDEO_GET_PTS:
=============
VIDEO_GET_PTS VIDEO_GET_PTS
============= =============
Description NAME
----------- ----
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS``
control.
This ioctl call asks the Video Device to return the current PTS VIDEO_GET_PTS
timestamp.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_GET_PTS, __u64 *pts) .. c:function:: int ioctl(int fd, int request = VIDEO_GET_PTS, __u64 *pts)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -54,11 +49,20 @@ Arguments ...@@ -54,11 +49,20 @@ Arguments
decoded frame or the last PTS extracted by the PES parser. decoded frame or the last PTS extracted by the PES parser.
Return Value DESCRIPTION
-----------
This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS``
control.
This ioctl call asks the Video Device to return the current PTS
timestamp.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-get-size.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _VIDEO_GET_SIZE: .. _VIDEO_GET_SIZE:
==============
VIDEO_GET_SIZE VIDEO_GET_SIZE
============== ==============
Description NAME
----------- ----
This ioctl returns the size and aspect ratio. VIDEO_GET_SIZE
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_GET_SIZE, video_size_t *size) .. c:function:: int ioctl(int fd, int request = VIDEO_GET_SIZE, video_size_t *size)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -44,11 +44,15 @@ Arguments ...@@ -44,11 +44,15 @@ Arguments
- Returns the size and aspect ratio. - Returns the size and aspect ratio.
Return Value DESCRIPTION
-----------
This ioctl returns the size and aspect ratio.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-get-status.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _VIDEO_GET_STATUS: .. _VIDEO_GET_STATUS:
================
VIDEO_GET_STATUS VIDEO_GET_STATUS
================ ================
Description NAME
----------- ----
This ioctl call asks the Video Device to return the current status of VIDEO_GET_STATUS
the device.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_GET_STATUS, struct video_status *status) .. c:function:: int ioctl(fd, int request = VIDEO_GET_STATUS, struct video_status *status)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,11 +44,16 @@ Arguments ...@@ -45,11 +44,16 @@ Arguments
- Returns the current status of the Video Device. - Returns the current status of the Video Device.
Return Value DESCRIPTION
-----------
This ioctl call asks the Video Device to return the current status of
the device.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-play.rst
View file @ 586027ce
...@@ -2,27 +2,23 @@ ...@@ -2,27 +2,23 @@
.. _VIDEO_PLAY: .. _VIDEO_PLAY:
==========
VIDEO_PLAY VIDEO_PLAY
========== ==========
Description NAME
----------- ----
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call asks the Video Device to start playing a video stream VIDEO_PLAY
from the selected source.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_PLAY) .. c:function:: int ioctl(fd, int request = VIDEO_PLAY)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -42,11 +38,19 @@ Arguments ...@@ -42,11 +38,19 @@ Arguments
- Equals VIDEO_PLAY for this command. - Equals VIDEO_PLAY for this command.
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. To control a V4L2 decoder use the
V4L2 :ref:`VIDIOC_DECODER_CMD` instead.
This ioctl call asks the Video Device to start playing a video stream
from the selected source.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-select-source.rst
View file @ 586027ce
...@@ -2,29 +2,23 @@ ...@@ -2,29 +2,23 @@
.. _VIDEO_SELECT_SOURCE: .. _VIDEO_SELECT_SOURCE:
===================
VIDEO_SELECT_SOURCE VIDEO_SELECT_SOURCE
=================== ===================
Description NAME
----------- ----
This ioctl is for DVB devices only. This ioctl was also supported by the
V4L2 ivtv driver, but that has been replaced by the ivtv-specific
``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
This ioctl call informs the video device which source shall be used for VIDEO_SELECT_SOURCE
the input data. The possible sources are demux or memory. If memory is
selected, the data is fed to the video device through the write command.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SELECT_SOURCE, video_stream_source_t source) .. c:function:: int ioctl(fd, int request = VIDEO_SELECT_SOURCE, video_stream_source_t source)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -50,11 +44,21 @@ Arguments ...@@ -50,11 +44,21 @@ Arguments
- Indicates which source shall be used for the Video stream. - Indicates which source shall be used for the Video stream.
Return Value DESCRIPTION
-----------
This ioctl is for DVB devices only. This ioctl was also supported by the
V4L2 ivtv driver, but that has been replaced by the ivtv-specific
``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
This ioctl call informs the video device which source shall be used for
the input data. The possible sources are demux or memory. If memory is
selected, the data is fed to the video device through the write command.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-set-attributes.rst
View file @ 586027ce
...@@ -2,26 +2,23 @@ ...@@ -2,26 +2,23 @@
.. _VIDEO_SET_ATTRIBUTES: .. _VIDEO_SET_ATTRIBUTES:
====================
VIDEO_SET_ATTRIBUTES VIDEO_SET_ATTRIBUTES
==================== ====================
Description NAME
----------- ----
This ioctl is intended for DVD playback and allows you to set certain VIDEO_SET_ATTRIBUTES
information about the stream. Some hardware may not need this
information, but the call also tells the hardware to prepare for DVD
playback.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SET_ATTRIBUTE ,video_attributes_t vattr) .. c:function:: int ioctl(fd, int request = VIDEO_SET_ATTRIBUTE ,video_attributes_t vattr)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -47,7 +44,16 @@ Arguments ...@@ -47,7 +44,16 @@ Arguments
- video attributes according to section ??. - video attributes according to section ??.
Return Value DESCRIPTION
-----------
This ioctl is intended for DVD playback and allows you to set certain
information about the stream. Some hardware may not need this
information, but the call also tells the hardware to prepare for DVD
playback.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
......
Documentation/linux_tv/media/dvb/video-set-blank.rst
View file @ 586027ce
...@@ -2,23 +2,23 @@ ...@@ -2,23 +2,23 @@
.. _VIDEO_SET_BLANK: .. _VIDEO_SET_BLANK:
===============
VIDEO_SET_BLANK VIDEO_SET_BLANK
=============== ===============
Description NAME
----------- ----
This ioctl call asks the Video Device to blank out the picture. VIDEO_SET_BLANK
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SET_BLANK, boolean mode) .. c:function:: int ioctl(fd, int request = VIDEO_SET_BLANK, boolean mode)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -49,11 +49,15 @@ Arguments ...@@ -49,11 +49,15 @@ Arguments
- FALSE: Show last decoded frame. - FALSE: Show last decoded frame.
Return Value DESCRIPTION
-----------
This ioctl call asks the Video Device to blank out the picture.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-set-display-format.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _VIDEO_SET_DISPLAY_FORMAT: .. _VIDEO_SET_DISPLAY_FORMAT:
========================
VIDEO_SET_DISPLAY_FORMAT VIDEO_SET_DISPLAY_FORMAT
======================== ========================
Description NAME
----------- ----
This ioctl call asks the Video Device to select the video format to be VIDEO_SET_DISPLAY_FORMAT
applied by the MPEG chip on the video.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SET_DISPLAY_FORMAT, video_display_format_t format) .. c:function:: int ioctl(fd, int request = VIDEO_SET_DISPLAY_FORMAT, video_display_format_t format)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,11 +44,16 @@ Arguments ...@@ -45,11 +44,16 @@ Arguments
- Selects the video format to be used. - Selects the video format to be used.
Return Value DESCRIPTION
-----------
This ioctl call asks the Video Device to select the video format to be
applied by the MPEG chip on the video.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-set-format.rst
View file @ 586027ce
...@@ -2,25 +2,23 @@ ...@@ -2,25 +2,23 @@
.. _VIDEO_SET_FORMAT: .. _VIDEO_SET_FORMAT:
================
VIDEO_SET_FORMAT VIDEO_SET_FORMAT
================ ================
Description NAME
----------- ----
This ioctl sets the screen format (aspect ratio) of the connected output VIDEO_SET_FORMAT
device (TV) so that the output of the decoder can be adjusted
accordingly.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SET_FORMAT, video_format_t format) .. c:function:: int ioctl(fd, int request = VIDEO_SET_FORMAT, video_format_t format)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -46,7 +44,15 @@ Arguments ...@@ -46,7 +44,15 @@ Arguments
- video format of TV as defined in section ??. - video format of TV as defined in section ??.
Return Value DESCRIPTION
-----------
This ioctl sets the screen format (aspect ratio) of the connected output
device (TV) so that the output of the decoder can be adjusted
accordingly.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the ...@@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- format is not a valid video format. - format is not a valid video format.
Documentation/linux_tv/media/dvb/video-set-highlight.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _VIDEO_SET_HIGHLIGHT: .. _VIDEO_SET_HIGHLIGHT:
===================
VIDEO_SET_HIGHLIGHT VIDEO_SET_HIGHLIGHT
=================== ===================
Description NAME
----------- ----
This ioctl sets the SPU highlight information for the menu access of a VIDEO_SET_HIGHLIGHT
DVD.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(fd, int request = VIDEO_SET_HIGHLIGHT ,video_highlight_t *vhilite) .. c:function:: int ioctl(fd, int request = VIDEO_SET_HIGHLIGHT ,video_highlight_t *vhilite)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,11 +44,16 @@ Arguments ...@@ -45,11 +44,16 @@ Arguments
- SPU Highlight information according to section ??. - SPU Highlight information according to section ??.
Return Value DESCRIPTION
-----------
This ioctl sets the SPU highlight information for the menu access of a
DVD.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter. :ref:`Generic Error Codes <gen-errors>` chapter.
Documentation/linux_tv/media/dvb/video-set-id.rst
View file @ 586027ce
...@@ -2,24 +2,23 @@ ...@@ -2,24 +2,23 @@
.. _VIDEO_SET_ID: .. _VIDEO_SET_ID:
============
VIDEO_SET_ID VIDEO_SET_ID
============ ============
Description NAME
----------- ----
This ioctl selects which sub-stream is to be decoded if a program or VIDEO_SET_ID
system stream is sent to the video device.
Synopsis SYNOPSIS
-------- --------
.. c:function:: int ioctl(int fd, int request = VIDEO_SET_ID, int id) .. c:function:: int ioctl(int fd, int request = VIDEO_SET_ID, int id)
Arguments
----------
ARGUMENTS
---------
.. flat-table:: .. flat-table::
:header-rows: 0 :header-rows: 0
...@@ -45,7 +44,14 @@ Arguments ...@@ -45,7 +44,14 @@ Arguments
- video sub-stream id - video sub-stream id
Return Value DESCRIPTION
-----------
This ioctl selects which sub-stream is to be decoded if a program or
system stream is sent to the video device.
RETURN VALUE
------------ ------------
On success 0 is returned, on error -1 and the ``errno`` variable is set On success 0 is returned, on error -1 and the ``errno`` variable is set
...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the ...@@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the
- ``EINVAL`` - ``EINVAL``
- Invalid sub-stream id. - Invalid sub-stream id.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7