docs: update HOWTO and manpage for sg trim support

Also fix HOWTO sg_write_mode formatting

diff --git a/HOWTO b/HOWTO
index 70eed2805c2d96811d4238afaed645f4f3a10e45..804d93e4c578bfdb7d47058d177cce34420bb380 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -991,13 +991,15 @@ I/O type
                **write**
                                Sequential writes.
                **trim**
                **write**
                                Sequential writes.
                **trim**

-                               Sequential trims (Linux block devices only).
+                               Sequential trims (Linux block devices and SCSI
+                               character devices only).

                **randread**
                                Random reads.
                **randwrite**
                                Random writes.
                **randtrim**
                **randread**
                                Random reads.
                **randwrite**
                                Random writes.
                **randtrim**

-                               Random trims (Linux block devices only).
+                               Random trims (Linux block devices and SCSI
+                               character devices only).

                **rw,readwrite**
                                Sequential mixed reads and writes.
                **randrw**
                **rw,readwrite**
                                Sequential mixed reads and writes.
                **randrw**


@@ -1748,7 +1750,7 @@ I/O engine
                        ioctl, or if the target is an sg character device we use
                        :manpage:`read(2)` and :manpage:`write(2)` for asynchronous
                        I/O. Requires :option:`filename` option to specify either block or
                        ioctl, or if the target is an sg character device we use
                        :manpage:`read(2)` and :manpage:`write(2)` for asynchronous
                        I/O. Requires :option:`filename` option to specify either block or

-                       character devices.
+                       character devices. This engine supports trim operations.

                        The sg engine includes engine specific options.
 
                **null**
                        The sg engine includes engine specific options.
 
                **null**


@@ -2082,6 +2084,7 @@ with the caveat that when used on the command line, they must come after the
        the force unit access (fua) flag. Default is 0.
 
 .. option:: sg_write_mode=str : [sg]
        the force unit access (fua) flag. Default is 0.
 
 .. option:: sg_write_mode=str : [sg]

+

        Specify the type of write commands to issue. This option can take three values:
 
        **write**
        Specify the type of write commands to issue. This option can take three values:
 
        **write**

diff --git a/fio.1 b/fio.1
index 6d2eba67b1419d8d3e60b886c83bde9d87018fa0..a446aba549eb3834b202aefa21b1f5716f7141c6 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -757,7 +757,7 @@ Sequential reads.
 Sequential writes.
 .TP
 .B trim
 Sequential writes.
 .TP
 .B trim

-Sequential trims (Linux block devices only).
+Sequential trims (Linux block devices and SCSI character devices only).

 .TP
 .B randread
 Random reads.
 .TP
 .B randread
 Random reads.


@@ -766,7 +766,7 @@ Random reads.
 Random writes.
 .TP
 .B randtrim
 Random writes.
 .TP
 .B randtrim

-Random trims (Linux block devices only).
+Random trims (Linux block devices and SCSI character devices only).

 .TP
 .B rw,readwrite
 Sequential mixed reads and writes.
 .TP
 .B rw,readwrite
 Sequential mixed reads and writes.


@@ -1524,7 +1524,8 @@ SCSI generic sg v3 I/O. May either be synchronous using the SG_IO
 ioctl, or if the target is an sg character device we use
 \fBread\fR\|(2) and \fBwrite\fR\|(2) for asynchronous
 I/O. Requires \fBfilename\fR option to specify either block or
 ioctl, or if the target is an sg character device we use
 \fBread\fR\|(2) and \fBwrite\fR\|(2) for asynchronous
 I/O. Requires \fBfilename\fR option to specify either block or

-character devices. The sg engine includes engine specific options.
+character devices. This engine supports trim operations. The
+sg engine includes engine specific options.

 .TP
 .B null
 Doesn't transfer any data, just pretends to. This is mainly used to
 .TP
 .B null
 Doesn't transfer any data, just pretends to. This is mainly used to