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