gecko/media/mtransport
2014-01-27 11:02:51 -05:00
..
build Bug 896704 - Remove the MSVC exemption for FAIL_ON_WARNINGS in media/mtransport. r=abr 2013-12-05 21:41:04 +09:00
standalone Bug 942043 - Straighten up zlib linkage wrt shared js and system zlib. r=gps,r=ted 2013-11-22 23:03:21 +09:00
test Bug 928930 - don't define std::string variables in nricectx.h; r=ekr 2014-01-27 11:02:51 -05:00
third_party Backed out changeset ce887b471785 (bug 961313) for buffered_stun_socket_unittest crashes, again. 2014-01-27 09:41:48 -05:00
databuffer.h Bug 916187. Part 2. Using the test stun server, write some tests to exercise the checking logic written in 908740. r=abr 2013-09-18 12:36:13 -07:00
dtlsidentity.cpp Bug 946348 - Refactor fingerprint handling. r=abr 2014-01-02 10:50:14 -05:00
dtlsidentity.h Bug 946348 - Refactor fingerprint handling. r=abr 2014-01-02 10:50:14 -05:00
gonk_addrs.cpp
logging.h Bug 942462 - Fix type in media/mtransport/logging.h. r=ekr 2013-11-25 09:23:45 -05:00
m_cpp_utils.h
nr_socket_prsock.cpp Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nr_socket_prsock.h Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nr_timer.cpp
nricectx.cpp Bug 928930 - don't define std::string variables in nricectx.h; r=ekr 2014-01-27 11:02:51 -05:00
nricectx.h Bug 928930 - don't define std::string variables in nricectx.h; r=ekr 2014-01-27 11:02:51 -05:00
nricemediastream.cpp Bug 906990: Part 13. Get local/remote candidates separately, instead of grabbing them from candidate pairs (means we can get candidates before pairing happens). r=ekr 2013-11-13 13:49:33 -08:00
nricemediastream.h Bug 906990: Part 13. Get local/remote candidates separately, instead of grabbing them from candidate pairs (means we can get candidates before pairing happens). r=ekr 2013-11-13 13:49:33 -08:00
nriceresolver.cpp Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nriceresolver.h Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nriceresolverfake.cpp Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nriceresolverfake.h Bug 906968 - Add support for TURN TCP. r=abr 2013-12-06 10:20:19 -08:00
nrinterfaceprioritizer.cpp
nrinterfaceprioritizer.h
objs.mozbuild Bug 870660: Part 2: Implement socket filter for STUN. r=ekr 2013-11-30 00:15:26 +08:00
README
rlogringbuffer.cpp Bug 934317: Mutex-protect the RLogRingBuffer, since more than one thread is using it. r=jesup 2013-11-04 15:39:51 -08:00
rlogringbuffer.h Bug 934317: Mutex-protect the RLogRingBuffer, since more than one thread is using it. r=jesup 2013-11-04 15:39:51 -08:00
runnable_utils_generated.h
runnable_utils.h
runnable_utils.py
sigslot.h Bug 932420: sigslot.h - #ifdef'ed out unused multi-threading to avoid windows.h, r=jesup 2013-10-29 19:49:34 -04:00
simpletokenbucket.cpp Bug 931186 - Dirt simple token bucket class. r=ekr 2013-10-25 15:15:59 -07:00
simpletokenbucket.h Bug 931186 - Dirt simple token bucket class. r=ekr 2013-10-25 15:15:59 -07:00
stun_udp_socket_filter.cpp Bug 870660: Part 2: Implement socket filter for STUN. r=ekr 2013-11-30 00:15:26 +08:00
stun_udp_socket_filter.h Bug 870660: Part 2: Implement socket filter for STUN. r=ekr 2013-11-30 00:15:26 +08:00
transportflow.cpp
transportflow.h Bug 913847 - stop needlessly including nsThreadUtils.h - r=ehsan 2013-09-19 09:54:39 -04:00
transportlayer.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayer.h Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerdtls.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerdtls.h
transportlayerice.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerice.h
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 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerloopback.h
transportlayerprsock.cpp Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06:00
transportlayerprsock.h Bug 930481: Improved failure instrumentation for transport layers r=ekr 2014-01-23 14:21:24 -06: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.