Generic network interface. More...

#include <simpleNetwork.h>

Inheritance diagram for SST::Interfaces::SimpleNetwork:

Data Structures
class	Handler
	Event Handler class with user-data argument. More...

class	Handler< classT, void >
	Event Handler class without user-data. More...

class	HandlerBase
	Functor classes for handling of callbacks. More...

class	NetworkInspector
	Class used to inspect network requests going through the network. More...

class	Request
	Represents both network sends and receives. More...

Public Types
typedef int64_t	nid_t
	All Addresses can be 64-bit.

Public Member Functions
	SimpleNetwork (SST::Component *comp)
	Constructor, designed to be used via 'loadSubComponent'. More...

	SimpleNetwork (SST::ComponentId_t id)
	Constructor, designed to be used via 'loadUserSubComponent or loadAnonymousSubComponent'. More...

virtual bool	initialize (const std::string &portName, const UnitAlgebra &link_bw, int vns, const UnitAlgebra &in_buf_size, const UnitAlgebra &out_buf_size)=0
	Second half of building the interface. More...

virtual void	sendInitData (Request *req)=0
	Sends a network request during the init() phase.

virtual Request *	recvInitData ()=0
	Receive any data during the init() phase. More...

virtual void	sendUntimedData (Request *req)
	Sends a network request during untimed phases (init() and complete()). More...

virtual Request *	recvUntimedData ()
	Receive any data during untimed phases (init() and complete()). More...

virtual bool	send (Request *req, int vn)=0
	Returns a handle to the underlying SST::Link. More...

virtual Request *	recv (int vn)=0
	Receive a Request from the network. More...

virtual void	setup () override
	Called after all components have been constructed and initialization has completed, but before simulation time has begun. More...

virtual void	init (unsigned int UNUSED(phase)) override
	Used during the init phase. More...

virtual void	complete (unsigned int UNUSED(phase)) override
	Used during the init phase. More...

virtual void	finish () override
	Called after simulation completes, but before objects are destroyed. More...

virtual bool	spaceToSend (int vn, int num_bits)=0
	Checks if there is sufficient space to send on the specified virtual network. More...

virtual bool	requestToReceive (int vn)=0
	Checks if there is a waiting network request request pending in the specified virtual network. More...

virtual void	setNotifyOnReceive (HandlerBase *functor)=0
	Registers a functor which will fire when a new request is received from the network. More...

virtual void	setNotifyOnSend (HandlerBase *functor)=0
	Registers a functor which will fire when a request is sent to the network. More...

virtual bool	isNetworkInitialized () const =0
	Check to see if network is initialized. More...

virtual nid_t	getEndpointID () const =0
	Returns the endpoint ID. More...

virtual const UnitAlgebra &	getLinkBW () const =0
	Returns the final BW of the link managed by the simpleNetwork instance. More...

Public Member Functions inherited from SST::SubComponent
	SST_ELI_DECLARE_INFO_EXTERN (ELI::ProvidesParams, ELI::ProvidesSubComponentSlots, ELI::ProvidesPorts, ELI::ProvidesStats, ELI::ProvidesInterface) SubComponent(Component *parent)

	SubComponent (ComponentId_t id)

Public Member Functions inherited from SST::Module
	SST_ELI_DECLARE_CTORS (ELI_CTOR(SST::Params &),) Module()

Public Member Functions inherited from SST::BaseComponent
	BaseComponent (ComponentId_t id)

BaseComponent *	getParent () const
	Returns a pointer to the parent BaseComponent.

const std::string &	getType () const

ComponentId_t	getId () const
	Returns unique component ID.

virtual void	emergencyShutdown (void)
	Called when SIGINT or SIGTERM has been seen. More...

const std::string &	getName () const
	Returns component Name.

virtual bool	Status ()
	Currently unused function.

virtual void	printStatus (Output &UNUSED(out))
	Called by the Simulation to request that the component print it's current status. More...

bool	isPortConnected (const std::string &name) const
	Determine if a port name is connected to any links.

