#include <AsyncTcpSocketBase.hxx>

Inheritance diagram for reTurn::AsyncTcpSocketBase:

Public Member Functions
	AsyncTcpSocketBase (asio::io_context &ioService)

unsigned int	getSocketDescriptor () override

asio::error_code	bind (const asio::ip::address &address, unsigned short port) override
	Note: The following API's are thread safe and queue the request to be handled by the ioService thread.

void	connect (const std::string &address, unsigned short port) override

void	transportReceive () override

void	transportFramedReceive () override

void	transportSend (const StunTuple &destination, std::vector< asio::const_buffer > &buffers) override

void	transportClose () override

virtual void	setConnectedAddressAndPort ()

asio::ip::address	getSenderEndpointAddress () override

unsigned short	getSenderEndpointPort () override

Public Member Functions inherited from reTurn::AsyncSocketBase
	AsyncSocketBase (asio::io_context &ioService)

virtual	~AsyncSocketBase ()

virtual void	registerAsyncSocketBaseHandler (AsyncSocketBaseHandler *handler)

virtual void	send (const StunTuple &destination, const std::shared_ptr< DataBuffer > &data)
	Note: destination is ignored for TCP and TLS connections.

virtual void	send (const StunTuple &destination, unsigned short channel, const std::shared_ptr< DataBuffer > &data)

virtual void	receive ()
	Overlapped calls to receive functions have no effect.

virtual void	framedReceive ()

virtual void	close ()

bool	isConnected () const noexcept

asio::ip::address &	getConnectedAddress () noexcept

unsigned short	getConnectedPort () const noexcept

virtual void	setOnBeforeSocketClosedFp (BeforeClosedHandler fp)

virtual void	doSend (const StunTuple &destination, unsigned short channel, const std::shared_ptr< DataBuffer > &data, const std::size_t bufferStartPos=0)
	Use these if you already operating within the ioService thread.

virtual void	doSend (const StunTuple &destination, const std::shared_ptr< DataBuffer > &data, const std::size_t bufferStartPos=0)

virtual void	doReceive ()

virtual void	doFramedReceive ()

virtual void	onConnectSuccess ()
	Class override callbacks.

virtual void	onConnectFailure (const asio::error_code &e)

virtual void	onReceiveSuccess (const asio::ip::address &address, unsigned short port, const std::shared_ptr< DataBuffer > &data)=0

virtual void	onReceiveFailure (const asio::error_code &e)=0

virtual void	onSendSuccess ()=0

virtual void	onSendFailure (const asio::error_code &e)=0

virtual void	start ()

virtual void	stop ()

virtual void	handleServerHandshake (const asio::error_code &e)

virtual void	handleUdpResolve (const asio::error_code &ec, const asio::ip::udp::resolver::results_type &endpoints)

virtual void	handleClientHandshake (const asio::error_code &ec, const asio::ip::tcp::endpoint &endpoint)

Protected Member Functions
void	handleReadHeader (const asio::error_code &e) override

void	handleTcpResolve (const asio::error_code &ec, const asio::ip::tcp::resolver::results_type &endpoints) override

void	handleConnect (const asio::error_code &ec, const asio::ip::tcp::endpoint &endpoint) override

Protected Member Functions inherited from reTurn::AsyncSocketBase
virtual void	handleSend (const asio::error_code &e)
	Handle completion of a sendData operation.

virtual void	handleReceive (const asio::error_code &e, size_t bytesTransferred)

asio::error_code	openAndBind (asio::ip::tcp::socket &socket)
	For TCP and TLS client sockets.

void	asyncConnect (asio::ip::tcp::socket &socket, const asio::ip::tcp::resolver::results_type &endpoints)

void	startIdleTimer (unsigned int timeoutSeconds, std::function< bool()> inUse)
	For server connections (TcpConnectionIdleTimeout): the connection is closed, with close(), once nothing has been received on it for timeoutSeconds while inUse() is false - eg.

void	noteReceived ()

void	stopIdleTimer ()

Protected Attributes
asio::ip::tcp::socket	mSocket

asio::ip::tcp::resolver	mResolver

Protected Attributes inherited from reTurn::AsyncSocketBase
asio::ip::tcp::endpoint	mLocalTcpEndpoint

asio::io_context &	mIOService
	The io_context used to perform asynchronous operations.

std::shared_ptr< DataBuffer >	mReceiveBuffer
	Receive Buffer and state.

bool	mReceiving

asio::ip::address	mConnectedAddress
	Connected Info and State.

unsigned short	mConnectedPort

bool	mConnected

AsyncSocketBaseHandler *	mAsyncSocketBaseHandler
	Handlers.

BeforeClosedHandler	mOnBeforeSocketCloseFp
	Provides an opportunity for the app to clean up, e.g., QoS-related data or resources just before the socket is closed.

Additional Inherited Members
Public Types inherited from reTurn::AsyncSocketBase
using	BeforeClosedHandler = std::function< void(unsigned int)>

Static Public Member Functions inherited from reTurn::AsyncSocketBase
static std::shared_ptr< DataBuffer >	allocateBuffer (size_t size)
	Utility API.

