From 5351efc2f0bd46d8d515e3a45db89eefa44e26e9 Mon Sep 17 00:00:00 2001
From: Sebastien GODARD <sysstat@users.noreply.github.com>
Date: Mon, 17 Nov 2014 21:25:50 +0100
Subject: [PATCH] Update sar manual page.

Update sar manual page to describe new metrics added to memory
statistics displayed by sar -r.

Signed-off-by: Sebastien GODARD <sysstat@users.noreply.github.com>
---
 man/sar.in | 37 ++++++++++++++++++++++++++++++++-----
 1 file changed, 32 insertions(+), 5 deletions(-)

diff --git a/man/sar.in b/man/sar.in
index 8add062..7bd9b6e 100644
--- a/man/sar.in
+++ b/man/sar.in
@@ -3,7 +3,7 @@
 sar \- Collect, report, or save system activity information.
 .SH SYNOPSIS
 .B sar [ -A ] [ -B ] [ -b ] [ -C ] [ -D ] [ -d ] [ -F ] [ -H ] [ -h ] [ -p ] [ -q ] [ -R ]
-.B [ -r ] [ -S ] [ -t ] [ -u [ ALL ] ] [ -V ] [ -v ] [ -W ] [ -w ] [ -y ]
+.B [ -r [ ALL ] ] [ -S ] [ -t ] [ -u [ ALL ] ] [ -V ] [ -v ] [ -W ] [ -w ] [ -y ]
 .B [ -I {
 .I int
 .B [,...] | SUM | ALL | XALL } ] [ -P {
@@ -166,7 +166,7 @@ command only reports on local activities.
 .SH OPTIONS
 .IP -A
 This is equivalent to specifying
-.BR "-bBdFHqrRSuvwWy -I SUM -I XALL -m ALL -n ALL -u ALL -P ALL".
+.BR "-bBdFHqRSuvwWy -I SUM -I XALL -m ALL -n ALL -r ALL -u ALL -P ALL".
 .IP -B
 Report paging statistics.
 The following values are displayed:
@@ -1841,9 +1841,11 @@ Number of additional memory pages cached by the system per second.
 A negative value means fewer pages in the cache.
 .RE
 .RE
-.IP -r
-Report memory utilization statistics.
-The following values are displayed:
+.IP "-r [ ALL ]"
+Report memory utilization statistics. The
+.B ALL
+keyword indicates that all the memory fields should be displayed.
+The following values may be displayed:
 
 .B kbmemfree
 .RS
@@ -1900,6 +1902,31 @@ used. It is more eligible to be reclaimed for other purposes).
 .RS
 Amount of memory in kilobytes waiting to get written back to the disk.
 .RE
+
+.B kbanonpg
+.RS
+Amount of non-file backed pages in kilobytes mapped into userspace page tables.
+.RE
+
+.B kbslab
+.RS
+Amount of memory in kilobytes used by the kernel to cache data structures for its own use.
+.RE
+
+.B kbkstack
+.RS
+Amount of memory in kilobytes used for kernel stack space.
+.RE
+
+.B kbpgtbl
+.RS
+Amount of memory in kilobytes dedicated to the lowest level of page tables.
+.RE
+
+.B kbvmused
+.RS
+Amount of memory in kilobytes of used virtual address space.
+.RE
 .RE
 .IP -S
 Report swap space utilization statistics.
-- 
2.40.0