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
+.B \-\-cpu\-list
+option. For example,
.RS 4
.TP 12
-.BR 0x00000001
+.B 0x00000001
is processor #0,
.TP
-.BR 0x00000003
+.B 0x00000003
is processors #0 and #1,
.TP
-.BR 0xFFFFFFFF
-is all processors (#0 through #31).
+.B 0xFFFFFFFF
+is processors #0 through #31,
+.TP
+.B 32
+is processors #1, #4, and #5,
+.TP
+.B \-\-cpu\-list\ 0-2,6
+is processors #0, #1, #2, and #6.
.RE
.PP
When
-.BR taskset
+.B taskset
returns, it is guaranteed that the given program has been scheduled to a legal
CPU.
.SH OPTIONS
.TP
-.BR \-a ,\ \-\-all-tasks
+.BR \-a ,\ \-\-all\-tasks
Set or retrieve the CPU affinity of all the tasks (threads) for a given PID.
.TP
-.BR \-c ,\ \-\-cpu-list \ \fInumbers
-Specify a numerical list of processors instead of a bitmask. The \fInumbers\fR
-are separated by commas and may include ranges. For example:
+.BR \-c ,\ \-\-cpu\-list
+Interpret \fImask\fR as numerical list of processors instead of a bitmask.
+Numbers are separated by commas and may include ranges. For example:
.BR 0,5,8-11 .
.TP
.BR \-p ,\ \-\-pid
.BR chrt (1),
.BR nice (1),
.BR renice (1),
-.BR sched_setaffinity (2),
-.BR sched_getaffinity (2)
+.BR sched_getaffinity (2),
+.BR sched_setaffinity (2)
.sp
See
-.BR sched_setscheduler (2)
+.BR sched (7)
for a description of the Linux scheduling scheme.
.SH AUTHOR
Written by Robert M. Love.
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH AVAILABILITY
The taskset command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+https://www.kernel.org/pub/linux/utils/util-linux/.