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

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.org


Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 86de78d2

Documentation/powerpc/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -31,6 +31,7 @@ powerpc 
    transactional_memory

    ultravisor

    vas-api

    vcpudispatch_stats



.. only::  subproject and html

Documentation/powerpc/vcpudispatch_stats.txt→Documentation/powerpc/vcpudispatch_stats.rst

+12 −5
Original line number Diff line number Diff line 
VCPU Dispatch Statistics:

=========================

.. SPDX-License-Identifier: GPL-2.0



========================

VCPU Dispatch Statistics

========================



For Shared Processor LPARs, the POWER Hypervisor maintains a relatively

static mapping of the LPAR processors (vcpus) to physical processor
@@ -20,9 +23,11 @@ The statistics themselves are available by reading the procfs file 
a vcpu as represented by the first field, followed by 8 numbers.



The first number corresponds to:



1. total vcpu dispatches since the beginning of statistics collection



The next 4 numbers represent vcpu dispatch dispersions:



2. number of times this vcpu was dispatched on the same processor as last

   time

3. number of times this vcpu was dispatched on a different processor core
@@ -33,12 +38,14 @@ The next 4 numbers represent vcpu dispatch dispersions: 


The final 3 numbers represent statistics in relation to the home node of

the vcpu:



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

8. number of times this vcpu was dispatched in a node further away (numa

   distance)



An example output:

An example output::



    $ sudo cat /proc/powerpc/vcpudispatch_stats

    cpu0 6839 4126 2683 30 0 6821 18 0

    cpu1 2515 1274 1229 12 0 2509 6 0

CRA Git | Maintained and supported by SUSTech CRA and CCSE