roc::netio::BasicPort Class Reference

Base class for ports. More...

#include <basic_port.h>

Inheritance diagram for roc::netio::BasicPort:

Public Member Functions
	BasicPort (core::IAllocator &)
	Initialize.
virtual	~BasicPort ()
	Destroy.
const char *	descriptor () const
	Get a human-readable port description.
virtual bool	open ()=0
	Open port.
virtual AsyncOperationStatus	async_close (ICloseHandler &handler, void *handler_arg)=0
	Asynchronous close.
Public Member Functions inherited from roc::core::RefCounted< BasicPort, core::StandardAllocation >
	RefCounted ()
	Initialization with default allocation policy.
	RefCounted (const core::StandardAllocation &policy)
	Initialization with arbitrary allocation policy.
long	getref () const
	Get reference counter.
void	incref () const
	Increment reference counter.
void	decref () const
	Decrement reference counter.
Public Member Functions inherited from roc::core::ListNode
ListNodeData *	list_node_data () const
	Get list node data.

Protected Member Functions
void	update_descriptor ()
	Format descriptor and store into internal buffer.
virtual void	format_descriptor (core::StringBuilder &b)=0
	Implementation of descriptor formatting.
Protected Member Functions inherited from roc::core::StandardAllocation
IAllocator &	allocator () const
	Get allocator.
	StandardAllocation ()
	Initialize in invalid state. Such instance wont be usable.
	StandardAllocation (IAllocator &allocator)
	Initialize with given allocator. Such instance will use allocator to destroy objects.
template<class T >
void	destroy (T &object)
	Destroy object and deallocate its memory.

Detailed Description

Base class for ports.

Port is a transport-level endpoint, sending or receiving data from remote peer, like UDP sender or receiver, TCP listening socket, or TCP connection.

The following rules must be followed:

• if you called open(), you're responsible for calling async_close(), even if open() failed
• if async_close() returned AsyncOp_Completed, the port was closed immediately, and you can now destroy it
• if async_close() returned AsyncOp_Started, you should wait until close handler callback is invoked before destroying port

Definition at line 39 of file basic_port.h.

Constructor & Destructor Documentation

BasicPort()

roc::netio::BasicPort::BasicPort ( core::IAllocator &  )

explicit

Initialize.

~BasicPort()

virtual roc::netio::BasicPort::~BasicPort ( )

virtual

Destroy.

Member Function Documentation

async_close()

virtual AsyncOperationStatus roc::netio::BasicPort::async_close ( ICloseHandler &  handler, void *  handler_arg  )

pure virtual

Asynchronous close.

Remarks

Should be called from the event loop thread.

Returns

status code indicating whether operation was completed immediately or is scheduled for asynchronous execution

Implemented in roc::netio::TcpConnectionPort, roc::netio::TcpServerPort, roc::netio::UdpReceiverPort, and roc::netio::UdpSenderPort.

descriptor()

const char * roc::netio::BasicPort::descriptor

(

)

const

Get a human-readable port description.

Note

Port descriptor may change during initial configuration.

format_descriptor()

virtual void roc::netio::BasicPort::format_descriptor ( core::StringBuilder &  b )

protectedpure virtual

Implementation of descriptor formatting.

Implemented in roc::netio::TcpConnectionPort, roc::netio::TcpServerPort, roc::netio::UdpReceiverPort, and roc::netio::UdpSenderPort.

open()

virtual bool roc::netio::BasicPort::open ( )

pure virtual

Open port.

Remarks

Should be called from the event loop thread.

Implemented in roc::netio::TcpConnectionPort, roc::netio::TcpServerPort, roc::netio::UdpReceiverPort, and roc::netio::UdpSenderPort.

update_descriptor()

void roc::netio::BasicPort::update_descriptor ( )

protected

Format descriptor and store into internal buffer.

---

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

• roc_netio/target_libuv/roc_netio/basic_port.h