sar manual page updated.

Added description of sar's option "-m USB".
CHANGES file updated.

diff --git a/CHANGES b/CHANGES
index 623562a4e1733c059b9f921fd2236056f4641285..44cf694c5ee31269dc724fc753608cc5e52f5553 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,11 +1,11 @@
 Changes:
 
 xxxx/xx/xx: Version 10.0.1 - Sebastien Godard (sysstat <at> orange.fr)
+       * Added USB devices statistics to sar and sadc. The option
+         "-m USB" can now be used with sar to take a snapshot of all
+         the USB devices currently plugged into the system.
        * sadf -p now displays the sensor device name for temperature,
          voltage inputs and fans statistics.
-       * sar: Decrease column width for sensor device name (temperature,
-         voltage inputs and fans statistics).
-       * Remove unnecessary arguments from functions in pr_stats.c.
        * sar and pidstat: Check that _("Average") string doesn't exceed
          the size of the timestamp buffer.
        * [Ivana Varekova]: Added option -h to iostat. This option makes
@@ -17,7 +17,11 @@ xxxx/xx/xx: Version 10.0.1 - Sebastien Godard (sysstat <at> orange.fr)
        * [Ivana Varekova]: Close file descriptor in read_uptime()
          function (rd_stats.c file).
        * Fixed XML output displayed by sadf (hugepages statistics were
-         included in power management ones).
+         included in <power-management> section).
+       * sar: Decrease column width for sensor device name (temperature,
+         voltage inputs and fans statistics).
+       * Remove unnecessary arguments from functions in pr_stats.c.
+       * sar manual page updated.
        * DTD and XSD documents updated and cleaned.
        * NLS updated. Esperanto translation added.
 

diff --git a/man/sar.in b/man/sar.in
index 8eee9de0b316c2907cc0f2f445c213f4ccf66a33..6e9bd220cfa48ef47386657d92fca9ed5705fdbc 100644 (file)
--- a/man/sar.in
+++ b/man/sar.in
@@ -1,4 +1,4 @@
-.TH SAR 1 "DECEMBER 2010" Linux "Linux User's Manual" -*- nroff -*-
+.TH SAR 1 "MAY 2011" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 sar \- Collect, report, or save system activity information.
 .SH SYNOPSIS
@@ -374,9 +374,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
@@ -464,6 +465,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.