Filesystems statistics (part 7): Documentation updates

This patch updates sar manual page to describe option -F used to display
filesystems statistics.
CHANGES file is also updated.

diff --git a/CHANGES b/CHANGES
index f08aac972d04fec9e56d125a6291804cb9c9f7ef..bab4036f337d6d9b5111b7e91ecf788a112bc8df 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,9 @@
 Changes:
 
 xxxx/xx/xx: Version 10.1.6 - Sebastien Godard (sysstat <at> orange.fr)
+       * Filesystems statistics added to sar/sadc/sadf. These stats can
+         be displayed with option -F.
+       * DTD and XSD documents updated. 
        * Code cleaned: Removed several unused constants from header files.
        * Sysstat command options can now be 'collapsed' (grouped) when
          not followed by an argument. So it's now possible for example

diff --git a/man/sar.in b/man/sar.in
index bbb409215d06ed5a9e3c919ab52160ae5c8afcab..43e8353723a4447a02d2a214d65ca8e96496ede5 100644 (file)
--- a/man/sar.in
+++ b/man/sar.in
@@ -2,7 +2,7 @@
 .SH NAME
 sar \- Collect, report, or save system activity information.
 .SH SYNOPSIS
-.B sar [ -A ] [ -B ] [ -b ] [ -C ] [ -d ] [ -H ] [ -h ] [ -p ] [ -q ] [ -R ]
+.B sar [ -A ] [ -B ] [ -b ] [ -C ] [ -d ] [ -F ] [ -H ] [ -h ] [ -p ] [ -q ] [ -R ]
 .B [ -r ] [ -S ] [ -t ] [ -u [ ALL ] ] [ -V ] [ -v ] [ -W ] [ -w ] [ -y ]
 .B [ -I {
 .I int
@@ -320,6 +320,49 @@ or written to a file (options
 or
 .B -o
 ).
+.IP -F
+Display statistics for currently mounted filesystems. Pseudo-filesystems are
+ignored. At the end of the report,
+.B sar
+will display a summary of all those filesystems. The following values are
+displayed:
+
+.B MBfsfree
+.RS
+.RS
+Total amount a free space in megabytes (including space available only to privileged user).
+.RE
+
+.B MBfsused
+.RS
+Total amount of space used in megabytes.
+.RE
+
+.B %fsused
+.RS
+Percentage of filesystem space used, as seen by a privileged user.
+.RE
+
+.B %ufsused
+.RS
+Percentage of filesystem space used, as seen by an unprivileged user.
+.RE
+
+.B Ifree
+.RS
+Total number of free file nodes in filesystem.
+.RE
+
+.B Iused
+.RS
+Total number of file nodes used in filesystem.
+.RE
+
+.B %Iused
+.RS
+Percentage of file nodes used in filesystem.
+.RE
+.RE
 .IP "-f [ filename ]"
 Extract records from
 .I filename