mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
9432818a46
Backed out changeset d68dcf2ef372 (bug 1165515) Backed out changeset 7c3b45a47811 (bug 1165515) Backed out changeset b668b617bef2 (bug 1165515) Backed out changeset d0916e1283a2 (bug 1165515) Backed out changeset ac4dc7489942 (bug 1165515) Backed out changeset e9632ce8bc65 (bug 1165515) Backed out changeset c16d215cc7e4 (bug 1165515) Backed out changeset e4d474f3c51a (bug 1165515) Backed out changeset d87680bf9f7c (bug 1165515) Backed out changeset b3c0a45ba99e (bug 1165515) Backed out changeset 9370fa197674 (bug 1165515) Backed out changeset 50970d668ca1 (bug 1165515) Backed out changeset ffa4eb6d24b9 (bug 1165515) Backed out changeset 5fcf1203cc1d (bug 1165515) |
||
---|---|---|
.. | ||
build | ||
standalone | ||
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 | ||
nricemediastream.cpp | ||
nricemediastream.h | ||
nriceresolver.cpp | ||
nriceresolver.h | ||
nriceresolverfake.cpp | ||
nriceresolverfake.h | ||
nrinterfaceprioritizer.cpp | ||
nrinterfaceprioritizer.h | ||
README | ||
rlogringbuffer.cpp | ||
rlogringbuffer.h | ||
runnable_utils_generated.h | ||
runnable_utils.h | ||
runnable_utils.py | ||
sigslot.h | ||
simpletokenbucket.cpp | ||
simpletokenbucket.h | ||
stun_udp_socket_filter.cpp | ||
stun_udp_socket_filter.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.