summaryrefslogtreecommitdiff
path: root/Documentation/technical/api-trace2.txt
diff options
context:
space:
mode:
authorJosh Steadmon <steadmon@google.com>2019-03-21 21:09:51 (GMT)
committerJunio C Hamano <gitster@pobox.com>2019-03-22 05:27:02 (GMT)
commita4d3a283db5259cc372809da4dc085c3f40aebfb (patch)
tree2f96ae786a221e5ff3bc23abe950c9e119666f91 /Documentation/technical/api-trace2.txt
parent041f5ea1cf987a4068ef5f39ba0a09be85952064 (diff)
downloadgit-a4d3a283db5259cc372809da4dc085c3f40aebfb.zip
git-a4d3a283db5259cc372809da4dc085c3f40aebfb.tar.gz
git-a4d3a283db5259cc372809da4dc085c3f40aebfb.tar.bz2
trace2: write to directory targets
When the value of a trace2 environment variable is an absolute path referring to an existing directory, write output to files (one per process) underneath the given directory. Files will be named according to the final component of the trace2 SID, followed by a counter to avoid potential collisions. This makes it more convenient to collect traces for every git invocation by unconditionally setting the relevant trace2 envvar to a constant directory name. Signed-off-by: Josh Steadmon <steadmon@google.com> Reviewed-by: Jeff Hostetler <jeffhost@microsoft.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/technical/api-trace2.txt')
-rw-r--r--Documentation/technical/api-trace2.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/Documentation/technical/api-trace2.txt b/Documentation/technical/api-trace2.txt
index 2de565f..d0948ba 100644
--- a/Documentation/technical/api-trace2.txt
+++ b/Documentation/technical/api-trace2.txt
@@ -109,6 +109,11 @@ values are recognized.
Enables the target, opens and writes to the file in append mode.
+ If the target already exists and is a directory, the traces will be
+ written to files (one per process) underneath the given directory. They
+ will be named according to the last component of the SID (optionally
+ followed by a counter to avoid filename collisions).
+
`af_unix:[<socket_type>:]<absolute-pathname>`::
Enables the target, opens and writes to a Unix Domain Socket