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