Added option -[0-9]* to sar to show data of that days ago.

[sysstat] / man / sar.in

diff --git a/man/sar.in b/man/sar.in
index c648f8cdeb8726df7af08073fca55d25c23a69c9..47a3c15f80af7b5cce2c89bcb6d0f8bbec0ea4d4 100644 (file)
--- a/man/sar.in
+++ b/man/sar.in
@@ -1,4 +1,4 @@
-.TH SAR 1 "OCTOBER 2010" Linux "Linux User's Manual" -*- nroff -*-
+.TH SAR 1 "JUNE 2012" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 sar \- Collect, report, or save system activity information.
 .SH SYNOPSIS
@@ -20,7 +20,7 @@ sar \- Collect, report, or save system activity information.
 .I filename
 .B ] | -f [
 .I filename
-.B ] ] [ -s [
+.B ] | -[0-9]+ ] [ -s [
 .I hh:mm:ss
 .B ] ] [ -e [
 .I hh:mm:ss
@@ -69,6 +69,10 @@ command extracts and writes to standard output records previously
 saved in a file. This file can be either the one specified by the
 .B -f
 flag or, by default, the standard system activity daily data file.
+It is also possible to enter -1, -2 etc. as an argument to sar to
+display data
+of that days ago. For example, -1 will point at the standard system
+activity file of yesterday.
 
 Without the
 .B -P
@@ -92,8 +96,7 @@ You can select information about specific system activities using
 flags. Not specifying any flags selects only CPU activity.
 Specifying the
 .B -A
-flag is equivalent to specifying
-.BR "-bBdqrRSvwWy -I SUM -I XALL -n ALL -u ALL -P ALL".
+flag selects all possible activities.
 
 The default version of the
 .B sar
@@ -375,9 +378,10 @@ Possible keywords are
 .BR CPU ,
 .BR FAN ,
 .BR FREQ ,
-.BR IN
+.BR IN ,
+.BR TEMP
 and
-.BR TEMP .
+.BR USB .
 
 With the
 .B CPU
@@ -465,6 +469,46 @@ temperature has reached its high limit (temp_max).
 .RS
 Sensor device name.
 .RE
+
+With the
+.B USB
+keyword, the
+.B sar
+command takes a snapshot of all the USB devices currently plugged into
+the system. At the end of the report,
+.B sar
+will display a summary of all those USB devices.
+The following values are displayed:
+
+.B BUS
+.RS
+Root hub number of the USB device.
+.RE
+
+.B idvendor
+.RS
+Vendor ID number (assigned by USB organization).
+.RE
+
+.B idprod
+.RS
+Product ID number (assigned by Manufacturer).
+.RE
+
+.B maxpower
+.RS
+Maximum power consumption of the device (expressed in mA).
+.RE
+
+.B manufact
+.RS
+Manufacturer name.
+.RE
+
+.B product
+.RS
+Product name.
+.RE
 .RE
 .IP "-n { keyword [,...] | ALL }"
 Report network statistics.
@@ -716,7 +760,7 @@ Number of RAW sockets currently in use.
 
 .B ip-frag
 .RS
-Number of IP fragments currently in use.
+Number of IP fragments currently in queue.
 .RE
 
 .B tcp-tw
@@ -1642,6 +1686,11 @@ System load average for the past 5 minutes.
 .RS
 System load average for the past 15 minutes.
 .RE
+
+.B blocked
+.RS
+Number of tasks currently blocked, waiting for I/O to complete.
+.RE
 .RE
 .IP -r
 Report memory utilization statistics.
@@ -1684,7 +1733,18 @@ RAM/swap is needed to guarantee that there never is out of memory.
 .RS
 Percentage of memory needed for current workload in relation to the total amount of memory (RAM+swap).
 This number may be greater than 100% because the kernel usually overcommits memory.
+.RE
 
+.B kbactive
+.RS
+Amount of active memory in kilobytes (memory that has been used more recently
+and usually not reclaimed unless absolutely necessary).
+.RE
+
+.B kbinact
+.RS
+Amount of inactive memory in kilobytes (memory which has been less recently
+used. It is more eligible to be reclaimed for other purposes).
 .RE
 .RE
 .IP -R