^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. _net:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ######################
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Digital TV Network API
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) ######################
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) The Digital TV net device controls the mapping of data packages that are part
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) of a transport stream to be mapped into a virtual network interface,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) visible through the standard Linux network protocol stack.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Currently, two encapsulations are supported:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) - `Multi Protocol Encapsulation (MPE) <http://en.wikipedia.org/wiki/Multiprotocol_Encapsulation>`__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) - `Ultra Lightweight Encapsulation (ULE) <http://en.wikipedia.org/wiki/Unidirectional_Lightweight_Encapsulation>`__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) In order to create the Linux virtual network interfaces, an application
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) needs to tell to the Kernel what are the PIDs and the encapsulation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) types that are present on the transport stream. This is done through
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) ``/dev/dvb/adapter?/net?`` device node. The data will be available via
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) virtual ``dvb?_?`` network interfaces, and will be controlled/routed via
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) the standard ip tools (like ip, route, netstat, ifconfig, etc).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Data types and and ioctl definitions are defined via ``linux/dvb/net.h``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) header.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) .. _net_fcalls:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Digital TV net Function Calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) #############################
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) .. toctree::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) :maxdepth: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) net-types
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) net-add-if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) net-remove-if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) net-get-if