summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorQu Wenruo <quwenruo@cn.fujitsu.com>2015-05-15 14:28:26 +0800
committerDavid Sterba <dsterba@suse.cz>2015-05-26 17:21:47 +0200
commit99ad3805beed9f527830c2d07118718872224e9f (patch)
tree2686567009b7ad037283c8a27df859734fe48902
parent5fd37009daec2447c0a27664995f356768e1a204 (diff)
btrfs-progs: Documentation: uuid change
Signed-off-by: Qu Wenruo <quwenruo@cn.fujitsu.com> [updated wodring] Signed-off-by: David Sterba <dsterba@suse.cz>
-rw-r--r--Documentation/btrfstune.asciidoc18
1 files changed, 16 insertions, 2 deletions
diff --git a/Documentation/btrfstune.asciidoc b/Documentation/btrfstune.asciidoc
index 96202211..b6edcb20 100644
--- a/Documentation/btrfstune.asciidoc
+++ b/Documentation/btrfstune.asciidoc
@@ -25,8 +25,22 @@ Enable extended inode refs.
-x::
Enable skinny metadata extent refs.
-f::
-Allow dangerous changes, e.g. clear the seeding flag. Make sure that you are
-aware of the dangers.
+Allow dangerous changes, e.g. clear the seeding flag or change fsid. Make sure
+that you are aware of the dangers.
+-u::
+Change fsid to a random generated UUID or continue previous change operation in
+case it was interrupted with the original UUID.
+-U <UUID>::
+Change fsid to <UUID>.
++
+The <UUID> should be a 36 bytes string in `printf`(3) format
+"%08x-%04x-%04x-%04x-%012x".
+If there is a previous unfinished fsid change, it will only continue if the
+<UUID> matches the unfinished one.
+
+WARNING: Cancelling or interrupting a UUID change operation will make the
+filesystem temporarily unmountable. To fix it, rerun 'btrfstune -u' to restore
+the UUID and wait it complete.
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