libbtrfsutil: add btrfs_util_[gs]et_read_only()

[platform/upstream/btrfs-progs.git] / Documentation / btrfs-replace.asciidoc

diff --git a/Documentation/btrfs-replace.asciidoc b/Documentation/btrfs-replace.asciidoc
index 774d850..bc73b0b 100644 (file)
--- a/Documentation/btrfs-replace.asciidoc
+++ b/Documentation/btrfs-replace.asciidoc
@@ -1,5 +1,5 @@
 btrfs-replace(8)
-===============
+================
 
 NAME
 ----
@@ -13,11 +13,6 @@ DESCRIPTION
 -----------
 *btrfs replace* is used to replace btrfs managed devices with other device.
 
-NOTE: this is not currently supported for RAID5/6 profiles and must use the
-device add/delete workaround.
-It is recommended to see `btrfs-device`(8) for more details about btrfs device
-management.
-
 SUBCOMMAND
 ----------
 *cancel* <mount_point>::
@@ -33,11 +28,15 @@ the data is built only using the RAID redundancy mechanisms.
 After completion of the operation, the source device is removed from the
 filesystem.
 If the <srcdev> is a numerical value, it is assumed to be the device id
-of the filesystem which is mounted at <path>, otherwise is is
+of the filesystem which is mounted at <path>, otherwise it is
 the path to the source device. If the source device is disconnected,
 from the system, you have to use the devid parameter format.
 The <targetdev> needs to be same size or larger than the <srcdev>.
 +
+NOTE: the filesystem has to be resized to fully take advantage of a
+larger target device; this can be achieved with
+`btrfs filesystem resize <devid>:max /path`
++
 `Options`
 +
 -r::::
@@ -46,10 +45,10 @@ only read from <srcdev> if no other zero-defect mirror exists.
 slow)
 -f::::
 force using and overwriting <targetdev> even if it looks like
-containing a valid btrfs filesystem.
+it contains a valid btrfs filesystem.
 +
 A valid filesystem is assumed if a btrfs superblock is found which contains a
-correct checksum. Devices which are currently mounted are
+correct checksum. Devices that are currently mounted are
 never allowed to be used as the <targetdev>.
 +
 -B::::
@@ -62,7 +61,7 @@ Print status and progress information of a running device replace operation.
 +
 -1::::
 print once instead of print continuously until the replace
-operation finishes (or is canceled)
+operation finishes (or is cancelled)
 
 EXIT STATUS
 -----------