gecko-dev/media/mtransport
Nils Ohlmeier [:drno] 3fe5112bbb Bug 1345791: ICE disconnect state is not a crash. r=bwc
MozReview-Commit-ID: IwrWVvjkNmX

--HG--
extra : rebase_source : e9c4b92acddb82298b439152e622132a49bd6daa
2017-03-29 16:39:42 -05:00
..
build Bug 1345511 - pt 2 - add IPC mechanism for getting stun addrs on main process. r=bwc 2017-03-21 19:59:05 -05:00
ipc Bug 1350055 - fix --disable-webrtc build with new PStunAddrsRequest.ipdl r=jduell 2017-03-23 20:04:41 -05:00
test Bug 1345511 - pt 1 - nICEr changes to support stun addr gathering from main process. r=bwc 2017-03-16 12:06:09 -05:00
third_party Bug 964133 - move nICEr and nrappkit to libxul; r=ted.mielczarek 2017-01-13 09:28:43 -05:00
README
common.build Bug 1345511 - pt 2 - add IPC mechanism for getting stun addrs on main process. r=bwc 2017-03-21 19:59:05 -05:00
databuffer.h
dtlsidentity.cpp Bug 1337358 - Converts for(...; ...; ...) loops to use the new range-based loops in C++11 in media/mtransport/ r=bwc=jesup 2017-02-13 14:42:00 +01:00
dtlsidentity.h Bug 1323998 - Stop using Scoped.h NSS types in dtlsidentity.(cpp|h) and nricectx.cpp. r=mt 2016-12-21 22:09:10 +08:00
gonk_addrs.cpp
logging.h Bug 1219468: Remove the rest of the non-LazyLogModules in webrtc, except for cppunit tests r=erahm,ng 2017-01-27 23:35:17 -05:00
m_cpp_utils.h
moz.build Bug 1345511 - pt 2 - add IPC mechanism for getting stun addrs on main process. r=bwc 2017-03-21 19:59:05 -05:00
nr_socket_prsock.cpp Bug 1341374: ensure mtransport refcounting is happening on the same thread r=jesup 2017-02-23 21:57:50 -08:00
nr_socket_prsock.h Bug 1341374: ensure mtransport refcounting is happening on the same thread r=jesup 2017-02-23 21:57:50 -08:00
nr_timer.cpp Bug 1018486 - Part 9: Changes to account for modifications to clang plugin, r=ehsan 2016-09-07 10:50:47 -04:00
nricectx.cpp Bug 1345791: ICE disconnect state is not a crash. r=bwc 2017-03-29 16:39:42 -05:00
nricectx.h Bug 1345511 - pt 3 - start using IPC call for stun addrs in PCMedia. r=bwc 2017-03-22 09:59:46 -05:00
nricectxhandler.cpp Bug 1342523 - Part 1: Clean up how controlling/offerer is specified. r=drno 2017-02-24 14:05:27 -06:00
nricectxhandler.h Bug 1342523 - Part 1: Clean up how controlling/offerer is specified. r=drno 2017-02-24 14:05:27 -06:00
nricemediastream.cpp Bug 1337358 - Converts for(...; ...; ...) loops to use the new range-based loops in C++11 in media/mtransport/ r=bwc=jesup 2017-02-13 14:42:00 +01:00
nricemediastream.h Bug 929977: Add support for RFC 7675 ICE consent freshness. r=bwc,mt 2016-04-26 13:11:25 -07:00
nriceresolver.cpp Bug 1337893 - Part 4: Updating whole gecko to make all callers of DNS using correct originAttributes. r=baku 2017-02-15 10:39:40 +08:00
nriceresolver.h Bug 1231975 - Part 3: Break a reference cycle between PendingResolution and DNSRequestChild. r=drno 2016-04-07 13:12:54 -05:00
nriceresolverfake.cpp
nriceresolverfake.h
nricestunaddr.cpp Bug 1345511 - pt 2 - add IPC mechanism for getting stun addrs on main process. r=bwc 2017-03-21 19:59:05 -05:00
nricestunaddr.h Bug 1345511 - pt 2 - add IPC mechanism for getting stun addrs on main process. r=bwc 2017-03-21 19:59:05 -05:00
nrinterfaceprioritizer.cpp Bug 1337358 - Converts for(...; ...; ...) loops to use the new range-based loops in C++11 in media/mtransport/ r=bwc=jesup 2017-02-13 14:42:00 +01:00
nrinterfaceprioritizer.h
rlogconnector.cpp Bug 1309129: enable redirecting of nICEr logging to NSPR logging. r=bwc 2016-10-11 00:17:26 -07:00
rlogconnector.h Bug 1309129: enable redirecting of nICEr logging to NSPR logging. r=bwc 2016-10-11 00:17:26 -07:00
runnable_utils.h Bug 1287006 - Adjust media/ code to not pass Maybe (or any class containing a Maybe member) by value, only by reference or pointer. r=jw_wang, r=rjesup 2017-02-13 09:07:40 -08:00
sigslot.h
simpletokenbucket.cpp
simpletokenbucket.h
stun_socket_filter.cpp Bug 1244926: added TCP socket filter to only allow outgoing STUN. r=jesup 2016-02-11 01:18:46 -08:00
stun_socket_filter.h Bug 1244926: added TCP socket filter to only allow outgoing STUN. r=jesup 2016-02-11 01:18:46 -08:00
test_nr_socket.cpp Bug 1340734: Move the TLS detection logic to TestNrSocket::create, to keep up with changes from bug 1336507. r=drno 2017-02-17 17:31:55 -06:00
test_nr_socket.h Bug 1056934 - Part 2: Test-case for TURN TLS. r=drno 2017-01-03 12:28:13 -06:00
transportflow.cpp Bug 1337358 - Converts for(...; ...; ...) loops to use the new range-based loops in C++11 in media/mtransport/ r=bwc=jesup 2017-02-13 14:42:00 +01:00
transportflow.h Bug 1251714 - use UniquePtr instead of ScopedDeletePtr in media/; r=jesup 2016-03-02 15:28:27 -05:00
transportlayer.cpp Bug 1237909 part 1 - Remove unused TransportLayer::RunOnThread function. r=bwc 2016-01-25 14:52:34 +11:00
transportlayer.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00
transportlayerdtls.cpp Bug 1336182 - Part 1: Add DTLS handshake time telemetry. r=bsmedberg,drno 2017-02-03 17:01:05 -06:00
transportlayerdtls.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00
transportlayerice.cpp Bug 1264344 - Don't restart ICE on first CreateOffer call if iceRestart option is true. r=bwc 2016-04-13 11:41:05 -05:00
transportlayerice.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00
transportlayerlog.cpp Bug 1338086 - Remove useless else blocks in order to reduce complexity in media/mtransport/ r=drno 2017-02-14 15:08:29 +01:00
transportlayerlog.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00
transportlayerloopback.cpp Bug 1214269 - read multiple DTLS packets from NSS if present. r=mt r=jesup 2015-11-03 17:21:35 -08:00
transportlayerloopback.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00
transportlayerprsock.cpp
transportlayerprsock.h Bug 1336182 - Part 2: Use "override" keyword to silence some warnings about inconsistency. r=drno 2017-02-06 16:44:14 -06:00

