taskset: clarify that masks are always hex in man page

The man page confusingly says that the mask is "typically"
hexadecimal, when in fact it is always hexadecimal.  Fix the
language, and provide an additional example with no leading "0x".

Also, provide an example using the --cpu-list option.

Signed-off-by: Chris Metcalf <cmetcalf@mellanox.com>
Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/schedutils/taskset.1 b/schedutils/taskset.1
index 901f9faf5f455188a05b42b0a5e166926d75183c..3ea03b7e256f576b56fc0e06716ca22b18a476ca 100644 (file)
--- a/schedutils/taskset.1
+++ b/schedutils/taskset.1
@@ -51,7 +51,10 @@ to the last logical CPU.  Not all CPUs may exist on a given system but a mask
 may specify more CPUs than are present.  A retrieved mask will reflect only the
 bits that correspond to CPUs physically on the system.  If an invalid mask is
 given (i.e., one that corresponds to no valid CPUs on the current system) an
-error is returned.  The masks are typically given in hexadecimal.  For example,
+error is returned.  The masks may be specified in hexadecimal (with or without
+a leading "0x"), or as a cpu list with the
+.BR \-\-cpu\-list
+option.  For example,
 .RS 4
 .TP 12
 .BR 0x00000001
@@ -61,7 +64,13 @@ is processor #0,
 is processors #0 and #1,
 .TP
 .BR 0xFFFFFFFF
-is all processors (#0 through #31).
+is processors #0 through #31,
+.TP
+.BR 32
+is processors #1, #4, and #5,
+.TP
+.BR \-\-cpu\-list\ 0-2,6
+is processors #0, #1, #2, and #6.
 .RE
 .PP
 When