summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMariusz Tkaczyk <mtkaczyk@kernel.org>2025-01-07 10:09:16 +0100
committerMariusz Tkaczyk <mtkaczyk@kernel.org>2025-01-10 10:40:31 +0100
commitef4b6a23189d804bfd8fa81f5038afe6ce825bde (patch)
tree5672f7e42ac39ed46fd77271ffe11f3c58a7ad4a
parentmdadm: add MAINTAINERS file (diff)
downloadmdadm-ef4b6a23189d804bfd8fa81f5038afe6ce825bde.tar.xz
mdadm-ef4b6a23189d804bfd8fa81f5038afe6ce825bde.zip
mdadm.man: Remove external bitmap
Remove external bitmap support from manual. Signed-off-by: Mariusz Tkaczyk <mtkaczyk@kernel.org>
-rw-r--r--mdadm.8.in55
1 files changed, 6 insertions, 49 deletions
diff --git a/mdadm.8.in b/mdadm.8.in
index 2b6f3e50..83c0689f 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -740,27 +740,11 @@ parameter and are stored internally.
.B none
- create array with no bitmap or remove any present bitmap (grow mode).
-Setting bitmap for file is deprecated and should not be used. The file should not exist unless
-.B \-\-force
-is also given. The same file should be provided when assembling the array. The file name must
-contain at least one slash ('/'). Bitmap files are only known to work on ext2 and ext3. Storing
-bitmap files on other filesystems may result in serious problems.
-
-When creating an array on devices which are 100G or larger,
-.I mdadm
-automatically adds an internal bitmap as it will usually be
-beneficial. This can be suppressed with
-.B "\-\-bitmap=none"
-or by selecting a different consistency policy with
-.BR \-\-consistency\-policy .
-
.TP
.BR \-\-bitmap\-chunk=
Set the chunk size of the bitmap. Each bit corresponds to that many
Kilobytes of storage.
-When using a file-based bitmap, the default is to use the smallest
-size that is at least 4 and requires no more than 2^21 chunks.
-When using an
+
.B internal
bitmap, the chunk size defaults to 64Meg, or larger if necessary to
fit the bitmap into the available space.
@@ -1109,13 +1093,6 @@ and can be used if the physical connections to devices are
not as reliable as you would like.
.TP
-.BR \-b ", " \-\-bitmap=
-Specify the bitmap file that was given when the array was created. If
-an array has an
-.B internal
-bitmap, there is no need to specify this when assembling the array.
-
-.TP
.BR \-\-backup\-file=
If
.B \-\-backup\-file
@@ -1614,9 +1591,8 @@ applies to a whole array which is currently active.
.TP
.BR \-X ", " \-\-examine\-bitmap
-Report information about a bitmap file.
-The argument is either an external bitmap file or an array component
-in case of an internal bitmap. Note that running this on an array
+Report information about a bitmap.
+The argument is an array component. Note that running this on an array
device (e.g.
.BR /dev/md0 )
does not report the bitmap for that array.
@@ -1774,10 +1750,7 @@ Only meaningful with
this will scan the
.B map
file for arrays that are being incrementally assembled and will try to
-start any that are not already started. If any such array is listed
-in
-.B mdadm.conf
-as requiring an external bitmap, that bitmap will be attached first.
+start any that are not already started.
.TP
.BR \-\-fail ", " \-f
@@ -2151,15 +2124,7 @@ setting.
.\".B \-\-size
.\"is given, the apparent size of the smallest drive given is used.
-If the array type supports a write-intent bitmap, and if the devices
-in the array exceed 100G is size, an internal write-intent bitmap
-will automatically be added unless some other option is explicitly
-requested with the
-.B \-\-bitmap
-option or a different consistency policy is selected with the
-.B \-\-consistency\-policy
-option. In any case, space for a bitmap will be reserved so that one
-can be added later with
+Space for a bitmap will be reserved so that one can be added later with
.BR "\-\-grow \-\-bitmap=internal" .
If the metadata type supports it (currently only 1.x and IMSM metadata),
@@ -2735,11 +2700,6 @@ Also, the size of an array cannot be changed while it has an active
bitmap. If an array has a bitmap, it must be removed before the size
can be changed. Once the change is complete a new bitmap can be created.
-.PP
-Note:
-.B "--grow --size"
-is not yet supported for external file bitmap.
-
.SS RAID\-DEVICES CHANGES
A RAID1 array can work with any number of devices from 1 upwards
@@ -2834,10 +2794,7 @@ stored on the device being reshaped.
.SS BITMAP CHANGES
A write-intent bitmap can be added to, or removed from, an active
-array. Either internal bitmaps, or bitmaps stored in a separate file,
-can be added. Note that if you add a bitmap stored in a file which is
-in a filesystem that is on the RAID array being affected, the system
-will deadlock. The bitmap must be on a separate filesystem.
+array.
.SS CONSISTENCY POLICY CHANGES