documentation: Add desc of new cpu fields in /proc/stat

PATCH In review AP 2 participants 3 messages Jan 29, 2008 Documentation

Share & tools

AP

author

2008-01-29 09:14 UTC #0 lore raw

PATCH 1/1 documentation: Add desc of new cpu fields in /proc/stat

Today I noticed that a new field cropped up in /proc/stat. The git patch that made it is 5e84cfde51cf303d368fcb48f22059f37b3872de. I hope the following description is adequately accurate. I tried to keep it short.

Signed-off-by Andrew P <[email protected]>

Documentation/filesystems/proc.txt +4 -3

diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt
@@ -813,9 +813,9 @@
 since the system first booted.  For a quick look, simply cat the file:
 
   > cat /proc/stat
-  cpu  2255 34 2290 22625563 6290 127 456 0
-  cpu0 1132 34 1441 11311718 3675 127 438 0
-  cpu1 1123 0 849 11313845 2614 0 18 0
+  cpu  2255 34 2290 22625563 6290 127 456 0 0
+  cpu0 1132 34 1441 11311718 3675 127 438 0 0
+  cpu1 1123 0 849 11313845 2614 0 18 0 0
   intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...]
   ctxt 1990473
   btime 1062191376

@@ -836,6 +836,7 @@
 - irq: servicing interrupts
 - softirq: servicing softirqs
 - steal: involuntary wait
+- guest: time used to run a virtual CPU
 
 The "intr" line gives counts of interrupts  serviced since boot time, for each
 of the  possible system interrupts.   The first  column  is the  total of  all

Signature · 1 line

Andrew

Laurent Vivier

2008-01-29 09:04 UTC #1 lore raw

Hi,

good thing, but could you update too "Table 1-3: Contents of the stat files" with fields added by 9ac52315d4cf5f561f36dabaf0720c00d3553162 .

Thank you,
Laurent

Quoted 31 lines · AP

Signed-off-by Andrew P <[email protected]>

diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt

Documentation/filesystems/proc.txt +4 -3

@@ -813,9 +813,9 @@
 since the system first booted.  For a quick look, simply cat the file:
 
   > cat /proc/stat
-  cpu  2255 34 2290 22625563 6290 127 456 0
-  cpu0 1132 34 1441 11311718 3675 127 438 0
-  cpu1 1123 0 849 11313845 2614 0 18 0
+  cpu  2255 34 2290 22625563 6290 127 456 0 0
+  cpu0 1132 34 1441 11311718 3675 127 438 0 0
+  cpu1 1123 0 849 11313845 2614 0 18 0 0
   intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...]
   ctxt 1990473
   btime 1062191376

@@ -836,6 +836,7 @@
 - irq: servicing interrupts
 - softirq: servicing softirqs
 - steal: involuntary wait
+- guest: time used to run a virtual CPU
 
 The "intr" line gives counts of interrupts  serviced since boot time, for each
 of the  possible system interrupts.   The first  column  is the  total of  all

Signature · 3 lines

----------------- [email protected]  ------------------
  "La perfection est atteinte non quand il ne reste rien à
ajouter mais quand il ne reste rien à enlever." Saint Exupéry

AP

author

2008-01-29 10:40 UTC #2 lore raw

Quoted 4 lines · Laurent Vivier

Hi,
good thing, but could you update too "Table 1-3: Contents of the stat files" with fields added by 9ac52315d4cf5f561f36dabaf0720c00d3553162 .

Ok. Whilst in hiding from the grammar nazis, attempt #2 follows:

This patch syncs up the documentation for /proc/stat and /proc/<pid>/stat with that of the changes made in 5e84cfde51cf303d368fcb48f22059f37b3872de and 9ac52315d4cf5f561f36dabaf0720c00d3553162 respectively.

Signed-off-by Andrew P <[email protected]>

Documentation/filesystems/proc.txt +7 -4

diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt
@@ -192,7 +192,7 @@
 ..............................................................................
 
 
-Table 1-3: Contents of the stat files (as of 2.6.22-rc3)
+Table 1-3: Contents of the stat files (as of 2.6.24)
 ..............................................................................
  Field          Content
   pid           process id

@@ -237,6 +237,8 @@
   rt_priority   realtime priority
   policy        scheduling policy (man sched_setscheduler)
   blkio_ticks   time spent waiting for block IO
+  gtime         guest (virtual CPU) CPU time in jiffies
+  cgtime        guests' children's CPU time in jiffies
 ..............................................................................

@@ -813,9 +815,9 @@
 since the system first booted.  For a quick look, simply cat the file:
 
   > cat /proc/stat
-  cpu  2255 34 2290 22625563 6290 127 456 0
-  cpu0 1132 34 1441 11311718 3675 127 438 0
-  cpu1 1123 0 849 11313845 2614 0 18 0
+  cpu  2255 34 2290 22625563 6290 127 456 0 0
+  cpu0 1132 34 1441 11311718 3675 127 438 0 0
+  cpu1 1123 0 849 11313845 2614 0 18 0 0
   intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...]
   ctxt 1990473
   btime 1062191376

@@ -836,6 +838,7 @@
 - irq: servicing interrupts
 - softirq: servicing softirqs
 - steal: involuntary wait
+- guest: time used to run a virtual CPU
 
 The "intr" line gives counts of interrupts  serviced since boot time, for each
 of the  possible system interrupts.   The first  column  is the  total of  all

Signature · 1 line

Andrew