Documentation / config / trace2.txton commit Merge branch 'ba/clone-remote-submodules' (9476094)
   1Trace2 config settings are only read from the system and global
   2config files; repository local and worktree config files and `-c`
   3command line arguments are not respected.
   4
   5trace2.normalTarget::
   6        This variable controls the normal target destination.
   7        It may be overridden by the `GIT_TRACE2` environment variable.
   8        The following table shows possible values.
   9
  10trace2.perfTarget::
  11        This variable controls the performance target destination.
  12        It may be overridden by the `GIT_TRACE2_PERF` environment variable.
  13        The following table shows possible values.
  14
  15trace2.eventTarget::
  16        This variable controls the event target destination.
  17        It may be overridden by the `GIT_TRACE2_EVENT` environment variable.
  18        The following table shows possible values.
  19+
  20include::../trace2-target-values.txt[]
  21
  22trace2.normalBrief::
  23        Boolean.  When true `time`, `filename`, and `line` fields are
  24        omitted from normal output.  May be overridden by the
  25        `GIT_TRACE2_BRIEF` environment variable.  Defaults to false.
  26
  27trace2.perfBrief::
  28        Boolean.  When true `time`, `filename`, and `line` fields are
  29        omitted from PERF output.  May be overridden by the
  30        `GIT_TRACE2_PERF_BRIEF` environment variable.  Defaults to false.
  31
  32trace2.eventBrief::
  33        Boolean.  When true `time`, `filename`, and `line` fields are
  34        omitted from event output.  May be overridden by the
  35        `GIT_TRACE2_EVENT_BRIEF` environment variable.  Defaults to false.
  36
  37trace2.eventNesting::
  38        Integer.  Specifies desired depth of nested regions in the
  39        event output.  Regions deeper than this value will be
  40        omitted.  May be overridden by the `GIT_TRACE2_EVENT_NESTING`
  41        environment variable.  Defaults to 2.
  42
  43trace2.configParams::
  44        A comma-separated list of patterns of "important" config
  45        settings that should be recorded in the trace2 output.
  46        For example, `core.*,remote.*.url` would cause the trace2
  47        output to contain events listing each configured remote.
  48        May be overridden by the `GIT_TRACE2_CONFIG_PARAMS` environment
  49        variable.  Unset by default.
  50
  51trace2.destinationDebug::
  52        Boolean.  When true Git will print error messages when a
  53        trace target destination cannot be opened for writing.
  54        By default, these errors are suppressed and tracing is
  55        silently disabled.  May be overridden by the
  56        `GIT_TRACE2_DST_DEBUG` environment variable.