From: Vincent Fu Date: Mon, 6 Nov 2023 18:44:48 +0000 (-0500) Subject: docs: add warning to per_job_logs option X-Git-Tag: fio-3.37~85 X-Git-Url: https://git.kernel.dk/?a=commitdiff_plain;h=05fce19c7d2668adb38243636a1781c0f8fae523;p=fio.git docs: add warning to per_job_logs option Add a warning about the file open mode used when per_job_logs is set to false. Log files are opened in append mode, so if the files already exist, the previous contents will not be overwritten. Signed-off-by: Vincent Fu --- diff --git a/HOWTO.rst b/HOWTO.rst index 42b2b119..d173702b 100644 --- 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 diff --git a/fio.1 b/fio.1 index d62da688..8f659f1d 100644 --- a/fio.1 +++ b/fio.1 @@ -3667,8 +3667,10 @@ interpreted in seconds. .SS "Measurements and reporting" .TP .BI per_job_logs \fR=\fPbool -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: +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. .TP .BI group_reporting