gecko-dev/media/mtransport
2015-02-21 10:35:21 +13:00
..
build Bug 806819 - Part 4: Add files that were excluded from unified builds back in. r=ehsan 2014-10-08 13:19:14 -07:00
standalone Bug 806819 - Part 4: Add files that were excluded from unified builds back in. r=ehsan 2014-10-08 13:19:14 -07:00
test Bug 1017888 - Part 2: Testing for renegotiation. r=mt, r=drno 2015-02-10 10:17:03 -08:00
third_party Bug 1017888 - Part 1: Renegotiation support. r=mt, r=smaug 2014-12-10 15:53:54 -08:00
databuffer.h Bug 1028582 - Modify TransportLayerDtls to force a fresh ECDHE server key. r=mt 2014-08-05 09:06:48 -07:00
dtlsidentity.cpp Bug 1091242 - Part 6: Wiring the new JSEP handler code in. See https://github.com/unicorn-wg/gecko-dev/tree/multistream_rebase for more history. r=jesup, r=smaug 2014-11-19 16:16:29 -08:00
dtlsidentity.h Bug 1091242 - Part 6: Wiring the new JSEP handler code in. See https://github.com/unicorn-wg/gecko-dev/tree/multistream_rebase for more history. r=jesup, r=smaug 2014-11-19 16:16:29 -08:00
gonk_addrs.cpp Bug 978709 - 4.h/6: NetworkInterfaceListService changes. r=vicamo 2014-03-29 15:18:25 +08:00
logging.h Bug 1091242 - Part 6: Wiring the new JSEP handler code in. See https://github.com/unicorn-wg/gecko-dev/tree/multistream_rebase for more history. r=jesup, r=smaug 2014-11-19 16:16:29 -08:00
m_cpp_utils.h Bug 1118486 - Part 1: Use = delete instead of MOZ_DELETE directly; r=Waldo 2015-01-08 23:19:05 -05:00
nr_socket_prsock.cpp Bug 1099414: Ensure that NrSocketIpc is destroyed on STS, for consistency. r=ekr 2014-12-23 16:22:02 -08:00
nr_socket_prsock.h Bug 1099414: Ensure that NrSocketIpc is destroyed on STS, for consistency. r=ekr 2014-12-23 16:22:02 -08:00
nr_timer.cpp Bug 900908 - Part 3: Change uses of numbered macros in nsIClassInfoImpl.h/nsISupportsImpl.h to the variadic variants. r=froydnj 2014-04-27 03:06:00 -04:00
nricectx.cpp Bug 1017888 - Part 1: Renegotiation support. r=mt, r=smaug 2014-12-10 15:53:54 -08:00
nricectx.h Bug 1017888 - Part 1: Renegotiation support. r=mt, r=smaug 2014-12-10 15:53:54 -08:00
nricemediastream.cpp Bug 1017888 - Part 1: Renegotiation support. r=mt, r=smaug 2014-12-10 15:53:54 -08:00
nricemediastream.h Bug 1017888 - Part 1: Renegotiation support. r=mt, r=smaug 2014-12-10 15:53:54 -08:00
nriceresolver.cpp Bug 900908 - Part 3: Change uses of numbered macros in nsIClassInfoImpl.h/nsISupportsImpl.h to the variadic variants. r=froydnj 2014-04-27 03:06:00 -04:00
nriceresolver.h Bug 1119267 - Mark virtual overridden functions as MOZ_OVERRIDE in media; r=jesup 2015-01-08 23:10:52 -05:00
nriceresolverfake.cpp
nriceresolverfake.h Bug 1120062 - Part 1: Remove most Nullptr.h includes. r=waldo 2015-01-11 11:34:52 +09:00
nrinterfaceprioritizer.cpp
nrinterfaceprioritizer.h
objs.mozbuild
README
rlogringbuffer.cpp Bug 1120062 - Part 1: Remove most Nullptr.h includes. r=waldo 2015-01-11 11:34:52 +09:00
rlogringbuffer.h
runnable_utils_generated.h Bug 1053792 - Fix some bad implicit constructors in the mtransport code; r=jesup 2014-08-15 17:41:29 -04:00
runnable_utils.h Bug 1099414: Ensure that NrSocketIpc is destroyed on STS, for consistency. r=ekr 2014-12-23 16:22:02 -08:00
runnable_utils.py Bug 1053792 - Fix some bad implicit constructors in the mtransport code; r=jesup 2014-08-15 17:41:29 -04:00
sigslot.h Bug 1053792 - Fix some bad implicit constructors in the mtransport code; r=jesup 2014-08-15 17:41:29 -04:00
simpletokenbucket.cpp
simpletokenbucket.h
stun_udp_socket_filter.cpp Bug 1053792 - Fix some bad implicit constructors in the mtransport code; r=jesup 2014-08-15 17:41:29 -04:00
stun_udp_socket_filter.h Bug 1028588 - Fix dangerous public destructors in media/mtransport - r=abr 2014-06-24 12:36:44 -04:00
transportflow.cpp Bug 967364: Pass already_AddRefed by reference instead of by value. r=bsmedberg 2014-03-15 12:00:17 -07:00
transportflow.h bug 1105074 - make more stuff final r=froydnj 2014-11-25 13:56:07 -05:00
transportlayer.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayer.h Bug 1127201 (attempt 2, part 1) - Replace most NS_ABORT_IF_FALSE calls with MOZ_ASSERT. r=Waldo. 2015-02-09 14:34:50 -08:00
transportlayerdtls.cpp Bug 1132813 - Enabling DTLS 1.2 for WebRTC, r=abr 2015-02-21 10:35:21 +13:00
transportlayerdtls.h bug 1105074 - make more stuff final r=froydnj 2014-11-25 13:56:07 -05:00
transportlayerice.cpp Bug 1091242 - Part 6: Wiring the new JSEP handler code in. See https://github.com/unicorn-wg/gecko-dev/tree/multistream_rebase for more history. r=jesup, r=smaug 2014-11-19 16:16:29 -08:00
transportlayerice.h Bug 1091242 - Part 6: Wiring the new JSEP handler code in. See https://github.com/unicorn-wg/gecko-dev/tree/multistream_rebase for more history. r=jesup, r=smaug 2014-11-19 16:16:29 -08:00
transportlayerlog.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerlog.h
transportlayerloopback.cpp Bug 900908 - Part 3: Change uses of numbered macros in nsIClassInfoImpl.h/nsISupportsImpl.h to the variadic variants. r=froydnj 2014-04-27 03:06:00 -04:00
transportlayerloopback.h Bug 1053792 - Fix some bad implicit constructors in the mtransport code; r=jesup 2014-08-15 17:41:29 -04:00
transportlayerprsock.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerprsock.h Bug 1119267 - Mark virtual overridden functions as MOZ_OVERRIDE in media; r=jesup 2015-01-08 23:10:52 -05:00

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.