IOGroup that wraps interfaces to Compute Node Linux. More...

#include <CNLIOGroup.hpp>

Inheritance diagram for geopm::CNLIOGroup:

Collaboration diagram for geopm::CNLIOGroup:

Public Member Functions
	CNLIOGroup ()

	CNLIOGroup (const std::string &pm_counters_path)

virtual	~CNLIOGroup ()=default

std::set< std::string >	signal_names (void) const override

std::set< std::string >	control_names (void) const override

bool	is_valid_signal (const std::string &signal_name) const override

bool	is_valid_control (const std::string &control_name) const override

int	signal_domain_type (const std::string &signal_name) const override

int	control_domain_type (const std::string &control_name) const override

int	push_signal (const std::string &signal_name, int domain_type, int domain_idx) override

int	push_control (const std::string &control_name, int domain_type, int domain_idx) override
	Should not be called; this IOGroup does not provide any controls. More...

void	read_batch (void) override
	Read all pushed signals from the platform so that the next call to sample() will reflect the updated data. More...

void	write_batch (void) override
	Does nothing; this IOGroup does not provide any controls. More...

double	sample (int batch_idx) override

void	adjust (int batch_idx, double setting) override
	Should not be called; this IOGroup does not provide any controls. More...

double	read_signal (const std::string &signal_name, int domain_type, int domain_idx) override

void	write_control (const std::string &control_name, int domain_type, int domain_idx, double setting) override
	Should not be called; this IOGroup does not provide any controls. More...

void	save_control (void) override
	Does nothing; this IOGroup does not provide any controls. More...

void	restore_control (void) override
	Does nothing; this IOGroup does not provide any controls. More...

std::function< double(const std::vector< double > &)>	agg_function (const std::string &signal_name) const override

std::function< std::string(double)>	format_function (const std::string &signal_name) const override

std::string	signal_description (const std::string &signal_name) const override

std::string	control_description (const std::string &control_name) const override
	Should not be called; this IOGroup does not provide any controls. More...

int	signal_behavior (const std::string &signal_name) const override

void	save_control (const std::string &save_path) override
	Does nothing; this IOGroup does not provide any controls. More...

void	restore_control (const std::string &save_path) override
	Does nothing; this IOGroup does not provide any controls. More...

std::string	name (void) const override

Public Member Functions inherited from geopm::IOGroup
	IOGroup ()=default

virtual	~IOGroup ()=default

Static Public Member Functions
static std::string	plugin_name (void)

static std::unique_ptr< IOGroup >	make_plugin (void)

Static Public Member Functions inherited from geopm::IOGroup
static std::vector< std::string >	iogroup_names (void)

static std::unique_ptr< IOGroup >	make_unique (const std::string &iogroup_name)

static m_units_e	string_to_units (const std::string &str)
	Convert a string to the corresponding m_units_e value. More...

static std::string	units_to_string (int)
	Convert the m_units_e value to the corresponding string. More...

static m_signal_behavior_e	string_to_behavior (const std::string &str)
	Convert a string to the corresponding m_signal_behavior_e value. More...

Additional Inherited Members
Public Types inherited from geopm::IOGroup
enum	m_units_e { M_UNITS_NONE , M_UNITS_SECONDS , M_UNITS_HERTZ , M_UNITS_WATTS , M_UNITS_JOULES , M_UNITS_CELSIUS , M_UNITS_AMPERES , M_UNITS_VOLTS , M_NUM_UNITS }

enum	m_signal_behavior_e { M_SIGNAL_BEHAVIOR_CONSTANT , M_SIGNAL_BEHAVIOR_MONOTONE , M_SIGNAL_BEHAVIOR_VARIABLE , M_SIGNAL_BEHAVIOR_LABEL , M_NUM_SIGNAL_BEHAVIOR }
	Description of the runtime behavior of a signal. More...

Static Public Attributes inherited from geopm::IOGroup
static const std::string	M_PLUGIN_PREFIX = "libgeopmiogroup_"

Detailed Description

IOGroup that wraps interfaces to Compute Node Linux.

The CNLIOGroup provides board-level energy counters from Compute Node Linux as signals. These values are obtained through the proc(5)

