Skip to main content
`Ctrl`+`K`

# PetscLogTraceBegin

Begins trace logging. Every time a PETSc event begins or ends, the event name is printed.

## Synopsis

    #include "petscsys.h"
    PetscErrorCode PetscLogTraceBegin(FILE *file)

Logically Collective on `PETSC_COMM_WORLD`

## Input Parameter

- file - The file to print trace in (e.g. stdout)

## Options Database Key

- -log_trace [filename] - Begins `PetscLogTraceBegin()`

## Notes

`PetscLogTraceBegin()` prints the processor number, the execution time (sec), then “Event begin:” or “Event end:” followed by the event name.

`PetscLogTraceBegin()` allows tracing of all PETSc calls, which is useful to determine where a program is hanging without running in the debugger. Can be used in conjunction with the -info option.

## See Also

Profiling, `PetscLogDump()`, `PetscLogView()`, `PetscLogDefaultBegin()`

## Level

intermediate

## Location

src/sys/logging/plog.c

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