HOWTO: Fix description of grouping behavior with numjobs
authorAkash Verma <akashv@google.com>
Thu, 4 Oct 2012 22:58:28 +0000 (15:58 -0700)
committerJens Axboe <axboe@kernel.dk>
Fri, 5 Oct 2012 11:34:40 +0000 (13:34 +0200)
Signed-off-by: Akash Verma <akashv@google.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
HOWTO

diff --git a/HOWTO b/HOWTO
index 1362aeaa0319c5338d6befd4825fb06b45c2ddda..cdff07a2ce21bf2e0cf9ea2624d8b56cc653e869 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -1053,22 +1053,21 @@ wait_for_previous Wait for preceeding jobs in the job file to exit, before
                points in the job file. A stone wall also implies starting
                a new reporting group.
 
                points in the job file. A stone wall also implies starting
                a new reporting group.
 
-new_group      Start a new reporting group. If this option isn't given,
-               jobs in a file will be part of the same reporting group
-               unless separated by a stone wall (or if it's a group
-               by itself, with the numjobs option).
+new_group      Start a new reporting group. See: group_reporting.
 
 numjobs=int    Create the specified number of clones of this job. May be
                used to setup a larger number of threads/processes doing
 
 numjobs=int    Create the specified number of clones of this job. May be
                used to setup a larger number of threads/processes doing
-               the same thing. We regard that grouping of jobs as a
-               specific group.
-
-group_reporting        If 'numjobs' is set, it may be interesting to display
-               statistics for the group as a whole instead of for each
-               individual job. This is especially true of 'numjobs' is
-               large, looking at individual thread/process output quickly
-               becomes unwieldy. If 'group_reporting' is specified, fio
-               will show the final report per-group instead of per-job.
+               the same thing. Each thread is reported separately; to see
+               statistics for all clones as a whole, use group_reporting in
+               conjunction with new_group.
+
+group_reporting        It may sometimes be interesting to display statistics for
+               groups of jobs as a whole instead of for each individual job. This is
+               especially true if 'numjobs' is used; looking at individual
+               thread/process output quickly becomes unwieldy. To see the final report
+               per-group instead of per-job, use 'group_reporting'. Jobs in a file
+               will be part of the same reporting group, unless if separated by a
+               stonewall, or by using 'new_group'.
 
 thread         fio defaults to forking jobs, however if this option is
                given, fio will use pthread_create(3) to create threads
 
 thread         fio defaults to forking jobs, however if this option is
                given, fio will use pthread_create(3) to create threads