Link *	configureLink (std::string name, TimeConverter time_base, Event::HandlerBase handler=NULL)
	Configure a Link. More...

Link *	configureLink (std::string name, std::string time_base, Event::HandlerBase *handler=NULL)
	Configure a Link. More...

Link *	configureLink (std::string name, Event::HandlerBase *handler=NULL)
	Configure a Link. More...

Link *	configureSelfLink (std::string name, TimeConverter time_base, Event::HandlerBase handler=NULL)
	Configure a SelfLink (Loopback link) More...

Link *	configureSelfLink (std::string name, std::string time_base, Event::HandlerBase *handler=NULL)
	Configure a SelfLink (Loopback link) More...

Link *	configureSelfLink (std::string name, Event::HandlerBase *handler=NULL)
	Configure a SelfLink (Loopback link) More...

TimeConverter *	registerClock (std::string freq, Clock::HandlerBase *handler, bool regAll=true)
	Registers a clock for this component. More...

TimeConverter *	registerClock (const UnitAlgebra &freq, Clock::HandlerBase *handler, bool regAll=true)

void	unregisterClock (TimeConverter tc, Clock::HandlerBase handler)
	Removes a clock handler from the component.

Cycle_t	reregisterClock (TimeConverter freq, Clock::HandlerBase handler)
	Reactivates an existing Clock and Handler. More...

Cycle_t	getNextClockCycle (TimeConverter *freq)
	Returns the next Cycle that the TimeConverter would fire.

TimeConverter *	registerOneShot (std::string timeDelay, OneShot::HandlerBase *handler)
	Registers a OneShot event for this component. More...

TimeConverter *	registerOneShot (const UnitAlgebra &timeDelay, OneShot::HandlerBase *handler)

TimeConverter *	registerTimeBase (std::string base, bool regAll=true)
	Registers a default time base for the component and optionally sets the the component's links to that timebase. More...

TimeConverter *	getTimeConverter (const std::string &base)

TimeConverter *	getTimeConverter (const UnitAlgebra &base)

SimTime_t	getCurrentSimTime (TimeConverter *tc) const
	return the time since the simulation began in units specified by the parameter. More...

SimTime_t	getCurrentSimTime () const
	return the time since the simulation began in the default timebase

SimTime_t	getCurrentSimTime (std::string base)
	return the time since the simulation began in timebase specified More...

SimTime_t	getCurrentSimTimeNano () const
	Utility function to return the time since the simulation began in nanoseconds.

SimTime_t	getCurrentSimTimeMicro () const
	Utility function to return the time since the simulation began in microseconds.

SimTime_t	getCurrentSimTimeMilli () const
	Utility function to return the time since the simulation began in milliseconds.

bool	isStatisticShared (const std::string &statName, bool include_me=false)

template<typename T >
Statistic< T > *	registerStatistic (SST::Params &params, const std::string &statName, const std::string &statSubId="")
	Registers a statistic. More...

template<typename T >
Statistic< T > *	registerStatistic (const std::string &statName, const std::string &statSubId="")

template<typename... Args>
Statistic< std::tuple< Args...> > *	registerMultiStatistic (const std::string &statName, const std::string &statSubId="")

template<typename... Args>
Statistic< std::tuple< Args...> > *	registerMultiStatistic (SST::Params &params, const std::string &statName, const std::string &statSubId="")

template<typename T >
Statistic< T > *	registerStatistic (const char statName, const char statSubId="")

Module *	loadModule (std::string type, Params &params)
	Loads a module from an element Library. More...

Module *	loadModuleWithComponent (std::string type, Component *comp, Params &params)
	Loads a module from an element Library. More...

SubComponent *	loadSubComponent (std::string type, Component *comp, Params &params)
	Loads a SubComponent from an element Library. More...

SubComponent *	loadNamedSubComponent (std::string name)

SubComponent *	loadNamedSubComponent (std::string name, Params &params)

SubComponentSlotInfo *	getSubComponentSlotInfo (std::string name, bool fatalOnEmptyIndex=false)

