From 5917364262c5307751386f1501c9f5d5c46dbaee Mon Sep 17 00:00:00 2001
From: Sebastien Godard <sysstat@orange.fr>
Date: Sat, 28 May 2011 16:39:37 +0200
Subject: [PATCH] sar manual page updated.

Added description of sar's option "-m USB".
CHANGES file updated.
---
 CHANGES    | 12 ++++++++----
 man/sar.in | 47 ++++++++++++++++++++++++++++++++++++++++++++---
 2 files changed, 52 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index 623562a..44cf694 100644
--- 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 8eee9de..6e9bd22 100644
--- 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.
-- 
2.40.0