PetscLogEventsPause#

Put event logging into “paused” mode: timers and counters for in-progress events are paused, and any events that happen before logging is resumed with PetscLogEventsResume() are logged in the “Main Stage” of execution.

Synopsis#

#include "petscsys.h"   
PetscErrorCode PetscLogEventsPause(void)

Not collective

Notes#

When an external library or runtime has is initialized it can involve lots of setup time that skews the statistics of any unrelated running events: this function is intended to isolate such calls in the default log summary (PetscLogDefaultBegin(), PetscLogView()).

Other log handlers (such as the nested handler, PetscLogNestedBegin()) will ignore this function.

See Also#

Profiling, PetscLogEventDeactivatePush(), PetscLogEventDeactivatePop(), PetscLogEventsResume(), PetscLogGetDefaultHandler()

Level#

advanced

Location#

src/sys/logging/plog.c


Index of all Profiling routines
Table of Contents for all manual pages
Index of all manual pages