Index: webrtc/test/channel_transport/udp_transport.h |
diff --git a/webrtc/test/channel_transport/udp_transport.h b/webrtc/test/channel_transport/udp_transport.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..0c5079e69ff01803c491bd80d237657468bf8ef8 |
--- /dev/null |
+++ b/webrtc/test/channel_transport/udp_transport.h |
@@ -0,0 +1,381 @@ |
+/* |
+ * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
+ * |
+ * Use of this source code is governed by a BSD-style license |
+ * that can be found in the LICENSE file in the root of the source |
+ * tree. An additional intellectual property rights grant can be found |
+ * in the file PATENTS. All contributing project authors may |
+ * be found in the AUTHORS file in the root of the source tree. |
+ */ |
+ |
+#ifndef WEBRTC_TEST_CHANNEL_TRANSPORT_UDP_TRANSPORT_H_ |
+#define WEBRTC_TEST_CHANNEL_TRANSPORT_UDP_TRANSPORT_H_ |
+ |
+#include "webrtc/common_types.h" |
+#include "webrtc/transport.h" |
+#include "webrtc/typedefs.h" |
+ |
+/* |
+ * WARNING |
+ * This code is not use in production/testing and might have security issues |
+ * for example: http://code.google.com/p/webrtc/issues/detail?id=1028 |
+ * |
+ */ |
+ |
+#define SS_MAXSIZE 128 |
+#define SS_ALIGNSIZE (sizeof (uint64_t)) |
+#define SS_PAD1SIZE (SS_ALIGNSIZE - sizeof(int16_t)) |
+#define SS_PAD2SIZE (SS_MAXSIZE - (sizeof(int16_t) + SS_PAD1SIZE +\ |
+ SS_ALIGNSIZE)) |
+ |
+// BSD requires use of HAVE_STRUCT_SOCKADDR_SA_LEN |
+namespace webrtc { |
+namespace test { |
+ |
+struct SocketAddressIn { |
+ // sin_family should be either AF_INET (IPv4) or AF_INET6 (IPv6) |
+#ifdef HAVE_STRUCT_SOCKADDR_SA_LEN |
+ int8_t sin_length; |
+ int8_t sin_family; |
+#else |
+ int16_t sin_family; |
+#endif |
+ uint16_t sin_port; |
+ uint32_t sin_addr; |
+ int8_t sin_zero[8]; |
+}; |
+ |
+struct Version6InAddress { |
+ union { |
+ uint8_t _s6_u8[16]; |
+ uint32_t _s6_u32[4]; |
+ uint64_t _s6_u64[2]; |
+ } Version6AddressUnion; |
+}; |
+ |
+struct SocketAddressInVersion6 { |
+ // sin_family should be either AF_INET (IPv4) or AF_INET6 (IPv6) |
+#ifdef HAVE_STRUCT_SOCKADDR_SA_LEN |
+ int8_t sin_length; |
+ int8_t sin_family; |
+#else |
+ int16_t sin_family; |
+#endif |
+ // Transport layer port number. |
+ uint16_t sin6_port; |
+ // IPv6 traffic class and flow info or ip4 address. |
+ uint32_t sin6_flowinfo; |
+ // IPv6 address |
+ struct Version6InAddress sin6_addr; |
+ // Set of interfaces for a scope. |
+ uint32_t sin6_scope_id; |
+}; |
+ |
+struct SocketAddressStorage { |
+ // sin_family should be either AF_INET (IPv4) or AF_INET6 (IPv6) |
+#ifdef HAVE_STRUCT_SOCKADDR_SA_LEN |
+ int8_t sin_length; |
+ int8_t sin_family; |
+#else |
+ int16_t sin_family; |
+#endif |
+ int8_t __ss_pad1[SS_PAD1SIZE]; |
+ uint64_t __ss_align; |
+ int8_t __ss_pad2[SS_PAD2SIZE]; |
+}; |
+ |
+struct SocketAddress { |
+ union { |
+ struct SocketAddressIn _sockaddr_in; |
+ struct SocketAddressInVersion6 _sockaddr_in6; |
+ struct SocketAddressStorage _sockaddr_storage; |
+ }; |
+}; |
+ |
+// Callback class that receives packets from UdpTransport. |
+class UdpTransportData { |
+ public: |
+ virtual ~UdpTransportData() {}; |
+ |
+ virtual void IncomingRTPPacket(const int8_t* incomingRtpPacket, |
+ const size_t rtpPacketLength, |
+ const char* fromIP, |
+ const uint16_t fromPort) = 0; |
+ |
+ virtual void IncomingRTCPPacket(const int8_t* incomingRtcpPacket, |
+ const size_t rtcpPacketLength, |
+ const char* fromIP, |
+ const uint16_t fromPort) = 0; |
+}; |
+ |
+class UdpTransport : public Transport { |
+ public: |
+ enum |
+ { |
+ kIpAddressVersion6Length = 64, |
+ kIpAddressVersion4Length = 16 |
+ }; |
+ enum ErrorCode |
+ { |
+ kNoSocketError = 0, |
+ kFailedToBindPort = 1, |
+ kIpAddressInvalid = 2, |
+ kAddressInvalid = 3, |
+ kSocketInvalid = 4, |
+ kPortInvalid = 5, |
+ kTosInvalid = 6, |
+ kMulticastAddressInvalid = 7, |
+ kQosError = 8, |
+ kSocketAlreadyInitialized = 9, |
+ kIpVersion6Error = 10, |
+ FILTER_ERROR = 11, |
+ kStartReceiveError = 12, |
+ kStopReceiveError = 13, |
+ kCannotFindLocalIp = 14, |
+ kTosError = 16, |
+ kNotInitialized = 17, |
+ kPcpError = 18 |
+ }; |
+ |
+ // Factory method. Constructor disabled. |
+ static UdpTransport* Create(const int32_t id, uint8_t& numSocketThreads); |
+ static void Destroy(UdpTransport* module); |
+ |
+ // Prepares the class for sending RTP packets to ipAddr:rtpPort and RTCP |
+ // packets to ipAddr:rtpPort+1 if rtcpPort is zero. Otherwise to |
+ // ipAddr:rtcpPort. |
+ virtual int32_t InitializeSendSockets(const char* ipAddr, |
+ const uint16_t rtpPort, |
+ const uint16_t rtcpPort = 0) = 0; |
+ |
+ // Register packetCallback for receiving incoming packets. Set the local |
+ // RTP port to rtpPort. Bind local IP address to ipAddr. If ipAddr is NULL |
+ // bind to local IP ANY. Set the local rtcp port to rtcpPort or rtpPort + 1 |
+ // if rtcpPort is 0. |
+ virtual int32_t InitializeReceiveSockets( |
+ UdpTransportData* const packetCallback, |
+ const uint16_t rtpPort, |
+ const char* ipAddr = NULL, |
+ const char* multicastIpAddr = NULL, |
+ const uint16_t rtcpPort = 0) = 0; |
+ |
+ // Set local RTP port to rtpPort and RTCP port to rtcpPort or rtpPort + 1 if |
+ // rtcpPort is 0. These ports will be used for sending instead of the local |
+ // ports set by InitializeReceiveSockets(..). |
+ virtual int32_t InitializeSourcePorts(const uint16_t rtpPort, |
+ const uint16_t rtcpPort = 0) = 0; |
+ |
+ // Retrieve local ports used for sending if other than the ports specified |
+ // by InitializeReceiveSockets(..). rtpPort is set to the RTP port. |
+ // rtcpPort is set to the RTCP port. |
+ virtual int32_t SourcePorts(uint16_t& rtpPort, |
+ uint16_t& rtcpPort) const = 0; |
+ |
+ // Set ipAddr to the IP address that is currently being listened on. rtpPort |
+ // to the RTP port listened to. rtcpPort to the RTCP port listened on. |
+ // multicastIpAddr to the multicast IP address group joined (the address |
+ // is NULL terminated). |
+ virtual int32_t ReceiveSocketInformation( |
+ char ipAddr[kIpAddressVersion6Length], |
+ uint16_t& rtpPort, |
+ uint16_t& rtcpPort, |
+ char multicastIpAddr[kIpAddressVersion6Length]) const = 0; |
+ |
+ // Set ipAddr to the IP address being sent from. rtpPort to the local RTP |
+ // port used for sending and rtcpPort to the local RTCP port used for |
+ // sending. |
+ virtual int32_t SendSocketInformation(char ipAddr[kIpAddressVersion6Length], |
+ uint16_t& rtpPort, |
+ uint16_t& rtcpPort) const = 0; |
+ |
+ // Put the IP address, RTP port and RTCP port from the last received packet |
+ // into ipAddr, rtpPort and rtcpPort respectively. |
+ virtual int32_t RemoteSocketInformation( |
+ char ipAddr[kIpAddressVersion6Length], |
+ uint16_t& rtpPort, |
+ uint16_t& rtcpPort) const = 0; |
+ |
+ // Enable/disable quality of service if QoS is true or false respectively. |
+ // Set the type of service to serviceType, max bitrate in kbit/s to |
+ // maxBitrate and override DSCP if overrideDSCP is not 0. |
+ // Note: Must be called both InitializeSendSockets() and |
+ // InitializeReceiveSockets() has been called. |
+ virtual int32_t SetQoS(const bool QoS, |
+ const int32_t serviceType, |
+ const uint32_t maxBitrate = 0, |
+ const int32_t overrideDSCP = 0, |
+ const bool audio = false) = 0; |
+ |
+ // Set QoS to true if quality of service has been turned on. If QoS is true, |
+ // also set serviceType to type of service and overrideDSCP to override |
+ // DSCP. |
+ virtual int32_t QoS(bool& QoS, |
+ int32_t& serviceType, |
+ int32_t& overrideDSCP) const = 0; |
+ |
+ // Set type of service. |
+ virtual int32_t SetToS(const int32_t DSCP, |
+ const bool useSetSockOpt = false) = 0; |
+ |
+ // Get type of service configuration. |
+ virtual int32_t ToS(int32_t& DSCP, |
+ bool& useSetSockOpt) const = 0; |
+ |
+ // Set Priority Code Point (IEEE 802.1Q) |
+ // Note: for Linux this function will set the priority for the socket, |
+ // which then can be mapped to a PCP value with vconfig. |
+ virtual int32_t SetPCP(const int32_t PCP) = 0; |
+ |
+ // Get Priority Code Point |
+ virtual int32_t PCP(int32_t& PCP) const = 0; |
+ |
+ // Enable IPv6. |
+ // Note: this API must be called before any call to |
+ // InitializeReceiveSockets() or InitializeSendSockets(). It is not |
+ // possible to go back to IPv4 (default) after this call. |
+ virtual int32_t EnableIpV6() = 0; |
+ |
+ // Return true if IPv6 has been enabled. |
+ virtual bool IpV6Enabled() const = 0; |
+ |
+ // Only allow packets received from filterIPAddress to be processed. |
+ // Note: must be called after EnableIPv6(), if IPv6 is used. |
+ virtual int32_t SetFilterIP( |
+ const char filterIPAddress[kIpAddressVersion6Length]) = 0; |
+ |
+ // Write the filter IP address (if any) to filterIPAddress. |
+ virtual int32_t FilterIP( |
+ char filterIPAddress[kIpAddressVersion6Length]) const = 0; |
+ |
+ // Only allow RTP packets from rtpFilterPort and RTCP packets from |
+ // rtcpFilterPort be processed. |
+ // Note: must be called after EnableIPv6(), if IPv6 is used. |
+ virtual int32_t SetFilterPorts(const uint16_t rtpFilterPort, |
+ const uint16_t rtcpFilterPort) = 0; |
+ |
+ // Set rtpFilterPort to the filter RTP port and rtcpFilterPort to the |
+ // filter RTCP port (if filtering based on port is enabled). |
+ virtual int32_t FilterPorts(uint16_t& rtpFilterPort, |
+ uint16_t& rtcpFilterPort) const = 0; |
+ |
+ // Set the number of buffers that the socket implementation may use for |
+ // receiving packets to numberOfSocketBuffers. I.e. the number of packets |
+ // that can be received in parallell. |
+ // Note: this API only has effect on Windows. |
+ virtual int32_t StartReceiving(const uint32_t numberOfSocketBuffers) = 0; |
+ |
+ // Stop receive incoming packets. |
+ virtual int32_t StopReceiving() = 0; |
+ |
+ // Return true incoming packets are received. |
+ virtual bool Receiving() const = 0; |
+ |
+ // Return true if send sockets have been initialized. |
+ virtual bool SendSocketsInitialized() const = 0; |
+ |
+ // Return true if local ports for sending has been set. |
+ virtual bool SourcePortsInitialized() const = 0; |
+ |
+ // Return true if receive sockets have been initialized. |
+ virtual bool ReceiveSocketsInitialized() const = 0; |
+ |
+ // Send data with size length to ip:portnr. The same port as the set |
+ // with InitializeSendSockets(..) is used if portnr is 0. The same IP |
+ // address as set with InitializeSendSockets(..) is used if ip is NULL. |
+ // If isRTCP is true the port used will be the RTCP port. |
+ virtual int32_t SendRaw(const int8_t* data, |
+ size_t length, |
+ int32_t isRTCP, |
+ uint16_t portnr = 0, |
+ const char* ip = NULL) = 0; |
+ |
+ // Send RTP data with size length to the address specified by to. |
+ virtual int32_t SendRTPPacketTo(const int8_t* data, |
+ size_t length, |
+ const SocketAddress& to) = 0; |
+ |
+ |
+ // Send RTCP data with size length to the address specified by to. |
+ virtual int32_t SendRTCPPacketTo(const int8_t* data, |
+ size_t length, |
+ const SocketAddress& to) = 0; |
+ |
+ // Send RTP data with size length to ip:rtpPort where ip is the ip set by |
+ // the InitializeSendSockets(..) call. |
+ virtual int32_t SendRTPPacketTo(const int8_t* data, |
+ size_t length, |
+ uint16_t rtpPort) = 0; |
+ |
+ |
+ // Send RTCP data with size length to ip:rtcpPort where ip is the ip set by |
+ // the InitializeSendSockets(..) call. |
+ virtual int32_t SendRTCPPacketTo(const int8_t* data, |
+ size_t length, |
+ uint16_t rtcpPort) = 0; |
+ |
+ // Set the IP address to which packets are sent to ipaddr. |
+ virtual int32_t SetSendIP( |
+ const char ipaddr[kIpAddressVersion6Length]) = 0; |
+ |
+ // Set the send RTP and RTCP port to rtpPort and rtcpPort respectively. |
+ virtual int32_t SetSendPorts(const uint16_t rtpPort, |
+ const uint16_t rtcpPort = 0) = 0; |
+ |
+ // Retreive the last registered error code. |
+ virtual ErrorCode LastError() const = 0; |
+ |
+ // Put the local IPv4 address in localIP. |
+ // Note: this API is for IPv4 only. |
+ static int32_t LocalHostAddress(uint32_t& localIP); |
+ |
+ // Put the local IP6 address in localIP. |
+ // Note: this API is for IPv6 only. |
+ static int32_t LocalHostAddressIPV6(char localIP[16]); |
+ |
+ // Return a copy of hostOrder (host order) in network order. |
+ static uint16_t Htons(uint16_t hostOrder); |
+ |
+ // Return a copy of hostOrder (host order) in network order. |
+ static uint32_t Htonl(uint32_t hostOrder); |
+ |
+ // Return IPv4 address in ip as 32 bit integer. |
+ static uint32_t InetAddrIPV4(const char* ip); |
+ |
+ // Convert the character string src into a network address structure in |
+ // the af address family and put it in dst. |
+ // Note: same functionality as inet_pton(..) |
+ static int32_t InetPresentationToNumeric(int32_t af, |
+ const char* src, |
+ void* dst); |
+ |
+ // Set ip and sourcePort according to address. As input parameter ipSize |
+ // is the length of ip. As output parameter it's the number of characters |
+ // written to ip (not counting the '\0' character). |
+ // Note: this API is only implemented on Windows and Linux. |
+ static int32_t IPAddress(const SocketAddress& address, |
+ char* ip, |
+ uint32_t& ipSize, |
+ uint16_t& sourcePort); |
+ |
+ // Set ip and sourcePort according to address. As input parameter ipSize |
+ // is the length of ip. As output parameter it's the number of characters |
+ // written to ip (not counting the '\0' character). |
+ // Note: this API is only implemented on Windows and Linux. |
+ // Additional note: this API caches the address of the last call to it. If |
+ // address is likley to be the same for multiple calls it may be beneficial |
+ // to call this API instead of IPAddress(). |
+ virtual int32_t IPAddressCached(const SocketAddress& address, |
+ char* ip, |
+ uint32_t& ipSize, |
+ uint16_t& sourcePort) = 0; |
+ |
+ // Return true if ipaddr is a valid IP address. |
+ // If ipV6 is false ipaddr is interpreted as an IPv4 address otherwise it |
+ // is interptreted as IPv6. |
+ static bool IsIpAddressValid(const char* ipaddr, const bool ipV6); |
+}; |
+ |
+} // namespace test |
+} // namespace webrtc |
+ |
+#endif // WEBRTC_TEST_CHANNEL_TRANSPORT_UDP_TRANSPORT_H_ |