static size_t	channelDataPadding (size_t length)
	Over TCP and TLS, a TURN ChannelData message is padded to a multiple of 4 bytes, the padding not counted in its length (RFC 5766 11.5, RFC 8656 12.5): the padding after one of length bytes.

static void	setExclusiveAddressUse (asio::ip::udp::socket &socket)
	For a UDP socket, between open() and bind().

Detailed Description

Definition at line 13 of file AsyncTcpSocketBase.hxx.

Constructor & Destructor Documentation

◆ AsyncTcpSocketBase()

reTurn::AsyncTcpSocketBase::AsyncTcpSocketBase ( asio::io_context & ioService )

explicit

Definition at line 18 of file AsyncTcpSocketBase.cxx.

Member Function Documentation

◆ bind()

asio::error_code reTurn::AsyncTcpSocketBase::bind	(	const asio::ip::address &	address,
		unsigned short	port
	)

overridevirtual

Note: The following API's are thread safe and queue the request to be handled by the ioService thread.

Implements reTurn::AsyncSocketBase.

Definition at line 32 of file AsyncTcpSocketBase.cxx.

◆ connect()

void reTurn::AsyncTcpSocketBase::connect	(	const std::string &	address,
		unsigned short	port
	)

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 40 of file AsyncTcpSocketBase.cxx.

◆ getSenderEndpointAddress()

asio::ip::address reTurn::AsyncTcpSocketBase::getSenderEndpointAddress ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 95 of file AsyncTcpSocketBase.cxx.

◆ getSenderEndpointPort()

unsigned short reTurn::AsyncTcpSocketBase::getSenderEndpointPort ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 101 of file AsyncTcpSocketBase.cxx.

◆ getSocketDescriptor()

unsigned int reTurn::AsyncTcpSocketBase::getSocketDescriptor ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Reimplemented in reTurn::TurnAsyncTcpSocket.

Definition at line 26 of file AsyncTcpSocketBase.cxx.

◆ handleConnect()

void reTurn::AsyncTcpSocketBase::handleConnect	(	const asio::error_code &	ec,
		const asio::ip::tcp::endpoint &	endpoint
	)

overrideprotectedvirtual

Reimplemented from reTurn::AsyncSocketBase.

Definition at line 68 of file AsyncTcpSocketBase.cxx.

◆ handleReadHeader()

void reTurn::AsyncTcpSocketBase::handleReadHeader ( const asio::error_code & e )

overrideprotectedvirtual

Reimplemented from reTurn::AsyncSocketBase.

Definition at line 129 of file AsyncTcpSocketBase.cxx.

◆ handleTcpResolve()

void reTurn::AsyncTcpSocketBase::handleTcpResolve	(	const asio::error_code &	ec,
		const asio::ip::tcp::resolver::results_type &	endpoints
	)

overrideprotectedvirtual

Reimplemented from reTurn::AsyncSocketBase.

Definition at line 52 of file AsyncTcpSocketBase.cxx.

◆ setConnectedAddressAndPort()

void reTurn::AsyncTcpSocketBase::setConnectedAddressAndPort ( )

virtual

Definition at line 87 of file AsyncTcpSocketBase.cxx.

◆ transportClose()

void reTurn::AsyncTcpSocketBase::transportClose ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 183 of file AsyncTcpSocketBase.cxx.

◆ transportFramedReceive()

void reTurn::AsyncTcpSocketBase::transportFramedReceive ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 122 of file AsyncTcpSocketBase.cxx.

◆ transportReceive()

void reTurn::AsyncTcpSocketBase::transportReceive ( )

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 115 of file AsyncTcpSocketBase.cxx.

◆ transportSend()

void reTurn::AsyncTcpSocketBase::transportSend	(	const StunTuple &	destination,
		std::vector< asio::const_buffer > &	buffers
	)

overridevirtual

Implements reTurn::AsyncSocketBase.

Definition at line 107 of file AsyncTcpSocketBase.cxx.

Member Data Documentation

◆ mResolver

asio::ip::tcp::resolver reTurn::AsyncTcpSocketBase::mResolver

protected

Definition at line 38 of file AsyncTcpSocketBase.hxx.

◆ mSocket

asio::ip::tcp::socket reTurn::AsyncTcpSocketBase::mSocket

protected

Definition at line 37 of file AsyncTcpSocketBase.hxx.

The documentation for this class was generated from the following files:

reTurn/AsyncTcpSocketBase.hxx
reTurn/AsyncTcpSocketBase.cxx

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ AsyncTcpSocketBase()

Member Function Documentation

◆ bind()

◆ connect()

◆ getSenderEndpointAddress()

◆ getSenderEndpointPort()

◆ getSocketDescriptor()

◆ handleConnect()

◆ handleReadHeader()

◆ handleTcpResolve()

◆ setConnectedAddressAndPort()

◆ transportClose()

◆ transportFramedReceive()

◆ transportReceive()

◆ transportSend()

Member Data Documentation

◆ mResolver

◆ mSocket