gecko-dev/media/mtransport
Byron Campen [:bwc] 2c929c882f Bug 842549 - Part 4: Small fix from ekr to disarm the trickle_cb when the ICE ctx is destroyed. r=abr 2013-09-19 16:08:28 -07:00
..
build Bug 865673 - Convert objs.mk to objs.mozbuild. r=gps 2013-08-30 09:09:06 -04:00
standalone Bug 865673 - Convert objs.mk to objs.mozbuild. r=gps 2013-08-30 09:09:06 -04:00
test Bug 842549 - Part 1: Generate trickle candidates from nICEr, with testing r=abr 2013-09-19 09:17:52 -07:00
third_party Bug 842549 - Part 4: Small fix from ekr to disarm the trickle_cb when the ICE ctx is destroyed. r=abr 2013-09-19 16:08:28 -07: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
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 889615 - Add Granular logging to Mediapipeline. r=abr 2013-07-03 11:40:36 -07: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
gonk_addrs.cpp Bug 825708 - Part 1: use nr_local_addr in nr_stun_get_addrs and provide interface type/estimated speed/vpn information for Linux and B2G. r=abr 2013-08-28 15:27:06 +08:00
logging.h Bug 889615 - Add Granular logging to Mediapipeline. r=abr 2013-07-03 11:40:36 -07: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 Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
nr_socket_prsock.h Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
nr_timer.cpp Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
nricectx.cpp Bug 842549 - Part 1: Generate trickle candidates from nICEr, with testing r=abr 2013-09-19 09:17:52 -07:00
nricectx.h Bug 842549 - Part 1: Generate trickle candidates from nICEr, with testing r=abr 2013-09-19 09:17:52 -07:00
nricemediastream.cpp Bug 842549 - Part 1: Generate trickle candidates from nICEr, with testing r=abr 2013-09-19 09:17:52 -07:00
nricemediastream.h Bug 842549 - Part 1: Generate trickle candidates from nICEr, with testing r=abr 2013-09-19 09:17:52 -07:00
nriceresolver.cpp Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
nriceresolver.h Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
nriceresolverfake.cpp Bug 843644 - DNS resolution for STUN servers. r=abr 2013-02-21 08:52:30 -08:00
nriceresolverfake.h Bug 843644 - DNS resolution for STUN servers. r=abr 2013-02-21 08:52:30 -08:00
nrinterfaceprioritizer.cpp Bug 825708 - Part 2: calculate priority using properties. r=ekr 2013-08-28 15:27:14 +08:00
nrinterfaceprioritizer.h Bug 825708 - Part 2: calculate priority using properties. r=ekr 2013-08-28 15:27:14 +08:00
objs.mozbuild Bug 865673 - Convert objs.mk to objs.mozbuild. r=gps 2013-08-30 09:09:06 -04:00
runnable_utils.h Bug 854085. Make thread asserts conditional on DEBUG not MOZ_DEBUG. r=jesup 2013-04-16 13:13:09 -07:00
runnable_utils.py Assert on WrapRunnableRet with NS_DISPATCH_NORMAL 2013-03-04 08:51:48 -08:00
runnable_utils_generated.h Assert on WrapRunnableRet with NS_DISPATCH_NORMAL 2013-03-04 08:51:48 -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 889615 - Add Granular logging to Mediapipeline. r=abr 2013-07-03 11:40:36 -07:00
transportflow.h Bug 913847 - stop needlessly including nsThreadUtils.h - r=ehsan 2013-09-19 09:54:39 -04:00
transportlayer.cpp Bug 913847 - stop needlessly including nsThreadUtils.h - r=ehsan 2013-09-19 09:54:39 -04:00
transportlayer.h Bug 913847 - stop needlessly including nsThreadUtils.h - r=ehsan 2013-09-19 09:54:39 -04:00
transportlayerdtls.cpp Bug 823338 - Fix incorrect check for OOM conditions in TransportLayerDtls::GetClientAuthDataHook(). r=ekr 2013-07-24 09:05:55 -04:00
transportlayerdtls.h Bug 835692: Convert TransportLayerDtls::kMaxDigestLength to be a size_t, since that's how it's used & what it's compared to. r=ekr 2013-01-29 09:01:10 -08:00
transportlayerice.cpp Bug 889615 - Add Granular logging to Mediapipeline. r=abr 2013-07-03 11:40:36 -07: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 889615 - Add Granular logging to Mediapipeline. r=abr 2013-07-03 11:40:36 -07: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 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
transportlayerloopback.h Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
transportlayerprsock.cpp Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05:00
transportlayerprsock.h Bug 884061 - Part 3o: Use NS_DECL_THREADSAFE_ISUPPORTS in media/, r=abr 2013-07-18 21:23:32 -05: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.