const std::vector< double > &	getCoordinates () const
	Retrieve the X,Y,Z coordinates of this component.

bool	wasLoadedWithLegacyAPI () const
	Temporary function to help provide backward compatibility to old SubComponent API. More...

Static Public Attributes
static const nid_t	INIT_BROADCAST_ADDR = 0xffffffffffffffffl

Additional Inherited Members
Protected Member Functions inherited from SST::SubComponent
SubComponent *	loadSubComponent (std::string type, Params &params)

Protected Member Functions inherited from SST::BaseComponent
template<class T , class... ARGS>
T *	loadComponentExtension (ARGS...args)

template<class T >
bool	isSubComponentLoadableUsingAPI (std::string type)
	Check to see if a given element type is loadable with a particular API. More...

template<class T , class... ARGS>
T *	loadAnonymousSubComponent (std::string type, std::string slot_name, int slot_num, uint64_t share_flags, Params &params, ARGS...args)
	Loads an anonymous subcomponent (not defined in input file to SST run). More...

template<class T >
T *	loadUserSubComponent (std::string slot_name)
	Loads a user defined subcomponent (defined in input file to SST run). More...

template<class T , class... ARGS>
T *	loadUserSubComponent (std::string slot_name, uint64_t share_flags, ARGS...args)
	Loads a user defined subcomponent (defined in input file to SST run). More...

bool	isAnonymous ()

bool	isUser ()

void	setDefaultTimeBase (TimeConverter *tc)
	Manually set the default detaulTimeBase.

TimeConverter *	getDefaultTimeBase ()

bool	doesSubComponentExist (std::string type)

SharedRegion *	getLocalSharedRegion (const std::string &key, size_t size)
	Find a lookup table.

SharedRegion *	getGlobalSharedRegion (const std::string &key, size_t size, SharedRegionMerger *merger=NULL)

Simulation *	getSimulation () const

virtual bool	doesComponentInfoStatisticExist (const std::string &statisticName) const

uint8_t	getComponentInfoStatisticEnableLevel (const std::string &statisticName) const

Component *	getTrueComponent () const

Protected Attributes inherited from SST::SubComponent
Component *const	parent

Protected Attributes inherited from SST::BaseComponent
Simulation *	sim

Detailed Description

Generic network interface.

Constructor & Destructor Documentation

SST::Interfaces::SimpleNetwork::SimpleNetwork ( SST::Component * comp )

inline

Constructor, designed to be used via 'loadSubComponent'.

SST::Interfaces::SimpleNetwork::SimpleNetwork ( SST::ComponentId_t id )

inline

Constructor, designed to be used via 'loadUserSubComponent or loadAnonymousSubComponent'.

Member Function Documentation

virtual void SST::Interfaces::SimpleNetwork::complete ( unsigned int UNUSEDphase )

inlineoverridevirtual

Used during the init phase.

The method will be called each phase of initialization. Initialization ends when no components have sent any data.

Reimplemented from SST::BaseComponent.

virtual void SST::Interfaces::SimpleNetwork::finish ( )

inlineoverridevirtual

Called after simulation completes, but before objects are destroyed.

A good place to print out statistics.

Reimplemented from SST::SubComponent.

virtual nid_t SST::Interfaces::SimpleNetwork::getEndpointID ( ) const

pure virtual

Returns the endpoint ID.

Cannot be called until after the network is initialized.

Returns: Endpoint ID

virtual const UnitAlgebra& SST::Interfaces::SimpleNetwork::getLinkBW ( ) const

pure virtual

Returns the final BW of the link managed by the simpleNetwork instance.

Cannot be called until after the network is initialized.

Returns: Link bandwidth of associated link

virtual void SST::Interfaces::SimpleNetwork::init ( unsigned int UNUSEDphase )

inlineoverridevirtual

Used during the init phase.

The method will be called each phase of initialization. Initialization ends when no components have sent any data.

Reimplemented from SST::SubComponent.

virtual bool SST::Interfaces::SimpleNetwork::initialize	(	const std::string &	portName,
		const UnitAlgebra &	link_bw,
		int	vns,
		const UnitAlgebra &	in_buf_size,
		const UnitAlgebra &	out_buf_size
	)

