From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/debian-bookworm/man8/sa1.8 | 97 +++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 upstream/debian-bookworm/man8/sa1.8 (limited to 'upstream/debian-bookworm/man8/sa1.8') diff --git a/upstream/debian-bookworm/man8/sa1.8 b/upstream/debian-bookworm/man8/sa1.8 new file mode 100644 index 00000000..7914ed2b --- /dev/null +++ b/upstream/debian-bookworm/man8/sa1.8 @@ -0,0 +1,97 @@ +.\" sa1 manual page - (C) 1999-2020 Sebastien Godard (sysstat orange.fr) +.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 /usr/lib/sysstat/sa1 [ \-\-boot | \-\-rotate [ iso ] | \-\-sleep | +.I interval count +.B ] + +.SH DESCRIPTION +.RB "The " "sa1" +.RB "command is a shell procedure variant of the " "sadc" +command and handles all of the flags and parameters of that command. The +.B sa1 +command collects and stores binary data in the current standard +system activity daily data file. +.PP +The standard system activity daily data file is named +.IR "saDD " "unless" +.BR "sadc" "'s option " "\-D " "is used, in which case its name is" +.IR "saYYYYMMDD" "," +.RI "where " "YYYY " "stands for the current year, " "MM " "for the current month and " "DD" +for the current day. By default it is located in the +.I /var/log/sysstat +directory. +.PP +.RI "The " "interval " "and " "count" +parameters specify that the record should be written +.IR "count " "times at " "interval" +seconds. If no arguments are given to +.B sa1 +then a single record is written. + +The +.B sa1 +command is designed to be started automatically by the +.BR "cron " "command." + +.SH OPTIONS +.TP +.B \-\-boot +This option tells +.BR "sa1 " "that the " "sadc" +command should be called without specifying the +.IR "interval " "and " "count" +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 +sleep mode (i.e. system suspend or hibernation). + +.SH EXAMPLE +To collect data (including those from disks) every 10 minutes, +place the following entry in your root crontab file: + +.B 0,10,20,30,40,50 * * * * /usr/lib/sysstat/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 * * * /usr/lib/sysstat/sa1 \-\-rotate + +.SS Debian note +The Debian sysstat package has already placed such an entry in your system crontab. +Please refer to the +.I /usr/share/doc/sysstat/README.Debian +file for details. + +.SH FILES +.I /var/log/sysstat/saDD +.br +.I /var/log/sysstat/saYYYYMMDD +.RS +The standard system activity daily data files and their default location. +.IR "YYYY " "stands for the current year, " "MM " "for the current month and " "DD" +for the current day. + +.SH AUTHOR +Sebastien Godard (sysstat orange.fr) + +.SH SEE ALSO +.BR "sar" "(1), " "sadc" "(8), " "sa2" "(8), " "sadf" "(1), " "sysstat" "(5)" +.PP +.I https://github.com/sysstat/sysstat +.br +.I http://pagesperso\-orange.fr/sebastien.godard/ -- cgit v1.2.3