Skip to main content

configureSelfLink

Link* configureSelfLink(const std::string& name, TimeConverter* time_base, Event::HandlerBase* handler = nullptr);
Link* configureSelfLink(const std::string& name, const std::string& time_base, Event::HandlerBase* handler = nullptr);
Link* configureSelfLink(const std::string& name, const UnitAlgebra& time_base, Event::HandlerBase* handler = nullptr);
Link* configureSelfLink(const std::string& name, Event::HandlerBase* handler = nullptr);

Availability: Component, SubComponent, ComponentExtension

Configure a self link on the named ports. This call also optionally registers an event handler to be called on event arrivals. If a handler is not registered, the link must be polled. A time base can also be specified; this can be used in future send calls to add additional send latency. If a time base is not specified, the component's default time base will be used.

A return value of nullptr indicates the link could not be configured. The most common cause of a self link not being configured is an incorrect port name. Components are responsible for detecting and managing any errors.

Parameters​

  • name (string) Name of the port to configure the link on
  • time_base (TimeConverter*, string, UnitAlgebra) The base time units to use with time-related calls on the link.
  • handler (Event::HandlerBase*) The event handler to use for event arrivals
  • returns (Link*) A handle to the configured link. A return value of nullptr indicates the link could not be configured.

Example​

Excerpt from sst-elements/src/sst/elements/kingsley/linkcontrol.cc
#include <sst/core/component.h>

LinkControl::LinkControl(ComponentId_t id, Params& params) : Component(id) 
{
    /** Other configuration here */

    // Configure self link for delaying events internally 
    output_timing = configureSelfLink("rtr_port_output_timing", "1GHz",
            new Event::Handler<LinkControl>(this, &LinkControl::handle_output));

    /** Other configuration here */
}
#include <sst/core/component.h> // or
#include <sst/core/subcomponent.h> // or
#include <sst/core/componentExtension.h>