Skip to content

Commit 9b28a11

Browse files
mulkieransnitm
authored andcommitted
dm thin: fix documentation relative to low water mark threshold
Fixes: 1. The use of "exceeds" when the opposite of exceeds, falls below, was meant. 2. Properly speaking, a table can not exceed a threshold. It emphasizes the important point, which is that it is the userspace daemon's responsibility to check for low free space when a device is resumed, since it won't get a special event indicating low free space in that situation. Signed-off-by: mulhern <[email protected]> Signed-off-by: Mike Snitzer <[email protected]>
1 parent 1346638 commit 9b28a11

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

Documentation/device-mapper/thin-provisioning.txt

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -112,9 +112,11 @@ $low_water_mark is expressed in blocks of size $data_block_size. If
112112
free space on the data device drops below this level then a dm event
113113
will be triggered which a userspace daemon should catch allowing it to
114114
extend the pool device. Only one such event will be sent.
115-
Resuming a device with a new table itself triggers an event so the
116-
userspace daemon can use this to detect a situation where a new table
117-
already exceeds the threshold.
115+
116+
No special event is triggered if a just resumed device's free space is below
117+
the low water mark. However, resuming a device always triggers an
118+
event; a userspace daemon should verify that free space exceeds the low
119+
water mark when handling this event.
118120

119121
A low water mark for the metadata device is maintained in the kernel and
120122
will trigger a dm event if free space on the metadata device drops below

0 commit comments

Comments
 (0)