From: Sebastien GODARD <sysstat@users.noreply.github.com>
Date: Sun, 14 Jun 2020 07:15:25 +0000 (+0200)
Subject: Update manual pages again
X-Git-Tag: v12.4.0~34
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=44151081fee8f00560747256d0971ea319fcaae8;p=sysstat

Update manual pages again

Explain that sysstat commands use kibibytes and mebibytes, but not
kilobytes and megabytes.

Signed-off-by: Sebastien GODARD <sysstat@users.noreply.github.com>
---

diff --git a/man/cifsiostat.in b/man/cifsiostat.in
index ccf759e..8800733 100644
--- a/man/cifsiostat.in
+++ b/man/cifsiostat.in
@@ -173,6 +173,10 @@ filesystem must be mounted for
 .B cifsiostat
 to work.
 
+Although
+.B cifsiostat
+speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...
+A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.
 .SH FILE
 .I /proc/fs/cifs/Stats
 contains CIFS statistics.
diff --git a/man/iostat.in b/man/iostat.in
index cb623bd..d84456a 100644
--- a/man/iostat.in
+++ b/man/iostat.in
@@ -537,6 +537,11 @@ filesystem must be mounted for
 to work.
 
 Kernels older than 2.6.x are no longer supported.
+
+Although
+.B iostat
+speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...
+A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.
 .SH FILES
 .I /proc/stat
 contains system statistics.
diff --git a/man/pidstat.1 b/man/pidstat.1
index 97c2c98..61d5e19 100644
--- a/man/pidstat.1
+++ b/man/pidstat.1
@@ -654,6 +654,10 @@ filesystem must be mounted for the
 .B pidstat
 command to work.
 
+Although
+.B pidstat
+speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...
+A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.
 .SH FILES
 .IR /proc
 contains various files with system statistics.
diff --git a/man/sar.in b/man/sar.in
index 8e8d21b..b4f56c6 100644
--- a/man/sar.in
+++ b/man/sar.in
@@ -2563,6 +2563,11 @@ command to work.
 All the statistics are not necessarily available, depending on the kernel version used.
 .B sar
 assumes that you are using at least a 2.6 kernel.
+
+Although
+.B sar
+speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...
+A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.
 .SH FILES
 .I @SA_DIR@/saDD
 .br
diff --git a/man/tapestat.1 b/man/tapestat.1
index 14ee5a7..5b8a2a0 100644
--- a/man/tapestat.1
+++ b/man/tapestat.1
@@ -244,6 +244,10 @@ to work. It will not work on kernels that do not have sysfs support
 This command requires kernel version 4.2 or later
 (or tape statistics support backported for an earlier kernel version).
 
+Although
+.B tapestat
+speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...
+A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.
 .SH FILES
 .I /sys/class/scsi_tape/st<num>/stats/*
 Statistics files for tape devices.