summaryrefslogtreecommitdiffstats
path: root/git.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-05-30 11:17:47 -0700
committerJunio C Hamano <gitster@pobox.com>2019-05-30 11:17:47 -0700
commitc01eecf936b3fc58968e889f0c1e7ab7340df593 (patch)
treedcf6c9920dfcc4ba892021391755631a78fefcb7 /git.html
parent56d696ee5be4d6ce871726df6e396c76eedcccf0 (diff)
downloadgit-htmldocs-c01eecf936b3fc58968e889f0c1e7ab7340df593.tar.gz
Autogenerated HTML docs for v2.22.0-rc2
Diffstat (limited to 'git.html')
-rw-r--r--git.html49
1 files changed, 35 insertions, 14 deletions
diff --git a/git.html b/git.html
index 726b5ae88..dc3f5281e 100644
--- a/git.html
+++ b/git.html
@@ -2907,38 +2907,59 @@ of clones and fetches.</p></div>
</p>
</dd>
<dt class="hdlist1">
-<code>GIT_TR2</code>
+<code>GIT_TRACE2</code>
</dt>
<dd>
<p>
Enables more detailed trace messages from the "trace2" library.
- Output from <code>GIT_TR2</code> is a simple text-based format for human
+ Output from <code>GIT_TRACE2</code> is a simple text-based format for human
readability.
</p>
-<div class="paragraph"><p>The <code>GIT_TR2</code> variables can take many values. Any value available to
-the <code>GIT_TRACE</code> variables is also available to <code>GIT_TR2</code>. The <code>GIT_TR2</code>
-variables can also specify a Unix Domain Socket. See
-<a href="technical/api-trace2.html">Trace2 documentation</a> for full details.</p></div>
+<div class="paragraph"><p>If this variable is set to "1", "2" or "true" (comparison
+is case insensitive), trace messages will be printed to
+stderr.</p></div>
+<div class="paragraph"><p>If the variable is set to an integer value greater than 2
+and lower than 10 (strictly) then Git will interpret this
+value as an open file descriptor and will try to write the
+trace messages into this file descriptor.</p></div>
+<div class="paragraph"><p>Alternatively, if the variable is set to an absolute path
+(starting with a <em>/</em> character), Git will interpret this
+as a file path and will try to append the trace messages
+to it. If the path already exists and is a directory, the
+trace messages will be written to files (one per process)
+in that directory, named according to the last component
+of the SID and an optional counter (to avoid filename
+collisions).</p></div>
+<div class="paragraph"><p>In addition, if the variable is set to
+<code>af_unix:[&lt;socket_type&gt;:]&lt;absolute-pathname&gt;</code>, Git will try
+to open the path as a Unix Domain Socket. The socket type
+can be either <code>stream</code> or <code>dgram</code>.</p></div>
+<div class="paragraph"><p>Unsetting the variable, or setting it to empty, "0" or
+"false" (case insensitive) disables trace messages.</p></div>
+<div class="paragraph"><p>See <a href="technical/api-trace2.html">Trace2 documentation</a>
+for full details.</p></div>
</dd>
<dt class="hdlist1">
-<code>GIT_TR2_EVENT</code>
+<code>GIT_TRACE2_EVENT</code>
</dt>
<dd>
<p>
This setting writes a JSON-based format that is suited for machine
- interpretation. See <a href="technical/api-trace2.html">Trace2 documentation</a>
- for full details.
+ interpretation.
+ See <code>GIT_TRACE2</code> for available trace output options and
+ <a href="technical/api-trace2.html">Trace2 documentation</a> for full details.
</p>
</dd>
<dt class="hdlist1">
-<code>GIT_TR2_PERF</code>
+<code>GIT_TRACE2_PERF</code>
</dt>
<dd>
<p>
- In addition to the text-based messages available in <code>GIT_TR2</code>, this
+ In addition to the text-based messages available in <code>GIT_TRACE2</code>, this
setting writes a column-based format for understanding nesting
- regions. See <a href="technical/api-trace2.html">Trace2 documentation</a>
- for full details.
+ regions.
+ See <code>GIT_TRACE2</code> for available trace output options and
+ <a href="technical/api-trace2.html">Trace2 documentation</a> for full details.
</p>
</dd>
<dt class="hdlist1">
@@ -3227,7 +3248,7 @@ the Git Security mailing list &lt;<a href="mailto:git-security@googlegroups.com"
<div id="footer">
<div id="footer-text">
Last updated
- 2019-05-19 17:58:26 JST
+ 2019-05-30 11:14:50 PDT
</div>
</div>
</body>