gecko/media/mtransport
Doug Turner eed5eff3b9 Backout c9831bed6bb7 - Bug 818843 - This change broke building B2G on the mac. r=me
--HG--
extra : rebase_source : 7bef8dc1c394d45302f17379ab2cbd90ecda6975
2013-01-07 08:48:24 -08:00
..
build Bug 752657: backout sigslot multithreaded due to deadlocks rs=jesup 2012-12-11 12:54:24 -05:00
standalone Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
test Backout c9831bed6bb7 - Bug 818843 - This change broke building B2G on the mac. r=me 2013-01-07 08:48:24 -08:00
third_party Backout c9831bed6bb7 - Bug 818843 - This change broke building B2G on the mac. r=me 2013-01-07 08:48:24 -08:00
databuffer.h Bug 820102 - Clean up MediaPipeline threading (re-land after fix). r=derf,jesup 2012-12-21 06:03:22 -08:00
dtlsidentity.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
dtlsidentity.h Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
logging.h Bug 809950 - fix mtransport logging macros to not introduce static initializers; r=jesup 2012-11-08 13:44:41 -05:00
m_cpp_utils.h Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
nr_socket_prsock.cpp Backed out 2 changesets (bug 579517) 2012-10-25 12:32:24 -04:00
nr_socket_prsock.h Bug 783205 - Networking Dashboard. r=mcmanus, r=jorendorff, sr=biesi 2012-12-10 09:13:55 -05:00
nr_timer.cpp Bug 827029 - Clean up license boilerplate in mtransport. r=jesup 2013-01-05 14:58:59 -08:00
nricectx.cpp Bug 817430: Set initial controlled/controlling values, based on inbound T/F. r=jesup 2012-12-02 13:49:56 -08:00
nricectx.h Bug 817430: Set initial controlled/controlling values, based on inbound T/F. r=jesup 2012-12-02 13:49:56 -08:00
nricemediastream.cpp Bug 822159 - Fix trickle ICE to start checking when new candidates come in. r=abr 2012-12-20 08:12:45 -08:00
nricemediastream.h Bug 827029 - Clean up license boilerplate in mtransport. r=jesup 2013-01-05 14:58:59 -08:00
objs.mk Bug 816822 - Fix build files, unit tests, and clone some linux headers to make WebRTC unit tests build on Android, r=dmose,ted 2012-12-12 12:05:57 -08:00
README Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
runnable_utils_generated.h Bug 815039, Add template to bind non-member function calls into runnables. r=jesup 2012-12-02 16:53:47 -08:00
runnable_utils.h Bug 824851: Fixed RUN_ON_THREAD to not dispatch on own thread. r=ekr 2012-12-28 15:42:53 -05:00
runnable_utils.py Bug 815039, Add template to bind non-member function calls into runnables. r=jesup 2012-12-02 16:53:47 -08:00
sigslot.h Bug 752657: backout sigslot multithreaded due to deadlocks rs=jesup 2012-12-11 12:54:24 -05:00
transportflow.cpp Bug 801221: Move mtransport operations onto STS thread; r=jesup 2012-10-18 13:01:52 -07:00
transportflow.h Bug 801221: Move mtransport operations onto STS thread; r=jesup 2012-10-18 13:01:52 -07:00
transportlayer.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
transportlayer.h Bug 801221: Move mtransport operations onto STS thread; r=jesup 2012-10-18 13:01:52 -07:00
transportlayerdtls.cpp Bug 817451, Correctly set mRole in PC unit tests. r=ehugg 2012-12-02 18:06:21 -08:00
transportlayerdtls.h Bug 801221: Move mtransport operations onto STS thread; r=jesup 2012-10-18 13:01:52 -07:00
transportlayerice.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
transportlayerice.h Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
transportlayerlog.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
transportlayerlog.h Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
transportlayerloopback.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
transportlayerloopback.h Bug 790517: mtransport - Generic media transport subsystem for ICE and DTLS r=jesup,bsmith,mcmanus 2012-10-02 13:04:58 -07:00
transportlayerprsock.cpp Bug 812278: Remove no-longer-necessary semicolons after MOZ_MTLOG_MODULE macro invocations, to fix GCC pedantic build warnings. r=jesup 2012-11-15 17:50:26 -08:00
transportlayerprsock.h Bug 783205 - Networking Dashboard. r=mcmanus, r=jorendorff, sr=biesi 2012-12-10 09:13:55 -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.