2008-01-29 09:14:36

by AP

Subject: [PATCH] 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]>

diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt
--- linux/Documentation/filesystems/proc.txt 2008-01-29 11:27:18.000000000 +1100
+++ work/Documentation/filesystems/proc.txt 2008-01-29 11:37:41.000000000 +1100
@@ -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

--
Andrew

2008-01-29 09:04:40

by Laurent Vivier

Subject: Re: [PATCH] documentation: Add desc of new cpu fields in /proc/stat

Hi,

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

Thank you,
Laurent

On mar, 2008-01-29 at 19:43 +1100, AP wrote:
> 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]>
>
> diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt
> --- linux/Documentation/filesystems/proc.txt 2008-01-29 11:27:18.000000000 +1100
> +++ work/Documentation/filesystems/proc.txt 2008-01-29 11:37:41.000000000 +1100
> @@ -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
>
--
----------------- [email protected] ------------------
"La perfection est atteinte non quand il ne reste rien à
ajouter mais quand il ne reste rien à enlever." Saint Exupéry

2008-01-29 10:40:20

by AP

Subject: Re: [PATCH] documentation: Add desc of new cpu fields in /proc/stat

On Tue, Jan 29, 2008 at 10:05:16AM +0100, Laurent Vivier wrote:
> 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]>

diff -aur linux/Documentation/filesystems/proc.txt work/Documentation/filesystems/proc.txt
--- linux/Documentation/filesystems/proc.txt 2008-01-29 11:27:18.000000000 +1100
+++ work/Documentation/filesystems/proc.txt 2008-01-29 21:30:59.000000000 +1100
@@ -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

--
Andrew