Bug 71690

Summary: [patch] inaccurate information in systat(1) manpage
Product: Documentation Reporter: Jan Srzednicki <w>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Jan Srzednicki 2004-09-13 02:30:22 UTC
The manpage for systat(1) is not accurate on what exacly is displayed
by the "vmstat" systat mode. It describes all the elements pretty well.
In the description of various virtual memory elements (like virtual/real
memory pages, active/inactive/wired pages etc.) it says that the numbers
displayed by systat are in page units. This is not true - the normal
page size is 4kB on an i386, and the numbers displayed are apparently
in kilobyte units (I have checked that on several machines, having say
100000 total real pages on a 128MB RAM machine is impossible; 
sysctl vm.vmtotal confirms that, comparing some numbers to the
top(1) output was also enlightening).

So, to make things clear, the manpage should state that the numbers
are not number of pages, but number of kilobytes in pages allocated
for something. It's also worth noting that not every 'number of pages'
in the display actually means 'number of kilobytes in pages'; it does not
affect page counts after 'daefr' or zero-fill page counts.

The display may be somewhat confusing, as the units (pages
and kilobytes) are mixed with each other and one has to remember
which counter has which units. But that's another issue..

Fix: That's my proposal, it isn't very elegant, but at least makes
it clear which counter are in pages, which in kilobytes.
Comment 1 Jan Srzednicki 2004-09-13 02:49:53 UTC
On Mon, Sep 13, 2004 at 01:30:22AM +0000, FreeBSD-gnats-submit@FreeBSD.org wrote:
> Thank you very much for your problem report.

Sigh, originator's name should be "Jan Srzednicki".

-- 
 -- Jan Srzednicki --=-- wrzask --=-- Winfried --
 -- w@wrzask.pl ----====---- http://wrzask.pl/ --
Comment 2 ru freebsd_committer freebsd_triage 2006-10-12 11:54:43 UTC
State Changed
From-To: open->closed

Fixed in -CURRENT, thanks!  Part of this was already fixed 
(differently) by bde@ in systat.1,v 1.51.
Comment 3 dfilter service freebsd_committer freebsd_triage 2006-10-12 11:55:23 UTC
ru          2006-10-12 10:54:35 UTC

  FreeBSD src repository

  Modified files:
    usr.bin/systat       systat.1 
  Log:
  Memory utilization subscreen in "vmstat" display lists numbers in KB,
  not in number of pages.
  
  PR:             docs/71690
  Submitted by:   Jan Srzednicki
  
  (A patch is only partially merged, the rest was already fixed by bde@
  in rev. 1.51.)
  
  Revision  Changes    Path
  1.53      +6 -6      src/usr.bin/systat/systat.1
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"