This version of ns3::ExampleTestCase is specialized for MPI by accepting the number of ranks as a parameter, then building a --command-template string which invokes mpiexec correctly to execute MPI examples. More...

Inheritance diagram for MpiTestCase:

Collaboration diagram for MpiTestCase:

Public Member Functions
	MpiTestCase (const std::string name, const std::string program, const std::string dataDir, const int ranks, const std::string args="")
	Constructor. More...

virtual	~MpiTestCase (void)
	Destructor. More...

std::string	GetCommandTemplate (void) const
	Produce the `--command-template` argument which will invoke `mpiexec` with the requested number of ranks. More...

std::string	GetPostProcessingCommand (void) const
	Sort the output from parallel execution. More...

Public Member Functions inherited from ns3::ExampleAsTestCase
	ExampleAsTestCase (const std::string name, const std::string program, const std::string dataDir, const std::string args="")
	Constructor. More...

virtual	~ExampleAsTestCase (void)
	Destructor. More...

virtual void	DoRun (void)
	Implementation to actually run this TestCase. More...

virtual std::string	GetCommandTemplate (void) const
	Customization point for more complicated patterns to invoke the example program. More...

virtual std::string	GetPostProcessingCommand (void) const
	Customization point for tests requiring post-processing of stdout. More...

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor. More...

std::string	GetName (void) const

TestCase &	operator= (const TestCase &)=delete

Private Attributes
int	m_ranks
	The number of ranks. More...

Additional Inherited Members
Public Types inherited from ns3::TestCase
enum	TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
	How long the test takes to execute. More...

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor. More...

void	AddTestCase (TestCase *testCase, TestDuration duration=QUICK)
	Add an individual child TestCase to this test suite. More...

TestCase *	GetParent () const
	Get the parent of this TestCsse. More...

bool	IsStatusFailure (void) const
	Check if any tests failed. More...

bool	IsStatusSuccess (void) const
	Check if all tests passed. More...

void	SetDataDir (std::string directory)
	Set the data directory where reference trace files can be found. More...

void	ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
	Log the failure of this TestCase. More...

bool	MustAssertOnFailure (void) const
	Check if this run should assert on failure. More...

bool	MustContinueOnFailure (void) const
	Check if this run should continue on failure. More...

std::string	CreateDataDirFilename (std::string filename)
	Construct the full path to a file in the data directory. More...

std::string	CreateTempDirFilename (std::string filename)
	Construct the full path to a file in a temporary directory. More...

Protected Attributes inherited from ns3::ExampleAsTestCase
std::string	m_args
	Any additional arguments to the program. More...

std::string	m_dataDir
	The source directory for the test. More...

std::string	m_program
	The program to run. More...

Detailed Description

This version of ns3::ExampleTestCase is specialized for MPI by accepting the number of ranks as a parameter, then building a --command-template string which invokes mpiexec correctly to execute MPI examples.

Definition at line 35 of file mpi-test-suite.cc.

Constructor & Destructor Documentation

◆ MpiTestCase()

MpiTestCase::MpiTestCase	(	const std::string	name,
		const std::string	program,
		const std::string	dataDir,
		const int	ranks,
		const std::string	args = `""`
	)

Constructor.

Parameters

[in]	name	The test case name, typically the program name and summary of the arguments, such as `my-example-foo`
[in]	program	The actual example program names, such as `my-example`
[in]	dataDir	The location of the reference file. This is normally provided by the symbol `NS_TEST_SOURCEDIR` in the `module-examples-test-suite.cc` file. The reference file should be named after the test case name, for example `my-example-foo.log`. If you use the `--update` argument to `test.py` or `test-runner` the reference file will be created with the correct name.
[in]	args	Any additional arguments to the program.
[in]	ranks	The number of ranks to use

Definition at line 74 of file mpi-test-suite.cc.

◆ ~MpiTestCase()

virtual MpiTestCase::~MpiTestCase ( void )

inlinevirtual

Destructor.

Definition at line 50 of file mpi-test-suite.cc.

Member Function Documentation

◆ GetCommandTemplate()

std::string MpiTestCase::GetCommandTemplate ( void ) const

virtual

Produce the --command-template argument which will invoke mpiexec with the requested number of ranks.

Returns: The --command-template string.

Reimplemented from ns3::ExampleAsTestCase.

Definition at line 85 of file mpi-test-suite.cc.

References ns3::ExampleAsTestCase::m_args, and m_ranks.

◆ GetPostProcessingCommand()

std::string MpiTestCase::GetPostProcessingCommand ( void ) const

virtual

Sort the output from parallel execution.

stdout from multiple ranks is not ordered.

Returns: Sort command

Reimplemented from ns3::ExampleAsTestCase.

Definition at line 93 of file mpi-test-suite.cc.

Member Data Documentation

◆ m_ranks

int MpiTestCase::m_ranks

private

The number of ranks.

Definition at line 71 of file mpi-test-suite.cc.

Referenced by GetCommandTemplate().

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

src/mpi/test/mpi-test-suite.cc

Public Member Functions

Private Attributes

Additional Inherited Members