1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
254f38fcaSMauro Carvalho Chehab
354f38fcaSMauro Carvalho Chehab.. _net:
454f38fcaSMauro Carvalho Chehab
554f38fcaSMauro Carvalho Chehab######################
654f38fcaSMauro Carvalho ChehabDigital TV Network API
754f38fcaSMauro Carvalho Chehab######################
854f38fcaSMauro Carvalho Chehab
954f38fcaSMauro Carvalho ChehabThe Digital TV net device controls the mapping of data packages that are part
1054f38fcaSMauro Carvalho Chehabof a transport stream to be mapped into a virtual network interface,
1154f38fcaSMauro Carvalho Chehabvisible through the standard Linux network protocol stack.
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho ChehabCurrently, two encapsulations are supported:
1454f38fcaSMauro Carvalho Chehab
1554f38fcaSMauro Carvalho Chehab-  `Multi Protocol Encapsulation (MPE) <http://en.wikipedia.org/wiki/Multiprotocol_Encapsulation>`__
1654f38fcaSMauro Carvalho Chehab
1754f38fcaSMauro Carvalho Chehab-  `Ultra Lightweight Encapsulation (ULE) <http://en.wikipedia.org/wiki/Unidirectional_Lightweight_Encapsulation>`__
1854f38fcaSMauro Carvalho Chehab
1954f38fcaSMauro Carvalho ChehabIn order to create the Linux virtual network interfaces, an application
2054f38fcaSMauro Carvalho Chehabneeds to tell to the Kernel what are the PIDs and the encapsulation
2154f38fcaSMauro Carvalho Chehabtypes that are present on the transport stream. This is done through
2254f38fcaSMauro Carvalho Chehab``/dev/dvb/adapter?/net?`` device node. The data will be available via
2354f38fcaSMauro Carvalho Chehabvirtual ``dvb?_?`` network interfaces, and will be controlled/routed via
2454f38fcaSMauro Carvalho Chehabthe standard ip tools (like ip, route, netstat, ifconfig, etc).
2554f38fcaSMauro Carvalho Chehab
26*fbb89ee6SRandy DunlapData types and ioctl definitions are defined via ``linux/dvb/net.h``
2754f38fcaSMauro Carvalho Chehabheader.
2854f38fcaSMauro Carvalho Chehab
2954f38fcaSMauro Carvalho Chehab
3054f38fcaSMauro Carvalho Chehab.. _net_fcalls:
3154f38fcaSMauro Carvalho Chehab
3254f38fcaSMauro Carvalho ChehabDigital TV net Function Calls
3354f38fcaSMauro Carvalho Chehab#############################
3454f38fcaSMauro Carvalho Chehab
3554f38fcaSMauro Carvalho Chehab.. toctree::
3654f38fcaSMauro Carvalho Chehab    :maxdepth: 1
3754f38fcaSMauro Carvalho Chehab
3854f38fcaSMauro Carvalho Chehab    net-types
3954f38fcaSMauro Carvalho Chehab    net-add-if
4054f38fcaSMauro Carvalho Chehab    net-remove-if
4154f38fcaSMauro Carvalho Chehab    net-get-if
42