Update cpus_allowed_policy=split documentation
authorJens Axboe <axboe@fb.com>
Sat, 1 Mar 2014 00:43:57 +0000 (16:43 -0800)
committerJens Axboe <axboe@fb.com>
Sat, 1 Mar 2014 00:43:57 +0000 (16:43 -0800)
Instead of erroring out on fewer CPUs than threads/processes,
fio now does roundrobin over the set.

Signed-off-by: Jens Axboe <axboe@fb.com>
HOWTO
fio.1

diff --git a/HOWTO b/HOWTO
index ef2b631d849e7206323623e91d4e236157c58705..9a9f02a7bf6ec688a8bb5b546d6879a255de3990 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -936,8 +936,9 @@ cpus_allowed_policy=str Set the policy of how fio distributes the CPUs
                split   Each job will get a unique CPU from the CPU set.
 
                'shared' is the default behaviour, if the option isn't
                split   Each job will get a unique CPU from the CPU set.
 
                'shared' is the default behaviour, if the option isn't
-               specified. If split is specified, then fio will error out if
-               there are more jobs defined than CPUs given in the set.
+               specified. If split is specified, then fio will will assign
+               one cpu per job. If not enough CPUs are given for the jobs
+               listed, then fio will roundrobin the CPUs in the set.
 
 numa_cpu_nodes=str Set this job running on spcified NUMA nodes' CPUs. The
                arguments allow comma delimited list of cpu numbers,
 
 numa_cpu_nodes=str Set this job running on spcified NUMA nodes' CPUs. The
                arguments allow comma delimited list of cpu numbers,
diff --git a/fio.1 b/fio.1
index 863b0e093b38add8f5c86997e62f8b066f07b1bf..764e323ac8c21b182c85eca2519b714e43cef6ed 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -847,8 +847,9 @@ Each job will get a unique CPU from the CPU set.
 .RE
 .P
 \fBshared\fR is the default behaviour, if the option isn't specified. If
 .RE
 .P
 \fBshared\fR is the default behaviour, if the option isn't specified. If
-\fBsplit\fR is specified, then fio will error out if there are more jobs
-defined than CPUs given in the set.
+\fBsplit\fR is specified, then fio will assign one cpu per job. If not enough
+CPUs are given for the jobs listed, then fio will roundrobin the CPUs in
+the set.
 .RE
 .P
 .TP
 .RE
 .P
 .TP