nfd::face::EthernetFactory Class Reference

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< EthernetChannelcreateChannel (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) override
 Try to create a unicast face using the supplied parameters. More...
 
shared_ptr< FacecreateMulticastFace (const ndn::net::NetworkInterface &localEndpoint, const ethernet::Address &group)
 Create a face to communicate on the given Ethernet multicast group. More...
 
std::vector< shared_ptr< const Channel > > getChannels () const override
 
const std::set< std::string > & getProvidedSchemes ()
 Get FaceUri schemes accepted by this ProtocolFactory. More...
 
void processConfig (OptionalConfigSection configSection, FaceSystem::ConfigContext &context) override
 process face_system.ether config section More...
 

Static Public Member Functions

static unique_ptr< ProtocolFactorycreate (const std::string &id, const CtorParams &params)
 Create a protocol factory instance. More...
 
static const std::string & getId ()
 
static std::set< std::string > listRegistered ()
 Get 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 ProtocolFactory. More...
 

Detailed Description

protocol factory for Ethernet

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

Member Typedef Documentation

Constructor & Destructor Documentation

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

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

Member Function Documentation

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

Create a protocol factory instance.

Return values
nullptrif factory with id is not registered

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

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::Errorchannel creation failed

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

void nfd::face::EthernetFactory::createFace ( const CreateFaceRequest req,
const FaceCreatedCallback onCreated,
const FaceCreationFailedCallback onFailure 
)
overridevirtual

Try to create a unicast face using the supplied parameters.

Parameters
reqrequest object containing the face creation parameters
onCreatedcallback if face creation succeeds or face already exists; the settings of an existing face are not updated if they differ from the request
onFailurecallback if face creation fails

Implements nfd::face::ProtocolFactory.

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

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
localEndpointlocal network interface
groupmulticast group address
Exceptions
EthernetTransport::Errortransport creation fails

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

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

Implements nfd::face::ProtocolFactory.

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

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

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

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

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

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

Get FaceUri schemes accepted by this ProtocolFactory.

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

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

Get registered protocol factory ids.

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

void nfd::face::EthernetFactory::processConfig ( OptionalConfigSection  configSection,
FaceSystem::ConfigContext context 
)
overridevirtual

process face_system.ether config section

Implements nfd::face::ProtocolFactory.

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

template<typename PF >
static void nfd::face::ProtocolFactory::registerType ( const std::string &  id = PF::getId())
inlinestaticinherited

Register a protocol factory type.

Template Parameters
Ssubclass of ProtocolFactory
Parameters
idfactory identifier

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

Member Data Documentation

FaceCreatedCallback nfd::face::ProtocolFactory::addFace
protectedinherited

callback when a new face is created

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

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 188 of file protocol-factory.hpp.

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

FaceUri schemes provided by this ProtocolFactory.

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