From a906d0e99c311796d358c05c46d0062399d3cf78 Mon Sep 17 00:00:00 2001 From: Sebastien GODARD Date: Sat, 29 Jan 2022 09:49:18 +0100 Subject: [PATCH] A_IRQ: Update sar and sadf manual pages Signed-off-by: Sebastien GODARD --- man/sadf.in | 13 ++++++++++--- man/sar.in | 33 +++++++++++++++++++++------------ 2 files changed, 31 insertions(+), 15 deletions(-) diff --git a/man/sadf.in b/man/sadf.in index 0b405f5..79f997a 100644 --- a/man/sadf.in +++ b/man/sadf.in @@ -1,5 +1,5 @@ -.\" sadf manual page - (C) 1999-2020 Sebastien Godard (sysstat orange.fr) -.TH SADF 1 "JULY 2020" Linux "Linux User's Manual" -*- nroff -*- +.\" sadf manual page - (C) 1999-2022 Sebastien Godard (sysstat orange.fr) +.TH SADF 1 "JANUARY 2022" Linux "Linux User's Manual" -*- nroff -*- .SH NAME sadf \- Display data collected by sar in multiple formats. @@ -7,7 +7,7 @@ sadf \- Display data collected by sar in multiple formats. .B sadf [ -C ] [ -c | -d | -g | -j | -l | -p | -r | -x ] [ -H ] [ -h ] [ -T | -t | -U ] [ -V ] [ -O .IB "opts " "[,...] ] [ -P { " "cpu_list " "| ALL } ] [ -s [" .IB "hh" ":" "mm" "[:" "ss" "] ] ] [ -e [" "hh" ":" "mm" "[:" "ss" "] ] ]" -.BI "[ --dev=" "dev_list " "] [ --fs=" "fs_list " "] [ --iface=" "iface_list" "] [ --" +.BI "[ --dev=" "dev_list " "] [ --fs=" "fs_list " "] [ --iface=" "iface_list" "] [ --int=" "int_list " "] [ --" .IB "sar_options " "] [ " "interval " "[ " "count " "] ] [ " "datafile " "| " "-[0-9]+ " "]" .SH DESCRIPTION @@ -135,6 +135,13 @@ Specify the network interfaces for which statistics are to be displayed by is a list of comma-separated interface names. Useful with options .BR "-n DEV " "and " "-n EDEV " "from " "sar" "." .TP +.BI "--int=" "int_list" +Specify the interrupts names for which statistics are to be displayed by +.BR "sadf" "." +.I int_list +is a list of comma-separated values or range of values (e.g., +.BR "0-16,35,40-" "). Useful with option " "-I " "from " "sar" "." +.TP .B -j Print the contents of the data file in JSON (JavaScript Object Notation) format. Timestamps can be controlled by options diff --git a/man/sar.in b/man/sar.in index 6d7bdc9..19b4813 100644 --- a/man/sar.in +++ b/man/sar.in @@ -1,5 +1,5 @@ -.\" sar manual page - (C) 1999-2020 Sebastien Godard (sysstat orange.fr) -.TH SAR 1 "AUGUST 2020" Linux "Linux User's Manual" -*- nroff -*- +.\" sar manual page - (C) 1999-2022 Sebastien Godard (sysstat orange.fr) +.TH SAR 1 "JANUARY 2022" Linux "Linux User's Manual" -*- nroff -*- .SH NAME sar \- Collect, report, or save system activity information. @@ -8,7 +8,7 @@ sar \- Collect, report, or save system activity information. .B [ -r [ ALL ] ] [ -S ] [ -t ] [ -u [ ALL ] ] [ -V ] [ -v ] [ -W ] [ -w ] [ -y ] [ -z ] .B [ --dec={ 0 | 1 | 2 } ] .BI "[ --dev=" "dev_list " "] [ --fs=" "fs_list " "] [ --help ] [ --human ] [ --iface=" "iface_list" -.BI "] [ --pretty ] [ --sadc ] [ -I { " "int_list " "| SUM | ALL } ] [ -P { " "cpu_list" +.BI "] [ --int=" "int_list " "] [ --pretty ] [ --sadc ] [ -I [ SUM | ALL ] ] [ -P { " "cpu_list" .B | ALL } ] [ -m { .IB "keyword" "[,...] | ALL } ] [ -n { " "keyword" "[,...] | ALL } ] [ -q [ " "keyword" "[,...] | ALL ] ]" .B [ -j { SID | ID | LABEL | PATH | UUID | ... } ] @@ -125,7 +125,7 @@ command only reports on local activities. .TP .B -A This is equivalent to specifying -.BR "-bBdFHSvwWy -I SUM -m ALL -n ALL -q ALL -r ALL -u ALL" "." +.BR "-bBdFHISvwWy -m ALL -n ALL -q ALL -r ALL -u ALL" "." This option also implies specifying .B -I ALL -P ALL unless these options are explicitly set on the command line. @@ -340,17 +340,19 @@ Print sizes in human readable format (e.g. 1.0k, 1.2M, etc.) The units displayed with this option supersede any other default units (e.g. kilobytes, sectors...) associated with the metrics. .TP -.BI "-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 " "SUM" +.BI "-I [ SUM | ALL ]" +Report statistics for interrupts. The values displayed are the number of interrupts +per second for the given processor or among all processors. +A list of interrupts can be specified using +.B --int= +(see this option). 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 all interrupts, including potential -APIC interrupt sources, are to be reported. -Note that interrupt statistics depend on +keyword indicates that statistics from all interrupts are to be reported +(this is the default). +Note that interrupts statistics depend on .BR "sadc" "'s option " "-S INT" to be collected. .TP @@ -364,6 +366,13 @@ Specify the network interfaces for which statistics are to be displayed by .I iface_list is a list of comma-separated interface names. .TP +.BI "--int=" "int_list" +Specify the interrupts names for which statistics are to be displayed by +.BR "sar" "." +.I int_list +is a list of comma-separated values or range of values (e.g., +.BR "0-16,35,40-" "). +.TP .B -j { SID | ID | LABEL | PATH | UUID | ... } Display persistent device names. Use this option in conjunction with option .BR "-d" ". Keywords " "ID" ", " "LABEL" "," -- 2.40.0