README

This is a generic media transport system for WebRTC.

The basic model is that you have a TransportFlow which contains a
series of TransportLayers, each of which gets an opportunity to
manipulate data up and down the stack (think SysV STREAMS or a
standard networking stack). You can also address individual
sublayers to manipulate them or to bypass reading and writing
at an upper layer; WebRTC uses this to implement DTLS-SRTP.


DATAFLOW MODEL
Unlike the existing nsSocket I/O system, this is a push rather
than a pull system. Clients of the interface do writes downward
with SendPacket() and receive notification of incoming packets
via callbacks registed via sigslot.h. It is the responsibility
of the bottom layer (or any other layer which needs to reference
external events) to arrange for that somehow; typically by
using nsITimer or the SocketTansportService.

This sort of push model is a much better fit for the demands
of WebRTC, expecially because ICE contexts span multiple
network transports.


THREADING MODEL
There are no thread locks. It is the responsibility of the caller to
arrange that any given TransportLayer/TransportFlow is only
manipulated in one thread at once. One good way to do this is to run
everything on the STS thread. Many of the existing layer implementations
(TransportLayerPrsock, TransportLayerIce, TransportLayerLoopback)
already run on STS so in those cases you must run on STS, though
you can do setup on the main thread and then activate them on the
STS.


EXISTING TRANSPORT LAYERS
The following transport layers are currently implemented:

* DTLS -- a wrapper around NSS's DTLS [RFC 6347] stack
* ICE  -- a wrapper around the nICEr ICE [RFC 5245] stack.
* Prsock -- a wrapper around NSPR sockets
* Loopback -- a loopback IO mechanism
* Logging -- a passthrough that just logs its data

The last three are primarily for debugging.