mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-17 15:25:52 +00:00
26a1ba5c14
Backed out changeset 84fb749698ab (bug 1323100) Backed out changeset d6d25e8bd001 (bug 1323100) Backed out changeset 1b0855bb0c38 (bug 1323100) Backed out changeset b6953e3f5739 (bug 1323100) Backed out changeset 5572f3b63215 (bug 1323100) Backed out changeset 12fb4c533659 (bug 1323100) Backed out changeset c36524e4e919 (bug 1323100) Backed out changeset 1e3b3eddbe26 (bug 1323100) Backed out changeset 061110f1ae12 (bug 1323100) Backed out changeset 413dbd31725b (bug 1323100) Backed out changeset 06550f7eca62 (bug 1323100) Backed out changeset 940933b13b36 (bug 1323100) Backed out changeset a6d75c1cd724 (bug 1323100) Backed out changeset 681cacbbaa3b (bug 1323100) Backed out changeset 3d53787293f6 (bug 1323100) Backed out changeset c0340dfe4766 (bug 1323100) Backed out changeset 9f554991549d (bug 1323100) Backed out changeset 757539e7039a (bug 1323100) Backed out changeset a3c9b45aa917 (bug 1323100) Backed out changeset 23d69df98a66 (bug 1323100) Backed out changeset 1297ded6a01d (bug 1323100) Backed out changeset f4235b97257f (bug 1323100) Backed out changeset 93419cb4f29f (bug 1323100) Backed out changeset 865d1b81c804 (bug 1323100) Backed out changeset 54acf4ef8e84 (bug 1323100) Backed out changeset 88d17bcd8205 (bug 1323100) Backed out changeset 0c466e5e8933 (bug 1323100) |
||
---|---|---|
.. | ||
build | ||
test | ||
testlib | ||
third_party | ||
common.build | ||
databuffer.h | ||
dtlsidentity.cpp | ||
dtlsidentity.h | ||
gonk_addrs.cpp | ||
logging.h | ||
m_cpp_utils.h | ||
moz.build | ||
nr_socket_prsock.cpp | ||
nr_socket_prsock.h | ||
nr_timer.cpp | ||
nricectx.cpp | ||
nricectx.h | ||
nricectxhandler.cpp | ||
nricectxhandler.h | ||
nricemediastream.cpp | ||
nricemediastream.h | ||
nriceresolver.cpp | ||
nriceresolver.h | ||
nriceresolverfake.cpp | ||
nriceresolverfake.h | ||
nrinterfaceprioritizer.cpp | ||
nrinterfaceprioritizer.h | ||
README | ||
rlogconnector.cpp | ||
rlogconnector.h | ||
runnable_utils.h | ||
sigslot.h | ||
simpletokenbucket.cpp | ||
simpletokenbucket.h | ||
stun_socket_filter.cpp | ||
stun_socket_filter.h | ||
test_nr_socket.cpp | ||
test_nr_socket.h | ||
transportflow.cpp | ||
transportflow.h | ||
transportlayer.cpp | ||
transportlayer.h | ||
transportlayerdtls.cpp | ||
transportlayerdtls.h | ||
transportlayerice.cpp | ||
transportlayerice.h | ||
transportlayerlog.cpp | ||
transportlayerlog.h | ||
transportlayerloopback.cpp | ||
transportlayerloopback.h | ||
transportlayerprsock.cpp | ||
transportlayerprsock.h |
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.