Commit 4872b46b authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

[media] DocBook: document DVB DMX_[ADD|REMOVE]_PID

Those ioctls were added back in 2009, at changeset 1cb662a3
but were never documented. Fortunately, the original commit is
good enough to serve as the basis for documenting it. Also, the
support for it is done by dmxdev implementation.

So, add a proper documentation for it, based on the description
of the original changeset.
Signed-off-by: default avatarMauro Carvalho Chehab <m.chehab@samsung.com>
parent e6876692
...@@ -1042,7 +1042,14 @@ role="subsection"><title>DMX_ADD_PID</title> ...@@ -1042,7 +1042,14 @@ role="subsection"><title>DMX_ADD_PID</title>
</para> </para>
<informaltable><tgroup cols="1"><tbody><row><entry <informaltable><tgroup cols="1"><tbody><row><entry
align="char"> align="char">
<para>This ioctl is undocumented. Documentation is welcome.</para> <para>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.
</para></entry></row><row><entry align="char"><para>
It is used by readers of /dev/dvb/adapterX/demuxY.
</para></entry></row><row><entry align="char"><para>
It may be called at any time, i.e. before or after the first filter on the
shared file descriptor was started. It makes it possible to record multiple
services without the need to de-multiplex or re-multiplex TS packets.</para>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
<para>SYNOPSIS <para>SYNOPSIS
...@@ -1075,7 +1082,7 @@ role="subsection"><title>DMX_ADD_PID</title> ...@@ -1075,7 +1082,7 @@ role="subsection"><title>DMX_ADD_PID</title>
</para> </para>
</entry><entry </entry><entry
align="char"> align="char">
<para>Undocumented.</para> <para>PID number to be filtered.</para>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
&return-value-dvb; &return-value-dvb;
...@@ -1087,7 +1094,15 @@ role="subsection"><title>DMX_REMOVE_PID</title> ...@@ -1087,7 +1094,15 @@ role="subsection"><title>DMX_REMOVE_PID</title>
</para> </para>
<informaltable><tgroup cols="1"><tbody><row><entry <informaltable><tgroup cols="1"><tbody><row><entry
align="char"> align="char">
<para>This ioctl is undocumented. Documentation is welcome.</para> <para>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.
</para></entry></row><row><entry align="char"><para>
It is used by readers of /dev/dvb/adapterX/demuxY.
</para></entry></row><row><entry align="char"><para>
It may be called at any time, i.e. before or after the first filter on the
shared file descriptor was started. It makes it possible to record multiple
services without the need to de-multiplex or re-multiplex TS packets.</para>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
<para>SYNOPSIS <para>SYNOPSIS
...@@ -1120,7 +1135,7 @@ role="subsection"><title>DMX_REMOVE_PID</title> ...@@ -1120,7 +1135,7 @@ role="subsection"><title>DMX_REMOVE_PID</title>
</para> </para>
</entry><entry </entry><entry
align="char"> align="char">
<para>Undocumented.</para> <para>PID of the PES filter to be removed.</para>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
&return-value-dvb; &return-value-dvb;
......
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