diff options
Diffstat (limited to 'Documentation/btrfs-subvolume.asciidoc')
-rw-r--r-- | Documentation/btrfs-subvolume.asciidoc | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/Documentation/btrfs-subvolume.asciidoc b/Documentation/btrfs-subvolume.asciidoc index c5298cc7..a8c4af4b 100644 --- a/Documentation/btrfs-subvolume.asciidoc +++ b/Documentation/btrfs-subvolume.asciidoc @@ -17,7 +17,7 @@ snapshots. SUBVOLUME AND SNAPSHOT ---------------------- -A subvolume is a part of filesystem with its own and independent +A subvolume is a part of filesystem with its own independent file/directory hierarchy. Subvolumes can share file extents. A snapshot is also subvolume, but with a given initial content of the original subvolume. @@ -66,7 +66,7 @@ If <subvolume> is not a subvolume, btrfs returns an error but continues if there are more arguments to process. + The corresponding directory is removed instantly but the data blocks are -removed later in the background. The command returns immediatelly. See `btrfs +removed later in the background. The command returns immediately. See `btrfs subvolume sync` how to wait until the subvolume gets completely removed. + The deletion does not involve full transaction commit by default due to @@ -143,7 +143,11 @@ for --sort you can combine some items together by \',', just like --sort=+ogen,-gen,path,rootid. *set-default* [<subvolume>|<id> <path>]:: -Set the default subvolume of the (mounted) filesystem. +Set the default subvolume for the (mounted) filesystem. + +Set the default subvolume for the (mounted) filesystem at <path>. This will hide +the top-level subvolume (ie. the one mounted with 'subvol=/' or 'subvolid=5'). +Takes action on next mount. + There are two ways how to specify the subvolume, by <id> or by the <subvolume> path. @@ -166,10 +170,9 @@ If <source> is not a subvolume, btrfs returns an error. Make the new snapshot read only. *sync* <path> [subvolid...]:: -Wait until given subvolume(s) are completely removed from the filesystem -after deletion. If no subvolume id is given, wait until all current deletion -requests are completed, but do not wait for subvolumes deleted meanwhile. -The status of subvolume ids is checked periodically. +Wait until given subvolume(s) are completely removed from the filesystem after +deletion. If no subvolume id is given, wait until all current deletion requests +are completed, but do not wait for subvolumes deleted in the meantime. + `Options` + |