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

#include <daemon/face/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, bool wantCongestionMarking)
	Create UnixStream channel for the specified endpoint. More...

	~UnixStreamChannel () final

size_t	getDefaultMtu () const noexcept
	Returns the default MTU for all faces created by this channel. More...

const FaceUri &	getUri () const noexcept

bool	isListening () const final
	Returns whether the channel is listening. More...

void	listen (const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onAcceptFailed, int backlog=boost::asio::local::stream_protocol::acceptor::max_connections)
	Start listening. More...

size_t	size () const final
	Returns the number of faces in the channel. More...

Protected Member Functions
void	setDefaultMtu (size_t mtu) noexcept

void	setUri (const FaceUri &uri) noexcept

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

◆ UnixStreamChannel()

nfd::face::UnixStreamChannel::UnixStreamChannel	(	const unix_stream::Endpoint &	endpoint,
		bool	wantCongestionMarking
	)

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.

◆ ~UnixStreamChannel()

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

final

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

Member Function Documentation

◆ getDefaultMtu()

size_t nfd::face::Channel::getDefaultMtu ( ) const

inlinenoexceptinherited

Returns the default MTU for all faces created by this channel.

Definition at line 56 of file channel.hpp.

◆ getUri()

const FaceUri& nfd::face::Channel::getUri ( ) const

inlinenoexceptinherited

Definition at line 47 of file channel.hpp.

◆ isListening()

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

inlinefinalvirtual

Returns whether the channel is listening.

Implements nfd::face::Channel.

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

◆ listen()

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 64 of file unix-stream-channel.cpp.

◆ setDefaultMtu()

void nfd::face::Channel::setDefaultMtu ( size_t mtu )

protectednoexceptinherited

Definition at line 40 of file channel.cpp.

◆ setUri()

void nfd::face::Channel::setUri ( const FaceUri & uri )

protectednoexceptinherited

Definition at line 34 of file channel.cpp.

◆ size()

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