pure virtual

Second half of building the interface.

Initialize network interface

Parameters

portName	- Name of port to connect to
link_bw	- Bandwidth of the link
vns	- Number of virtual networks to be provided
in_buf_size	- Size of input buffers (from router)
out_buf_size	- Size of output buffers (to router)

Returns: true if the link was able to be configured.

virtual bool SST::Interfaces::SimpleNetwork::isNetworkInitialized ( ) const

pure virtual

Check to see if network is initialized.

If network is not initialized, then no other functions other than init() can can be called on the interface.

Returns: true if network is initialized, false otherwise

virtual Request* SST::Interfaces::SimpleNetwork::recv ( int vn )

pure virtual

Receive a Request from the network.

Use this method for polling-based applications. Register a handler for push-based notification of responses.

Parameters

vn	Virtual network to receive on

Returns: NULL if nothing is available.; Pointer to a Request response (that should be deleted)

virtual Request* SST::Interfaces::SimpleNetwork::recvInitData ( )

pure virtual

Receive any data during the init() phase.

See Also: SST::Link::recvInitData()

Referenced by recvUntimedData().

virtual Request* SST::Interfaces::SimpleNetwork::recvUntimedData ( )

inlinevirtual

Receive any data during untimed phases (init() and complete()).

See Also: SST::Link::recvUntimedData()

For now, simply call recvInitData. Once that call is deprecated and removed, this will become a pure virtual function. This means that when classes implement SimpleNetwork, they will need to overload both recvUntimedData and recvInitData with identical functionality (or having the Init version call the Untimed version) until recvInitData is removed in SST 9.0.

References recvInitData().

virtual bool SST::Interfaces::SimpleNetwork::requestToReceive ( int vn )

pure virtual

Checks if there is a waiting network request request pending in the specified virtual network.

Parameters

vn	Virtual network to check

Returns: true if a network request is pending in the specified virtual network, false otherwise

virtual bool SST::Interfaces::SimpleNetwork::send	(	Request *	req,
		int	vn
	)

pure virtual

Returns a handle to the underlying SST::Link.

Send a Request to the network.

virtual void SST::Interfaces::SimpleNetwork::sendUntimedData ( Request * req )

inlinevirtual

Sends a network request during untimed phases (init() and complete()).

See Also: SST::Link::sendUntimedData()

For now, simply call sendInitData. Once that call is deprecated and removed, this will become a pure virtual function. This means that when classes implement SimpleNetwork, they will need to overload both sendUntimedData and sendInitData with identical functionality (or having the Init version call the Untimed version) until sendInitData is removed in SST 9.0.

References sendInitData().

virtual void SST::Interfaces::SimpleNetwork::setNotifyOnReceive ( HandlerBase * functor )

pure virtual

Registers a functor which will fire when a new request is received from the network.

Note, the actual request that was received is not passed into the functor, it is only a notification that something is available.

Parameters

functor Functor to call when request is received

virtual void SST::Interfaces::SimpleNetwork::setNotifyOnSend ( HandlerBase * functor )

pure virtual

Registers a functor which will fire when a request is sent to the network.

Note, this only tells you when data is sent, it does not guarantee any specified amount of available space.

Parameters

functor Functor to call when request is sent

virtual void SST::Interfaces::SimpleNetwork::setup ( )

inlineoverridevirtual

Called after all components have been constructed and initialization has completed, but before simulation time has begun.

Reimplemented from SST::SubComponent.

virtual bool SST::Interfaces::SimpleNetwork::spaceToSend	(	int	vn,
		int	num_bits
	)

pure virtual

Checks if there is sufficient space to send on the specified virtual network.

Parameters

vn	Virtual network to check
num_bits	Minimum size in bits required to have space to send

Returns: true if there is space in the output, false otherwise

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

src/sst/core/interfaces/simpleNetwork.h
src/sst/core/interfaces/simpleNetwork.cc

Data Structures

Public Types

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation