Skip to main content

fatal

void fatal(uint32_t line, const char* file, const char* func, int exit_code, const char* format, ...) const __attribute__((format(printf, 6, 7)));

Convenience function for reporting fatal error conditions. The function creates a new Output() object and calls fatal() using the supplied parameters. Before calling fatal(), the function will also print information about the PortModule that called fatal as well as general simulation state.

Parameters​

  • line (uint32_t) Line number of calling function (use CALL_INFO macro)
  • file (char*) File name of calling function (use CALL_INFO macro)
  • func (char*) Name of function that called fatal (use CALL_INFO macro)
  • exit_code (int) Exit code to terminate with. This will be passed to MPI_Abort().
  • format (string) Format string for error message. All valid formats for printf() are available.
  • ... (Variable) Arguments for format
  • returns None

The CALL_INFO and CALL_INFO_LONG macros can be used to easily provide the first three parameters.

Example​

if (fatal_error_condition)
    fatal(CALL_INFO, -1, "Error, something terrible happened to port module %s.\n", getName().c_str());
#include <sst/core/portModule.h>