Commit 599448d8 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet

docs: powerpc: convert vcpudispatch_stats.txt to ReST

- Add a SPDX header;
- Use standard markup for document title;
- Adjust identation on lists and add blank lines where
  needed;
- Add it to the powerpc index.rst file.

Acked-by: Michael Ellerman <mpe@ellerman.id.au> # powerpc
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/a88855cc8b3a97b9b918a33e78e9ad000cf64be1.1592203650.git.mchehab+huawei@kernel.orgSigned-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 86de78d2
...@@ -31,6 +31,7 @@ powerpc ...@@ -31,6 +31,7 @@ powerpc
transactional_memory transactional_memory
ultravisor ultravisor
vas-api vas-api
vcpudispatch_stats
.. only:: subproject and html .. only:: subproject and html
......
VCPU Dispatch Statistics: .. SPDX-License-Identifier: GPL-2.0
=========================
========================
VCPU Dispatch Statistics
========================
For Shared Processor LPARs, the POWER Hypervisor maintains a relatively For Shared Processor LPARs, the POWER Hypervisor maintains a relatively
static mapping of the LPAR processors (vcpus) to physical processor static mapping of the LPAR processors (vcpus) to physical processor
...@@ -20,25 +23,29 @@ The statistics themselves are available by reading the procfs file ...@@ -20,25 +23,29 @@ The statistics themselves are available by reading the procfs file
a vcpu as represented by the first field, followed by 8 numbers. a vcpu as represented by the first field, followed by 8 numbers.
The first number corresponds to: The first number corresponds to:
1. total vcpu dispatches since the beginning of statistics collection 1. total vcpu dispatches since the beginning of statistics collection
The next 4 numbers represent vcpu dispatch dispersions: The next 4 numbers represent vcpu dispatch dispersions:
2. number of times this vcpu was dispatched on the same processor as last 2. number of times this vcpu was dispatched on the same processor as last
time time
3. number of times this vcpu was dispatched on a different processor core 3. number of times this vcpu was dispatched on a different processor core
as last time, but within the same chip as last time, but within the same chip
4. number of times this vcpu was dispatched on a different chip 4. number of times this vcpu was dispatched on a different chip
5. number of times this vcpu was dispatches on a different socket/drawer 5. number of times this vcpu was dispatches on a different socket/drawer
(next numa boundary) (next numa boundary)
The final 3 numbers represent statistics in relation to the home node of The final 3 numbers represent statistics in relation to the home node of
the vcpu: the vcpu:
6. number of times this vcpu was dispatched in its home node (chip) 6. number of times this vcpu was dispatched in its home node (chip)
7. number of times this vcpu was dispatched in a different node 7. number of times this vcpu was dispatched in a different node
8. number of times this vcpu was dispatched in a node further away (numa 8. number of times this vcpu was dispatched in a node further away (numa
distance) distance)
An example output::
An example output:
$ sudo cat /proc/powerpc/vcpudispatch_stats $ sudo cat /proc/powerpc/vcpudispatch_stats
cpu0 6839 4126 2683 30 0 6821 18 0 cpu0 6839 4126 2683 30 0 6821 18 0
cpu1 2515 1274 1229 12 0 2509 6 0 cpu1 2515 1274 1229 12 0 2509 6 0
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment