Protocol factory for Ethernet. More...

#include <daemon/face/ethernet-factory.hpp>

Inheritance diagram for nfd::face::EthernetFactory:

Collaboration diagram for nfd::face::EthernetFactory:

Public Types
using	CtorParams = ProtocolFactoryCtorParams

Public Member Functions
	EthernetFactory (const CtorParams &params)

shared_ptr< EthernetChannel >	createChannel (const shared_ptr< const ndn::net::NetworkInterface > &localEndpoint, time::nanoseconds idleTimeout)
	Create Ethernet-based channel on the specified network interface. More...

void	createFace (const CreateFaceRequest &req, const FaceCreatedCallback &onCreated, const FaceCreationFailedCallback &onFailure)
	Create a unicast face. More...

shared_ptr< Face >	createMulticastFace (const ndn::net::NetworkInterface &localEndpoint, const ethernet::Address &group)
	Create a face to communicate on the given Ethernet multicast group. More...

shared_ptr< Face >	createNetdevBoundFace (const FaceUri &remote, const shared_ptr< const ndn::net::NetworkInterface > &netdev)
	Create a netdev-bound face. More...

std::vector< shared_ptr< const Channel > >	getChannels () const
	Get list of open channels (listening + non-listening) More...

const std::set< std::string > &	getProvidedSchemes () const noexcept
	Get FaceUri schemes accepted by this protocol factory. More...

void	processConfig (OptionalConfigSection configSection, FaceSystem::ConfigContext &context)
	Process face_system subsection that corresponds to this protocol factory id. More...

Static Public Member Functions
static unique_ptr< ProtocolFactory >	create (const std::string &id, const CtorParams &params)
	Create a protocol factory instance. More...

static const std::string &	getId () noexcept

static std::set< std::string >	listRegistered ()
	Get all registered protocol factory IDs. More...

template<typename PF >
static void	registerType (const std::string &id=PF::getId())
	Register a protocol factory type. More...

Static Protected Member Functions
template<typename ChannelMap >
static std::vector< shared_ptr< const Channel > >	getChannelsFromMap (const ChannelMap &channelMap)

Protected Attributes
FaceCreatedCallback	addFace
	callback when a new face is created More...

shared_ptr< ndn::net::NetworkMonitor >	netmon
	NetworkMonitor for listing available network interfaces and monitoring their changes. More...

std::set< std::string >	providedSchemes
	FaceUri schemes provided by this protocol factory. More...

Detailed Description

Protocol factory for Ethernet.

Definition at line 38 of file ethernet-factory.hpp.

Member Typedef Documentation

◆ CtorParams

using nfd::face::ProtocolFactory::CtorParams = ProtocolFactoryCtorParams

inherited

Definition at line 69 of file protocol-factory.hpp.

Constructor & Destructor Documentation

◆ EthernetFactory()

nfd::face::EthernetFactory::EthernetFactory ( const CtorParams & params )

explicit

Definition at line 45 of file ethernet-factory.cpp.

Member Function Documentation

◆ create()

unique_ptr< ProtocolFactory > nfd::face::ProtocolFactory::create	(	const std::string &	id,
		const CtorParams &	params
	)

staticinherited

Create a protocol factory instance.

Return values

nullptr if a factory with the given id is not registered

Definition at line 41 of file protocol-factory.cpp.

◆ createChannel()

shared_ptr< EthernetChannel > nfd::face::EthernetFactory::createChannel	(	const shared_ptr< const ndn::net::NetworkInterface > &	localEndpoint,
		time::nanoseconds	idleTimeout
	)

Create Ethernet-based channel on the specified network interface.

If this method is called twice with the same endpoint, only one channel will be created. The second call will just return the existing channel.

Returns: Always a valid pointer to a EthernetChannel object, an exception is thrown if it cannot be created.

Exceptions

PcapHelper::Error channel creation failed

Definition at line 218 of file ethernet-factory.cpp.

◆ createFace()

void nfd::face::ProtocolFactory::createFace	(	const CreateFaceRequest &	req,
		const FaceCreatedCallback &	onCreated,
		const FaceCreationFailedCallback &	onFailure
	)

inherited

Create a unicast face.

Parameters

req	request object containing the face creation parameters
onCreated	callback if face creation succeeds or face already exists; the settings of an existing face are not updated if they differ from the request
onFailure	callback if face creation fails

Definition at line 85 of file protocol-factory.cpp.

◆ createMulticastFace()

