sar/mpstat: Update manual pages

Tell that a cpu or interrupts list (individual values separated with a
comma, or range of values) can be entered with options -I and -P.

Signed-off-by: Sebastien GODARD <sysstat@users.noreply.github.com>

diff --git a/man/mpstat.1 b/man/mpstat.1
index 0f2efd81e50713756125182a0d0a39c9c3e853e7..d0168bb087ef22422fe516d0149bf70f227bee92 100644 (file)
--- a/man/mpstat.1
+++ b/man/mpstat.1
@@ -1,12 +1,12 @@
-.TH MPSTAT 1 "SEPTEMBER 2016" Linux "Linux User's Manual" -*- nroff -*-
+.TH MPSTAT 1 "NOVEMBER 2016" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 mpstat \- Report processors related statistics.
 .SH SYNOPSIS
 .B mpstat [ -A ] [ -u ] [ -V ] [ -I {
 .I keyword
 .B [,...] | ALL } ] [ -o JSON ] [ -P {
-.I cpu
-.B [,...] | ON | ALL } ] [
+.I cpu_list
+.B | ON | ALL } ] [
 .I interval
 .B [
 .I count
@@ -102,10 +102,14 @@ therefore all the interrupts statistics are displayed.
 Display the statistics in JSON (Javascript Object Notation) format.
 JSON output field order is undefined, and new fields may be added
 in the future.
-.IP "-P { cpu [,...] | ON | ALL }"
-Indicate the processor number for which statistics are to be reported.
-.I cpu
-is the processor number. Note that processor 0 is the first processor.
+.IP "-P { cpu_list | ON | ALL }"
+Indicate the processors for which statistics are to be reported.
+.I cpu_list
+is a list of comma-separated values or range of values (e.g.,
+.BR 0,2,4-7,12- ).
+Note that processor 0 is the first processor, and processor
+.B all
+is the global average among all processors.
 The
 .B ON
 keyword indicates that statistics are to be reported for every

diff --git a/man/sar.in b/man/sar.in
index b9d618b6b241530775e4b8cf5b9530c0773caa45..bbe2249756453ee93b36b9582a6565a6fc4a2539 100644 (file)
--- a/man/sar.in
+++ b/man/sar.in
@@ -5,10 +5,10 @@ sar \- Collect, report, or save system activity information.
 .B sar [ -A ] [ -B ] [ -b ] [ -C ] [ -D ] [ -d ] [ -F [ MOUNT ] ] [ -H ] [ -h ] [ -p ] [ -q ] [ -R ]
 .B [ -r [ ALL ] ] [ -S ] [ -t ] [ -u [ ALL ] ] [ -V ] [ -v ] [ -W ] [ -w ] [ -y ] [ --human ] [ --sadc ]
 .B [ -I {
-.I int
-.B [,...] | SUM | ALL | XALL } ] [ -P {
-.I cpu
-.B [,...] | ALL } ]
+.I int_list
+.B | SUM | ALL } ] [ -P {
+.I cpu_list
+.B | ALL } ]
 .B [ -m {
 .I keyword
 .B [,...] | ALL } ]
@@ -166,7 +166,7 @@ command only reports on local activities.
 .SH OPTIONS
 .IP -A
 This is equivalent to specifying
-.BR "-bBdFHqRSuvwWy -I SUM -I XALL -m ALL -n ALL -r ALL -u ALL -P ALL".
+.BR "-bBdFHqRSuvwWy -I SUM -I ALL -m ALL -n ALL -r ALL -u ALL -P ALL".
 .IP -B
 Report paging statistics.
 The following values are displayed:
@@ -441,20 +441,16 @@ Display a short help message then exit.
 Print sizes in human readable format (e.g. 1k, 1.23M, etc.)
 The units displayed with this option supersede any other default units (e.g.
 kilobytes, sectors...) associated with the metrics.
-.IP "-I { int [,...] | SUM | ALL | XALL }"
-Report statistics for a given interrupt.
-.I int
-is the interrupt number. Specifying multiple -I
-.I int
-parameters on the command line will look at multiple independent interrupts.
+.IP "-I { int_list | SUM | ALL }"
+Report statistics for interrupts.
+.I int_list
+is a list of comma-separated values or range of values (e.g.,
+.BR 0-16,35,400- ).
 The
 .B SUM
 keyword indicates that the total number of interrupts received per second
 is to be displayed. The
 .B ALL
-keyword indicates that statistics from
-the first 16 interrupts are to be reported, whereas the
-.B XALL
 keyword indicates that statistics from all interrupts, including potential
 APIC interrupt sources, are to be reported.
 Note that interrupt statistics depend on
@@ -1855,13 +1851,18 @@ with the option "-S ALL".
 See
 .BR sadc (8)
 manual page).
-.IP "-P { cpu [,...] | ALL }"
+.IP "-P { cpu_list | ALL }"
 Report per-processor statistics for the specified processor or processors.
+.I cpu_list
+is a list of comma-separated values or range of values (e.g.,
+.BR 0,2,4-7,12- ).
+Note that processor 0 is the first processor, and processor
+.B all
+is the global average among all processors.
 Specifying the
 .B ALL
 keyword reports statistics for each individual processor, and globally for
 all processors.
-Note that processor 0 is the first processor.
 .IP -p
 Pretty-print device names. Use this option in conjunction with option -d.
 By default names are printed as