path: root/Documentation/btrfstune.asciidoc
diff options
Diffstat (limited to 'Documentation/btrfstune.asciidoc')
1 files changed, 44 insertions, 0 deletions
diff --git a/Documentation/btrfstune.asciidoc b/Documentation/btrfstune.asciidoc
new file mode 100644
index 00000000..96202211
--- /dev/null
+++ b/Documentation/btrfstune.asciidoc
@@ -0,0 +1,44 @@
+btrfstune - tune various btrfs filesystem parameters
+*btrfstune* [options] <dev> [<dev>...]
+*btrfstune* is used to tune various btrfs filesystem parameters,you can
+enable/disable some extended features for btrfs.
+-S <value>::
+Updates the seeding value.
+A positive value will enable seeding, zero will disable seeding, negtive is not allowed.
+Enable seeding forces a fs readonly so that you can use it to build other filesystems.
+Enable extended inode refs.
+Enable skinny metadata extent refs.
+Allow dangerous changes, e.g. clear the seeding flag. Make sure that you are
+aware of the dangers.
+When mounting the new device, btrfs will check whether the seeding flag is set
+when try to open seeding device. If the user clears the seeding flag of the
+seeding device, the new device will not be mountable. Even setting the seeding
+flag back will not fix this problem, because the generation will be changed at
+that time. Clear the seeding flag may damage the new filesystem.
+*btrfstune* will return 0 if no error happened.
+If any problems happened, 1 will be returned.