summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/btrfs-man5.asciidoc15
1 files changed, 9 insertions, 6 deletions
diff --git a/Documentation/btrfs-man5.asciidoc b/Documentation/btrfs-man5.asciidoc
index a1f364e0..caa9390b 100644
--- a/Documentation/btrfs-man5.asciidoc
+++ b/Documentation/btrfs-man5.asciidoc
@@ -214,15 +214,18 @@ parameters, eg. 'panic', 'oops' or 'crashkernel'.
*flushoncommit*::
*noflushoncommit*::
-(default: on)
+(default: off)
+
This option forces any data dirtied by a write in a prior transaction to commit
-as part of the current commit. This makes the committed state a fully
-consistent view of the file system from the application's perspective (i.e., it
-includes all completed file system operations). This was previously the
-behavior only when a snapshot was created.
+as part of the current commit, effectively a full filesystem sync.
++
+This makes the committed state a fully consistent view of the file system from
+the application's perspective (i.e., it includes all completed file system
+operations). This was previously the behavior only when a snapshot was
+created.
+
-Disabling flushing may improve performance but is not crash-safe.
+When off, the filesystem is consistent but buffered writes may last more than
+one transaction commit.
*fragment='type'*::
(depends on compile-time option BTRFS_DEBUG, since: 4.4, default: off)