Skip to content

Commit 9576e1a

Browse files
LongPing WeiMikulas Patocka
authored andcommitted
dm-thin: update the documentation
1. convert KB/MB/GB to KiB/MiB/GiB; 2. change the number of sectors for 128MiB from 256000 to 262144 as 256000 sectors is neither 128 MB nor 128 MiB. Signed-off-by: LongPing Wei <[email protected]> Signed-off-by: Mikulas Patocka <[email protected]>
1 parent 8d05316 commit 9576e1a

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

Documentation/admin-guide/device-mapper/thin-provisioning.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -80,11 +80,11 @@ less sharing than average you'll need a larger-than-average metadata device.
8080

8181
As a guide, we suggest you calculate the number of bytes to use in the
8282
metadata device as 48 * $data_dev_size / $data_block_size but round it up
83-
to 2MB if the answer is smaller. If you're creating large numbers of
83+
to 2MiB if the answer is smaller. If you're creating large numbers of
8484
snapshots which are recording large amounts of change, you may find you
8585
need to increase this.
8686

87-
The largest size supported is 16GB: If the device is larger,
87+
The largest size supported is 16GiB: If the device is larger,
8888
a warning will be issued and the excess space will not be used.
8989

9090
Reloading a pool table
@@ -107,13 +107,13 @@ Using an existing pool device
107107

108108
$data_block_size gives the smallest unit of disk space that can be
109109
allocated at a time expressed in units of 512-byte sectors.
110-
$data_block_size must be between 128 (64KB) and 2097152 (1GB) and a
111-
multiple of 128 (64KB). $data_block_size cannot be changed after the
110+
$data_block_size must be between 128 (64KiB) and 2097152 (1GiB) and a
111+
multiple of 128 (64KiB). $data_block_size cannot be changed after the
112112
thin-pool is created. People primarily interested in thin provisioning
113-
may want to use a value such as 1024 (512KB). People doing lots of
114-
snapshotting may want a smaller value such as 128 (64KB). If you are
113+
may want to use a value such as 1024 (512KiB). People doing lots of
114+
snapshotting may want a smaller value such as 128 (64KiB). If you are
115115
not zeroing newly-allocated data, a larger $data_block_size in the
116-
region of 256000 (128MB) is suggested.
116+
region of 262144 (128MiB) is suggested.
117117

118118
$low_water_mark is expressed in blocks of size $data_block_size. If
119119
free space on the data device drops below this level then a dm event
@@ -291,7 +291,7 @@ i) Constructor
291291
error_if_no_space:
292292
Error IOs, instead of queueing, if no space.
293293

294-
Data block size must be between 64KB (128 sectors) and 1GB
294+
Data block size must be between 64KiB (128 sectors) and 1GiB
295295
(2097152 sectors) inclusive.
296296

297297

0 commit comments

Comments
 (0)