/proc/stat description for proc.txt

[Sven Heinicke]

I got tired at looking proc_misc.c to see what /proc/stat was
reporting about.  So here is my noted patched into proc.txt about the
/proc/stat file.  It's a patch off the 2.4.15-pre1 proc.txt, but it
worked fine patching it into 2.4.15-pre4 kernel.  Between which I
don't actually think proc.txt has changed.

	   Sven

--- proc.copy.txt	Thu Nov  8 10:36:57 2001
+++ proc.txt	Thu Nov  8 13:33:01 2001
@@ -25,6 +25,7 @@
   1.5	SCSI info
   1.6	Parallel port info in /proc/parport
   1.7	TTY info in /proc/tty
+  1.8	Kernel Statistics in /proc/stat
 
   2	Modifying System Parameters
   2.1	/proc/sys/fs - File system data
@@ -223,7 +224,7 @@
  rtc         Real time clock                                   
  scsi        SCSI info (see text)                              
  slabinfo    Slab pool info                                    
- stat        Overall statistics                                
+ stat        Overall statistics                                 (1.8)
  swaps       Swap space utilization                            
  sys         See chapter 2                                     
  sysvipc     Info of SysVIPC Resources (msg, sem, shm)		(2.4)
@@ -566,9 +567,9 @@
 1.7 TTY info in /proc/tty
 -------------------------
 
-Information about  the  available  and actually used tty's can be found in the
-directory /proc/tty.You'll  find  entries  for drivers and line disciplines in
-this directory, as shown in Table 1-9.
+Information about the available and actually used tty's can be found
+in the directory /proc/tty.  You'll find entries for drivers and line
+disciplines in this directory, as shown in Table 1-9.
 
 
 Table 1-9: Files in /proc/tty 
@@ -595,6 +596,51 @@
   /dev/tty             /dev/tty        5       0 system:/dev/tty 
   unknown              /dev/tty        4    1-63 console 
 
+
+1.8 Kernel Statistics in /proc/stat
+-----------------------------------
+
+General statistics about what the kernel has been doing is available
+in the /proc stat file.  To view the statistics simply;
+
+$ cat /proc/stat 
+cpu  58903 1 7337 221340
+cpu0 58903 1 7337 221340
+page 97604 92120
+swap 1 0
+intr 571041 287581 3738 0 0 3 0 2 0 0 0 0 56043 202215 0 21398 61 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
+disk_io: (3,0):(21459,9839,195208,11620,184240) 
+ctxt 1719440
+btime 1005238271
+processes 4997
+
+The individual "cpu" entry is will be the same as "cpu0" if you only
+have one CPU on your system.  Otherwise the "cpu" entry will be a
+total of all the separate CPU stats.  The four numbers following "cpu"
+entries are: user, nice, system and unused usage (I think unused usage
+anyway).
+
+The two numbers following the "page" entry are number of pages going
+in followed by the number of pages going out.  Same goes for the
+"swap" entry.
+
+The "intr" entry show the number of interrupts.  The first number is
+the total interrupts between all IRQs.  The remaining numbers are the
+interrupts for each IRQ in order.
+
+The "disk_io" shows data for each active disk.  The above example only
+shows one active disk.  The first pair is the major followed by the
+disk number entry.  The others are `dk_drive', `dk_drive_rio',
+`dk_drive_rblk', `dk_drive_wio', `dk_drive_wblk' entries for that
+disk.  (If I ever figure out what they are i'll describe them
+beter. -Sven)
+
+"ctxt" the the contest switches.
+
+Can't figure what "btime" is.
+
+"processes" is the number of processes that have run since boot.  This
+includes forks, don't know if it includes threads.
 
 ------------------------------------------------------------------------------
 Summary