Constructor & Destructor Documentation

◆ CNLIOGroup() [1/2]

geopm::CNLIOGroup::CNLIOGroup ( )

◆ CNLIOGroup() [2/2]

geopm::CNLIOGroup::CNLIOGroup ( const std::string & pm_counters_path )

◆ ~CNLIOGroup()

virtual geopm::CNLIOGroup::~CNLIOGroup ( )

virtualdefault

Member Function Documentation

◆ adjust()

void geopm::CNLIOGroup::adjust	(	int	batch_idx,
		double	setting
	)

overridevirtual

Should not be called; this IOGroup does not provide any controls.

Exceptions

geopm::Exception there are no controls supported by the CNLIOGroup

Implements geopm::IOGroup.

◆ agg_function()

std::function< double(const std::vector< double > &)> geopm::CNLIOGroup::agg_function ( const std::string & signal_name ) const

overridevirtual

Parameters

signal_name Specifies the name of the signal to be used for aggregation.

Returns: a function that should be used when aggregating the given signal.

See also: geopm::Agg

Implements geopm::IOGroup.

◆ control_description()

std::string geopm::CNLIOGroup::control_description ( const std::string & control_name ) const

overridevirtual

Should not be called; this IOGroup does not provide any controls.

Exceptions

geopm::Exception there are no controls supported by the CNLIOGroup

Implements geopm::IOGroup.

◆ control_domain_type()

int geopm::CNLIOGroup::control_domain_type ( const std::string & control_name ) const

overridevirtual

Returns: GEOPM_DOMAIN_INVALID; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ control_names()

std::set< std::string > geopm::CNLIOGroup::control_names ( void ) const

overridevirtual

Returns: empty set; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ format_function()

std::function< std::string(double)> geopm::CNLIOGroup::format_function ( const std::string & signal_name ) const

overridevirtual

Returns: a function that should be used when formatting the given signal.

See also: geopm::Agg

Reimplemented from geopm::IOGroup.

◆ is_valid_control()

bool geopm::CNLIOGroup::is_valid_control ( const std::string & control_name ) const

overridevirtual

Returns: false; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ is_valid_signal()

bool geopm::CNLIOGroup::is_valid_signal ( const std::string & signal_name ) const

overridevirtual

Returns: whether the given signal_name is supported by the CNLIOGroup for the current platform.

Implements geopm::IOGroup.

◆ make_plugin()

std::unique_ptr< IOGroup > geopm::CNLIOGroup::make_plugin ( void )

static

Returns: a pointer to a new CNLIOGroup object

See also: geopm::PluginFactory

◆ name()

std::string geopm::CNLIOGroup::name ( void ) const

overridevirtual

Returns: the name of the IOGroup

Implements geopm::IOGroup.

◆ plugin_name()

std::string geopm::CNLIOGroup::plugin_name ( void )

static

Returns: the name of the plugin to use when this plugin is registered with the IOGroup factory

See also: geopm::PluginFactory

◆ push_control()

int geopm::CNLIOGroup::push_control	(	const std::string &	control_name,
		int	domain_type,
		int	domain_idx
	)

overridevirtual

Should not be called; this IOGroup does not provide any controls.

Exceptions

geopm::Exception there are no controls supported by the CNLIOGroup

Implements geopm::IOGroup.

◆ push_signal()

int geopm::CNLIOGroup::push_signal	(	const std::string &	signal_name,
		int	domain_type,
		int	domain_idx
	)

overridevirtual

Parameters

signal_name	Adds the signal specified to the list of signals to be read during read_batch()
domain_type	This must be == GEOPM_DOMAIN_BOARD
domain_idx	is ignored

Exceptions

geopm::Exception if signal_name is not valid if domain_type is not GEOPM_DOMAIN_BOARD

Implements geopm::IOGroup.

◆ read_batch()

void geopm::CNLIOGroup::read_batch ( void )

overridevirtual

Read all pushed signals from the platform so that the next call to sample() will reflect the updated data.

The intention is that read_batch() will read the all of the IOGroup's signals into memory once per call.

