leandrof/linux
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: powerpc: convert vcpudispatch_stats.txt to ReST

Browse Source 
- 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: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/a88855cc8b3a97b9b918a33e78e9ad000cf64be1.1592203650.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2020-06-15 08:50:20 +02:00 committed by Jonathan Corbet
parent 86de78d2c5
commit 599448d8ca
2 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Documentation/powerpc/index.rst
View File

@ -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

17
Documentation/powerpc/vcpudispatch_stats.txt → Documentation/powerpc/vcpudispatch_stats.rst
View File

@ -1,5 +1,8 @@
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
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