From: Shin'ichiro Kawasaki Date: Fri, 6 Aug 2021 01:07:10 +0000 (+0900) Subject: HOWTO/man: Describe trim support by zone reset for zoned devices X-Git-Tag: fio-3.28~27 X-Git-Url: https://git.kernel.dk/?p=fio.git;a=commitdiff_plain;h=2455851d77608851f78d7dc3bccd8826d6161c36 HOWTO/man: Describe trim support by zone reset for zoned devices Previous commits added trim support for zoned devices. Update HOWTO and man page to describe it. Also add missing description about libzbc I/O engine to HOWTO. Signed-off-by: Shin'ichiro Kawasaki Reviewed-by: Dmitry Fomichev Signed-off-by: Jens Axboe --- diff --git a/HOWTO b/HOWTO index d4e620de..04ea284b 100644 --- a/HOWTO +++ b/HOWTO @@ -992,6 +992,9 @@ Target file/device single zone. The :option:`zoneskip` parameter is ignored. :option:`zonerange` and :option:`zonesize` must be identical. + Trim is handled using a zone reset operation. + Trim only considers non-empty sequential write + required and sequential write preferred zones. .. option:: zonerange=int @@ -1965,6 +1968,11 @@ I/O engine character devices. This engine supports trim operations. The sg engine includes engine specific options. + **libzbc** + Read, write, trim and ZBC/ZAC operations to a zoned + block device using libzbc library. The target can be + either an SG character device or a block device file. + **null** Doesn't transfer any data, just pretends to. This is mainly used to exercise fio itself and for debugging/testing purposes. diff --git a/fio.1 b/fio.1 index 9c12ad13..ff100a1c 100644 --- a/fio.1 +++ b/fio.1 @@ -766,6 +766,8 @@ starts. The \fBzonecapacity\fR parameter is ignored. Zoned block device mode. I/O happens sequentially in each zone, even if random I/O has been selected. Random I/O happens across all zones instead of being restricted to a single zone. +Trim is handled using a zone reset operation. Trim only considers non-empty +sequential write required and sequential write preferred zones. .RE .RE .TP @@ -1761,10 +1763,9 @@ character devices. This engine supports trim operations. The sg engine includes engine specific options. .TP .B libzbc -Synchronous I/O engine for SMR hard-disks using the \fBlibzbc\fR -library. The target can be either an sg character device or -a block device file. This engine supports the zonemode=zbd zone -operations. +Read, write, trim and ZBC/ZAC operations to a zoned block device using +\fBlibzbc\fR library. The target can be either an SG character device or +a block device file. .TP .B null Doesn't transfer any data, just pretends to. This is mainly used to