]>
Commit | Line | Data |
---|---|---|
81567caf JH |
1 | Trace2 config settings are only read from the system and global |
2 | config files; repository local and worktree config files and `-c` | |
3 | command line arguments are not respected. | |
4 | ||
5 | trace2.normalTarget:: | |
6 | This variable controls the normal target destination. | |
e4b75d6a | 7 | It may be overridden by the `GIT_TRACE2` environment variable. |
81567caf JH |
8 | The following table shows possible values. |
9 | ||
10 | trace2.perfTarget:: | |
11 | This variable controls the performance target destination. | |
e4b75d6a | 12 | It may be overridden by the `GIT_TRACE2_PERF` environment variable. |
81567caf JH |
13 | The following table shows possible values. |
14 | ||
15 | trace2.eventTarget:: | |
16 | This variable controls the event target destination. | |
e4b75d6a | 17 | It may be overridden by the `GIT_TRACE2_EVENT` environment variable. |
81567caf JH |
18 | The following table shows possible values. |
19 | + | |
20 | include::../trace2-target-values.txt[] | |
21 | ||
22 | trace2.normalBrief:: | |
23 | Boolean. When true `time`, `filename`, and `line` fields are | |
24 | omitted from normal output. May be overridden by the | |
e4b75d6a | 25 | `GIT_TRACE2_BRIEF` environment variable. Defaults to false. |
81567caf JH |
26 | |
27 | trace2.perfBrief:: | |
28 | Boolean. When true `time`, `filename`, and `line` fields are | |
29 | omitted from PERF output. May be overridden by the | |
e4b75d6a | 30 | `GIT_TRACE2_PERF_BRIEF` environment variable. Defaults to false. |
81567caf JH |
31 | |
32 | trace2.eventBrief:: | |
33 | Boolean. When true `time`, `filename`, and `line` fields are | |
34 | omitted from event output. May be overridden by the | |
e4b75d6a | 35 | `GIT_TRACE2_EVENT_BRIEF` environment variable. Defaults to false. |
81567caf JH |
36 | |
37 | trace2.eventNesting:: | |
38 | Integer. Specifies desired depth of nested regions in the | |
39 | event output. Regions deeper than this value will be | |
e4b75d6a | 40 | omitted. May be overridden by the `GIT_TRACE2_EVENT_NESTING` |
81567caf JH |
41 | environment variable. Defaults to 2. |
42 | ||
43 | trace2.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. | |
e4b75d6a | 48 | May be overridden by the `GIT_TRACE2_CONFIG_PARAMS` environment |
81567caf JH |
49 | variable. Unset by default. |
50 | ||
3d3adaad JS |
51 | trace2.envVars:: |
52 | A comma-separated list of "important" environment variables that should | |
53 | be recorded in the trace2 output. For example, | |
54 | `GIT_HTTP_USER_AGENT,GIT_CONFIG` would cause the trace2 output to | |
55 | contain events listing the overrides for HTTP user agent and the | |
56 | location of the Git configuration file (assuming any are set). May be | |
7efc3782 | 57 | overridden by the `GIT_TRACE2_ENV_VARS` environment variable. Unset by |
3d3adaad JS |
58 | default. |
59 | ||
81567caf JH |
60 | trace2.destinationDebug:: |
61 | Boolean. When true Git will print error messages when a | |
62 | trace target destination cannot be opened for writing. | |
63 | By default, these errors are suppressed and tracing is | |
64 | silently disabled. May be overridden by the | |
e4b75d6a | 65 | `GIT_TRACE2_DST_DEBUG` environment variable. |
83e57b04 JS |
66 | |
67 | trace2.maxFiles:: | |
68 | Integer. When writing trace files to a target directory, do not | |
69 | write additional traces if we would exceed this many files. Instead, | |
70 | write a sentinel file that will block further tracing to this | |
71 | directory. Defaults to 0, which disables this check. |