Update sar and sadf manual pages

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

diff --git a/man/sadf.in b/man/sadf.in
index 0335311e19522300245c1f15a3fec3d96e60b71a..72c5b293e37c2e3bd156682f0309b6c37ded7560 100644 (file)
--- a/man/sadf.in
+++ b/man/sadf.in
@@ -1,12 +1,12 @@
-.\" sadf manual page - (C) 1999-2022 Sebastien Godard (sysstat <at> orange.fr)
-.TH SADF 1 "JANUARY 2022" Linux "Linux User's Manual" -*- nroff -*-
+.\" sadf manual page - (C) 1999-2023 Sebastien Godard (sysstat <at> orange.fr)
+.TH SADF 1 "JANUARY 2023" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 sadf \- Display data collected by sar in multiple formats.
 
 .SH SYNOPSIS
 .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" "] ] ]"
+.IB "opts " "[,...] ] [ -P { " "cpu_list " "| ALL } ] [ -s [ "
+.IB "time_start " "] ] ] [ -e [ " "time_end " "] ] ]"
 .BI "[ --dev=" "dev_list " "] [ --fs=" "fs_list " "] [ --iface=" "iface_list" "] [ --int=" "int_list " "] [ --"
 .IB "sar_options " "] [ " "interval " "[ " "count " "] ] [ " "datafile " "| " "-[0-9]+ " "]"
 
@@ -97,10 +97,16 @@ Specify the block devices for which statistics are to be displayed by
 .I dev_list
 is a list of comma-separated device names. Useful with option
 .BR "-d " "from " "sar" "."
-.TP
+.RE
+.PP
 .BI "-e [ " "hh" ":" "mm" "[:" "ss" "] ]"
+.br
+.BI "-e [ " "seconds_since_the_epoch " "]"
+.RS
 Set the ending time of the report. The default ending
-time is 18:00:00. Hours must be given in 24-hour format.
+time is 18:00:00. Hours must be given in 24-hour format, or as the number of seconds
+since the epoch.
+.RE
 .TP
 .BI "--fs=" "fs_list"
 Specify the filesystems for which statistics are to be displayed by
@@ -247,13 +253,18 @@ all the counters are displayed as read from the kernel, which means e.g., that
 no average values are calculated over the elapsed time interval.
 Output can be controlled using option
 .BR "-O " "(see above)."
-.TP
+.PP
 .BI "-s [ " "hh" ":" "mm" "[:" "ss" "] ]"
+.br
+.BI "-s [ " "seconds_since_the_epoch " "]"
+.RS
 Set the starting time of the data, causing the
 .B sadf
 command to extract records time-tagged at, or following, the time
 specified. The default starting time is 08:00:00.
-Hours must be given in 24-hour format.
+Hours must be given in 24-hour format, or as the number of seconds
+since the epoch.
+.RE
 .TP
 .B -T
 Display timestamp in local time instead of UTC (Coordinated Universal Time).

diff --git a/man/sar.in b/man/sar.in
index 2313dfe679d75db4ac068ee25c7d1b46735ba016..1916a71ccbb0b7ffa163791e218414b95cd4a117 100644 (file)
--- a/man/sar.in
+++ b/man/sar.in
@@ -1,5 +1,5 @@
-.\" sar manual page - (C) 1999-2022 Sebastien Godard (sysstat <at> orange.fr)
-.TH SAR 1 "DECEMBER 2022" Linux "Linux User's Manual" -*- nroff -*-
+.\" sar manual page - (C) 1999-2023 Sebastien Godard (sysstat <at> orange.fr)
+.TH SAR 1 "JANUARY 2023" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 sar \- Collect, report, or save system activity information.
 
@@ -13,8 +13,8 @@ sar \- Collect, report, or save system activity information.
 .IB "keyword" "[,...] | ALL } ] [ -n { " "keyword" "[,...] | ALL } ] [ -q [ " "keyword" "[,...] | ALL ] ]"
 .B [ -j { SID | ID | LABEL | PATH | UUID | ... } ]
 .BI "[ -f [ " "filename " "] | -o [ " "filename " "] | -[0-9]+ ]"
-.BI "[ -i " "interval " "] [ -s [ " "hh" ":" "mm" "[:" "ss" "]"
-.BI "] ] [ -e [ " "hh" ":" "mm" "[:" "ss" "] ] ] [ " "interval " "[ " "count " "] ]"
+.BI "[ -i " "interval " "] [ -s [ " "time_start "
+.BI "] ] [ -e [ " "time_end " "] ] ] [ " "interval " "[ " "count " "] ]"
 
 .SH DESCRIPTION
 .RB "The " "sar"
@@ -253,13 +253,19 @@ Specify the number of decimal places to use (0 to 2, default value is 2).
 Specify the block devices for which statistics are to be displayed by
 .BR "sar" "."
 .IR "dev_list " "is a list of comma-separated device names."
-.TP
+.RE
+.PP
 .BI "-e [ " "hh" ":" "mm" "[:" "ss" "] ]"
+.br
+.BI "-e [ " "seconds_since_the_epoch " "]"
+.RS
 Set the ending time of the report. The default ending time is
-18:00:00. Hours must be given in 24-hour format.
+18:00:00. Hours must be given in 24-hour format, or as the number of seconds
+since the epoch.
 This option can be used when data are read from
 or written to a file (options
 .BR "-f " "or " "-o" ")."
+.RE
 .TP
 .B -F [ MOUNT ]
 Display statistics for currently mounted filesystems. Pseudo-filesystems are
@@ -1460,15 +1466,20 @@ again because it is already in the swap area. This saves I/O).
 .IP %swpcad
 Percentage of cached swap memory in relation to the amount of used swap space.
 .RE
-.TP
+.PP
 .BI "-s [ " "hh" ":" "mm" "[:" "ss" "] ]"
+.br
+.BI "-s [ " "seconds_since_the_epoch " "]"
+.RS
 Set the starting time of the data, causing the
 .B sar
 command to extract records time-tagged at, or following, the time
 specified. The default starting time is 08:00:00.
-Hours must be given in 24-hour format. This option can be
+Hours must be given in 24-hour format, or as the number of seconds
+since the epoch. This option can be
 used only when data are read from a file (option
 .BR "-f" ")."
+.RE
 .TP
 .B --sadc
 Indicate which data collector is called by