Implements geopm::IOGroup.

◆ read_signal()

double geopm::CNLIOGroup::read_signal	(	const std::string &	signal_name,
		int	domain_type,
		int	domain_idx
	)

overridevirtual

Parameters

signal_name	Specifies the name of the signal whose value you want to get.
domain_type	This must be == GEOPM_DOMAIN_BOARD
domain_idx	is ignored

Exceptions

geopm::Exception if signal_name is not valid if domain_type is not GEOPM_DOMAIN_BOARD

Returns: the stored value for the given signal_name.

Implements geopm::IOGroup.

◆ restore_control() [1/2]

void geopm::CNLIOGroup::restore_control ( const std::string & save_path )

overridevirtual

Does nothing; this IOGroup does not provide any controls.

Parameters

save_path this argument is ignored

Implements geopm::IOGroup.

◆ restore_control() [2/2]

void geopm::CNLIOGroup::restore_control ( void )

overridevirtual

Does nothing; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ sample()

double geopm::CNLIOGroup::sample ( int batch_idx )

overridevirtual

Parameters

batch_idx Specifies a signal_idx returned from push_signal()

Returns: the value of the signal specified by a signal_idx returned from push_signal().

The value will have been updated by the most recent call to read_batch().

Implements geopm::IOGroup.

◆ save_control() [1/2]

void geopm::CNLIOGroup::save_control ( const std::string & save_path )

overridevirtual

Does nothing; this IOGroup does not provide any controls.

Parameters

save_path this argument is ignored

Implements geopm::IOGroup.

◆ save_control() [2/2]

void geopm::CNLIOGroup::save_control ( void )

overridevirtual

Does nothing; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ signal_behavior()

int geopm::CNLIOGroup::signal_behavior ( const std::string & signal_name ) const

overridevirtual

Returns: one of the IOGroup::signal_behavior_e values which describes about how a signal will change as a function of time.

This can be used when generating reports to decide how to summarize a signal's value for the entire application run.

Implements geopm::IOGroup.

◆ signal_description()

std::string geopm::CNLIOGroup::signal_description ( const std::string & signal_name ) const

overridevirtual

Returns: a string description for signal_name, if defined.

Implements geopm::IOGroup.

◆ signal_domain_type()

int geopm::CNLIOGroup::signal_domain_type ( const std::string & signal_name ) const

overridevirtual

Returns: GEOPM_DOMAIN_BOARD; If the signal_name is valid for this IOGroup, GEOPM_DOMAIN_INVALID otherwise if the signal_name is invalid for this IOGroup.

Implements geopm::IOGroup.

◆ signal_names()

std::set< std::string > geopm::CNLIOGroup::signal_names ( void ) const

overridevirtual

Returns: the list of signal names provided by this IOGroup.

Implements geopm::IOGroup.

◆ write_batch()

void geopm::CNLIOGroup::write_batch ( void )

overridevirtual

Does nothing; this IOGroup does not provide any controls.

Implements geopm::IOGroup.

◆ write_control()

void geopm::CNLIOGroup::write_control	(	const std::string &	control_name,
		int	domain_type,
		int	domain_idx,
		double	setting
	)

overridevirtual

Should not be called; this IOGroup does not provide any controls.

Exceptions

geopm::Exception there are no controls supported by the CNLIOGroup

Implements geopm::IOGroup.

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

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CNLIOGroup() [1/2]

◆ CNLIOGroup() [2/2]

◆ ~CNLIOGroup()

Member Function Documentation

◆ adjust()

◆ agg_function()

◆ control_description()

◆ control_domain_type()

◆ control_names()

◆ format_function()

◆ is_valid_control()

◆ is_valid_signal()

◆ make_plugin()

◆ name()

◆ plugin_name()

◆ push_control()

◆ push_signal()

◆ read_batch()

◆ read_signal()

◆ restore_control() [1/2]

◆ restore_control() [2/2]

◆ sample()

◆ save_control() [1/2]

◆ save_control() [2/2]

◆ signal_behavior()

◆ signal_description()

◆ signal_domain_type()

◆ signal_names()

◆ write_batch()

◆ write_control()