From: Sebastien GODARD Date: Wed, 11 Nov 2020 15:36:11 +0000 (+0100) Subject: sa1: Update manual page X-Git-Tag: v12.5.1~6 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=72933127ffe69ebbccf261a45e6c3e283e7960d1;p=sysstat sa1: Update manual page Explain new option "--rotate". Signed-off-by: Sebastien GODARD --- diff --git a/man/sa1.in b/man/sa1.in index 5bf0a9a..7ce07a3 100644 --- a/man/sa1.in +++ b/man/sa1.in @@ -1,10 +1,10 @@ .\" sa1 manual page - (C) 1999-2020 Sebastien Godard (sysstat orange.fr) -.TH SA1 8 "JULY 2020" Linux "Linux User's Manual" -*- nroff -*- +.TH SA1 8 "NOVEMBER 2020" Linux "Linux User's Manual" -*- nroff -*- .SH NAME sa1 \- Collect and store binary data in the system activity daily data file. .SH SYNOPSIS -.B @SA_LIB_DIR@/sa1 [ --boot | --sleep | +.B @SA_LIB_DIR@/sa1 [ --boot | --rotate [ iso ] | --sleep | .I interval count .B ] @@ -47,6 +47,14 @@ command should be called without specifying the parameters in order to insert a dummy record, marking the time when the counters restart from 0. .TP +.B --rotate [ iso ] +.RB "Use this option to tell " "sa1 " "to insert a record of statistics to the standard" +.IR "saDD" " system activity daily data file of the previous day." +This should be done shortly after midnight (on day DD+1) in order to make sure that the +data file covers the whole day, including the last interval of time just before midnight. +.RB "Adding the " "iso" " keyword tells " "sa1" " to use +.IR "saYYYYMMDD" " instead of " "saDD" " as the standard system activity daily data file name." +.TP .B --sleep .RB "This option tells " "sa1 " "that the " "sadc" command should insert a comment indicating that the system is entering or leaving @@ -58,6 +66,11 @@ place the following entry in your root crontab file: .B 0,10,20,30,40,50 * * * * @SA_LIB_DIR@/sa1 1 1 -S DISK +To rotate current system activity daily data file, ensuring it is complete, +place the following entry in your root crontab file: + +.B 0 0 * * * @SA_LIB_DIR@/sa1 --rotate + .SH FILES .I @SA_DIR@/saDD .br