[Bug 1039260] [NEW] proc(5) doesn't document all CPU values in /proc/stat

[Oliver Gerlich]

Public bug reported:

The proc(5) man page only documents nine fields for the "cpu" line in
/proc/stat:

  ...
  Since Linux 2.6.24, there is a ninth column, guest, which
  is the time spent running a virtual CPU for guest operat‐
  ing systems under the control of the Linux kernel.
  ...

On my Ubuntu 12.04 system with Linux 3.2.0-24-generic-pae there are ten fields:
  cpu  70741124 519708 27538725 1384358154 33244926 9450 248630 0 0 0

According to show_stat() function in fs/proc/stat.c in linux-3.2.0
source package, the tenth field is the "guest_nice" tick value. It would
be nice if this would be documented in the man page. I'm not quite sure
what the guest_nice value actually means, though.

ProblemType: Bug
DistroRelease: Ubuntu 12.04
Package: manpages 3.35-0.1ubuntu1
ProcVersionSignature: Ubuntu 3.2.0-24.37-generic-pae 3.2.14
Uname: Linux 3.2.0-24-generic-pae i686
NonfreeKernelModules: fglrx
ApportVersion: 2.0.1-0ubuntu12
Architecture: i386
Date: Mon Aug 20 23:58:44 2012
Dependencies:
 
InstallationMedia: Ubuntu 11.04 "Natty Narwhal" - Release i386 (20110427.1)
PackageArchitecture: all
SourcePackage: manpages
UpgradeStatus: Upgraded to precise on 2012-05-14 (97 days ago)

** Affects: manpages (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: apport-bug i386 precise

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to manpages in Ubuntu.
https://bugs.launchpad.net/bugs/1039260

Title:
  proc(5) doesn't document all CPU values in /proc/stat

Status in “manpages” package in Ubuntu:
  New

Bug description:
  The proc(5) man page only documents nine fields for the "cpu" line in
  /proc/stat:

    ...
    Since Linux 2.6.24, there is a ninth column, guest, which
    is the time spent running a virtual CPU for guest operat‐
    ing systems under the control of the Linux kernel.
    ...

  On my Ubuntu 12.04 system with Linux 3.2.0-24-generic-pae there are ten fields:
    cpu  70741124 519708 27538725 1384358154 33244926 9450 248630 0 0 0

  According to show_stat() function in fs/proc/stat.c in linux-3.2.0
  source package, the tenth field is the "guest_nice" tick value. It
  would be nice if this would be documented in the man page. I'm not
  quite sure what the guest_nice value actually means, though.

  ProblemType: Bug
  DistroRelease: Ubuntu 12.04
  Package: manpages 3.35-0.1ubuntu1
  ProcVersionSignature: Ubuntu 3.2.0-24.37-generic-pae 3.2.14
  Uname: Linux 3.2.0-24-generic-pae i686
  NonfreeKernelModules: fglrx
  ApportVersion: 2.0.1-0ubuntu12
  Architecture: i386
  Date: Mon Aug 20 23:58:44 2012
  Dependencies:
   
  InstallationMedia: Ubuntu 11.04 "Natty Narwhal" - Release i386 (20110427.1)
  PackageArchitecture: all
  SourcePackage: manpages
  UpgradeStatus: Upgraded to precise on 2012-05-14 (97 days ago)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1039260/+subscriptions