docs: add warning to per_job_logs option

[fio.git] / HOWTO.rst

diff --git a/HOWTO.rst b/HOWTO.rst
index 42b2b119741ab9ab4c1b119cefc1fe065fbeab60..d173702b1d38f3375df91adb6943399464110a4b 100644 (file)
--- a/HOWTO.rst
+++ b/HOWTO.rst
@@ -3968,9 +3968,11 @@ Measurements and reporting
 
 .. option:: per_job_logs=bool
 
-       If set, this generates bw/clat/iops log with per file private filenames. If
-       not set, jobs with identical names will share the log filename. Default:
-       true.
+        If set to true, fio generates bw/clat/iops logs with per job unique
+        filenames. If set to false, jobs with identical names will share a log
+        filename. Note that when this option is set to false log files will be
+        opened in append mode and if log files already exist the previous
+        contents will not be overwritten. Default: true.
 
 .. option:: group_reporting