From 7cef4559fecc1b0ed1ebd0420773ac714b62bf64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Thalheim?= <joerg@thalheim.io>
Date: Fri, 23 May 2025 10:34:49 +0200
Subject: [PATCH] util/json-log-path: document unix sockets and concurrency
 issues

---
 src/libutil/include/nix/util/logging.hh | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/libutil/include/nix/util/logging.hh b/src/libutil/include/nix/util/logging.hh
index f2064b74d..765975faa 100644
--- a/src/libutil/include/nix/util/logging.hh
+++ b/src/libutil/include/nix/util/logging.hh
@@ -55,9 +55,11 @@ struct LoggerSettings : Config
     Setting<Path> jsonLogPath{
         this, "", "json-log-path",
         R"(
-          A path to which JSON records of Nix's log output will be
+          A file or unix socket to which JSON records of Nix's log output will be
           written, in the same format as `--log-format internal-json`
           (without the `@nix ` prefixes on each line).
+          Concurrent writes to the same file by multiple Nix processes are not supported and
+          may result in interleaved or corrupted log records.
         )"};
 };