Logging

divERGe includes a C style logging facility with a bunch of macros mpi_???_printf and a loglevel setter mpi_loglevel_set(). For usage from python, we provide mpi_py_print() and friends.

void mpi_printf(const char *fmt, ...)

act like printf(fmt, ...), but only produce an output on rank 0

void mpi_eprintf(const char *fmt, ...)

act like fprintf(stderr, fmt, ...), but only produce an output on rank 0

void mpi_fprintf(FILE *file, const char *fmt, ...)

act like fprintf(file, fmt, ...), but only produce an output on rank 0

void mpi_lll_printf(mpi_loglevel_t loglevel, const char *fmt, ...)

act like printf(fmt, ...), but only produce an output on rank 0 and if loglevel is satisfied

mpi_tim_printf(...)

debug time measurement (loglevel 2)

mpi_err_printf(...)

print error message (loglevel 0)

mpi_err_printf_all(...)

print error message on all ranks (loglevel 0)

mpi_wrn_printf(...)

print warning message (loglevel 1)

mpi_scc_printf(...)

print success message (loglevel 3)

mpi_log_printf_all(...)

print log message (loglevel 4) from all ranks

mpi_log_printf(...)

print log message (loglevel 4)

mpi_vrb_printf_all(...)

print verbose message (loglevel 5, off by default) from all ranks

mpi_vrb_printf(...)

print verbose message (loglevel 5, off by default)

mpi_fil_printf(...)

print file message (loglevel 3)

mpi_usr_printf(...)

print user message (loglevel 3)

mpi_ver_printf(...)

print version message (loglevel -1)

mpi_btr_printf(...)

print backtrace (loglevel 5, off by default)

void mpi_loglevel_set(mpi_loglevel_t loglevel)

set loglevel. all messages below this level are discarded and not printed

mpi_loglevel_t mpi_loglevel_get(void)

get current loglevel

void mpi_log_set_colors(int colors)

turn colors for all messages on/off

int mpi_log_get_colors(void)

are colors used in logging?

enum mpi_log_control_t

more control over logging behavior

enumerator mpi_log_control_standard = 0

logs to stderr, printf() to stdout

enumerator mpi_log_control_modified

logs to stdout, printf() to stdout

enumerator mpi_log_control_stderr

logs to stderr, printf() to stderr

enumerator mpi_log_control_inverted

logs to stdout, printf() to stderr

void mpi_log_control(mpi_log_control_t ctl)

control the output of diverge using mpi_log_control_t

void mpi_py_print(const char *str)

print to stdout from python including the diverge log prefix

void mpi_py_eprint(const char *str)

print to stderr from python including the diverge log prefix

void mpi_py_print_all(const char *str)

print to stdout from python from all ranks including the diverge log prefix

void mpi_py_eprint_all(const char *str)

print to stderr from python from all ranks including the diverge log prefix