shared_ptr< Face > nfd::face::EthernetFactory::createMulticastFace	(	const ndn::net::NetworkInterface &	localEndpoint,
		const ethernet::Address &	group
	)

Create a face to communicate on the given Ethernet multicast group.

If this method is called twice with the same arguments, only one face will be created. The second call will just return the existing face.

Parameters

localEndpoint	local network interface
group	multicast group address

Exceptions

std::runtime_error Face creation failed

Definition at line 237 of file ethernet-factory.cpp.

◆ createNetdevBoundFace()

shared_ptr< Face > nfd::face::ProtocolFactory::createNetdevBoundFace	(	const FaceUri &	remote,
		const shared_ptr< const ndn::net::NetworkInterface > &	netdev
	)

inherited

Create a netdev-bound face.

Parameters

remote	remote FaceUri, must be canonical
netdev	local network interface

Returns: new face

Exceptions

Error cannot create a face using specified arguments

Note: The caller must ensure there is no existing netdev-bound face with same remote FaceUri on the same local network interface.

Definition at line 105 of file protocol-factory.cpp.

◆ getChannels()

std::vector< shared_ptr< const Channel > > nfd::face::ProtocolFactory::getChannels ( ) const

inherited

Get list of open channels (listening + non-listening)

Definition at line 120 of file protocol-factory.cpp.

◆ getChannelsFromMap()

template<typename ChannelMap >

static std::vector<shared_ptr<const Channel> > nfd::face::ProtocolFactory::getChannelsFromMap ( const ChannelMap & channelMap )

inlinestaticprotectedinherited

Definition at line 186 of file protocol-factory.hpp.

◆ getId()

const std::string & nfd::face::EthernetFactory::getId ( )

staticnoexcept

Definition at line 39 of file ethernet-factory.cpp.

◆ getProvidedSchemes()

const std::set<std::string>& nfd::face::ProtocolFactory::getProvidedSchemes ( ) const

inlinenoexceptinherited

Get FaceUri schemes accepted by this protocol factory.

Definition at line 130 of file protocol-factory.hpp.

◆ listRegistered()

std::set< std::string > nfd::face::ProtocolFactory::listRegistered ( )

staticinherited

Get all registered protocol factory IDs.

Definition at line 53 of file protocol-factory.cpp.

◆ processConfig()

void nfd::face::ProtocolFactory::processConfig	(	OptionalConfigSection	configSection,
		FaceSystem::ConfigContext &	context
	)

inherited

Process face_system subsection that corresponds to this protocol factory id.

Parameters

configSection	the configuration section or boost::none to indicate it is omitted
context	provides access to data structures and contextual information

Exceptions

ConfigFile::Error invalid configuration

Definition at line 72 of file protocol-factory.cpp.

◆ registerType()

template<typename PF >

static void nfd::face::ProtocolFactory::registerType ( const std::string & id = PF::getId() )

inlinestaticinherited

Register a protocol factory type.

Template Parameters

PF	subclass of ProtocolFactory

Parameters

id	factory identifier

Definition at line 78 of file protocol-factory.hpp.

Member Data Documentation

◆ addFace

FaceCreatedCallback nfd::face::ProtocolFactory::addFace

protectedinherited

callback when a new face is created

Definition at line 254 of file protocol-factory.hpp.

◆ netmon

shared_ptr<ndn::net::NetworkMonitor> nfd::face::ProtocolFactory::netmon

protectedinherited

NetworkMonitor for listing available network interfaces and monitoring their changes.

ProtocolFactory subclass should check the NetworkMonitor has sufficient capabilities prior to usage.

Definition at line 261 of file protocol-factory.hpp.

◆ providedSchemes

std::set<std::string> nfd::face::ProtocolFactory::providedSchemes

protectedinherited

FaceUri schemes provided by this protocol factory.

Definition at line 253 of file protocol-factory.hpp.

NFD: Named Data Networking Forwarding Daemon 24.07 documentation

Public Types

Public Member Functions

Static Public Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ CtorParams

Constructor & Destructor Documentation

◆ EthernetFactory()

Member Function Documentation

◆ create()

◆ createChannel()

◆ createFace()

◆ createMulticastFace()

◆ createNetdevBoundFace()

◆ getChannels()

◆ getChannelsFromMap()

◆ getId()

◆ getProvidedSchemes()

◆ listRegistered()

◆ processConfig()

◆ registerType()

Member Data Documentation

◆ addFace

◆ netmon

◆ providedSchemes