From: Sebastien GODARD <sysstat@orange.fr.fake>
Date: Mon, 20 May 2013 12:57:39 +0000 (+0200)
Subject: Filesystems statistics (part 7): Documentation updates
X-Git-Tag: v10.1.6~8
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a1999309158fa089e4399ca7b88d0c5fa4c8fef3;p=sysstat

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 f08aac9..bab4036 100644
--- 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 bbb4092..43e8353 100644
--- 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