nfd::face::UnixStreamChannel Class Reference

Class implementing a local channel to create faces. More...

#include <unix-stream-channel.hpp>

Inheritance diagram for nfd::face::UnixStreamChannel:

Collaboration diagram for nfd::face::UnixStreamChannel:

Classes
class	Error
	UnixStreamChannel-related error. More...

Public Member Functions
	UnixStreamChannel (const unix_stream::Endpoint &endpoint)
	Create UnixStream channel for the specified endpoint. More...
	~UnixStreamChannel () override
bool	isListening () const override
	Returns whether the channel is listening. More...
size_t	size () const override
	Returns the number of faces in the channel. More...
void	listen (const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onAcceptFailed, int backlog=boost::asio::local::stream_protocol::acceptor::max_connections)
	Start listening. More...
Public Member Functions inherited from nfd::face::Channel
virtual	~Channel ()
const FaceUri &	getUri () const

Additional Inherited Members
Protected Member Functions inherited from nfd::face::Channel
void	setUri (const FaceUri &uri)

Detailed Description

Class implementing a local channel to create faces.

Channel can create faces as a response to incoming IPC connections (UnixStreamChannel::listen needs to be called for that to work).

Definition at line 45 of file unix-stream-channel.hpp.

Constructor & Destructor Documentation

nfd::face::UnixStreamChannel::UnixStreamChannel ( const unix_stream::Endpoint &  endpoint )

explicit

Create UnixStream channel for the specified endpoint.

To enable creation of faces upon incoming connections, one needs to explicitly call UnixStreamChannel::listen method.

Definition at line 39 of file unix-stream-channel.cpp.

References NFD_LOG_CHAN_INFO, and nfd::face::Channel::setUri().

nfd::face::UnixStreamChannel::~UnixStreamChannel ( )

override

Definition at line 49 of file unix-stream-channel.cpp.

References isListening(), and NFD_LOG_CHAN_DEBUG.

Member Function Documentation

bool nfd::face::UnixStreamChannel::isListening ( ) const

inlineoverridevirtual

Returns whether the channel is listening.

Implements nfd::face::Channel.

Definition at line 73 of file unix-stream-channel.hpp.

Referenced by listen(), and ~UnixStreamChannel().

size_t nfd::face::UnixStreamChannel::size ( ) const

inlineoverridevirtual

Returns the number of faces in the channel.

Implements nfd::face::Channel.

Definition at line 79 of file unix-stream-channel.hpp.

References websocketpp::extensions::permessage_deflate::mode::accept, and websocketpp::transport::asio::socket::error::socket.

void nfd::face::UnixStreamChannel::listen	(	const FaceCreatedCallback &	onFaceCreated,
		const FaceCreationFailedCallback &	onAcceptFailed,
		int	backlog = boost::asio::local::stream_protocol::acceptor::max_connections
	)

Start listening.

Enable listening on the Unix socket, waiting for incoming connections, and creating a face when a connection is made.

Faces created in this way will have on-demand persistency.

Parameters

onFaceCreated	Callback to notify successful creation of the face
onAcceptFailed	Callback to notify when channel fails (accept call returns an error)
backlog	The maximum length of the queue of pending incoming connections

Exceptions

Error

Definition at line 62 of file unix-stream-channel.cpp.

References websocketpp::extensions::permessage_deflate::mode::accept, nfd::face::connectFaceClosedSignal(), nfd::getGlobalIoService(), isListening(), NFD_LOG_CHAN_DEBUG, NFD_LOG_CHAN_TRACE, NFD_LOG_CHAN_WARN, websocketpp::transport::error::operation_aborted, and websocketpp::transport::asio::socket::error::socket.

---

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

• ndnSIM/NFD/daemon/face/unix-stream-channel.hpp
• ndnSIM/NFD/daemon/face/unix-stream-channel.cpp