core.fsyncmethod: add writeout-only mode

[thirdparty/git.git] / Documentation / config / core.txt

diff --git a/Documentation/config/core.txt b/Documentation/config/core.txt
index c04f62a54a154cd6315f974844c52c950d715c3c..dbb134f7136e96fc0440da3628bfdd10f8787058 100644 (file)
--- a/Documentation/config/core.txt
+++ b/Documentation/config/core.txt
@@ -547,6 +547,15 @@ core.whitespace::
   is relevant for `indent-with-non-tab` and when Git fixes `tab-in-indent`
   errors. The default tab width is 8. Allowed values are 1 to 63.
 
+core.fsyncMethod::
+       A value indicating the strategy Git will use to harden repository data
+       using fsync and related primitives.
++
+* `fsync` uses the fsync() system call or platform equivalents.
+* `writeout-only` issues pagecache writeback requests, but depending on the
+  filesystem and storage hardware, data added to the repository may not be
+  durable in the event of a system crash. This is the default mode on macOS.
+
 core.fsyncObjectFiles::
        This boolean will enable 'fsync()' when writing object files.
 +