summaryrefslogtreecommitdiff
path: root/Documentation/technical
diff options
context:
space:
mode:
authorLibravatar Josh Steadmon <steadmon@google.com>2019-03-21 14:09:51 -0700
committerLibravatar Junio C Hamano <gitster@pobox.com>2019-03-22 14:27:02 +0900
commita4d3a283db5259cc372809da4dc085c3f40aebfb (patch)
tree2f96ae786a221e5ff3bc23abe950c9e119666f91 /Documentation/technical
parentThe third batch (diff)
downloadtgif-a4d3a283db5259cc372809da4dc085c3f40aebfb.tar.xz
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')
-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 2de565fa3d..d0948ba250 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