Skip to main content
`Ctrl`+`K`

# 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 Log routines
Table of Contents for all manual pages
Index of all manual pages