libvirt/docs/schemas
Wim ten Have 74119a03f1 numa: describe siblings distances within cells
Add support for describing NUMA distances in a domain's <numa> <cell>
XML description.

Below is an example of a 4 node setup:

  <cpu>
    <numa>
      <cell id='0' cpus='0-3' memory='2097152' unit='KiB'>
        <distances>
          <sibling id='0' value='10'/>
          <sibling id='1' value='21'/>
          <sibling id='2' value='31'/>
          <sibling id='3' value='21'/>
        </distances>
      </cell>
      <cell id='1' cpus='4-7' memory='2097152' unit='KiB'>
        <distances>
          <sibling id='0' value='21'/>
          <sibling id='1' value='10'/>
          <sibling id='2' value='21'/>
          <sibling id='3' value='31'/>
        </distances>
      </cell>
      <cell id='2' cpus='8-11' memory='2097152' unit='KiB'>
        <distances>
          <sibling id='0' value='31'/>
          <sibling id='1' value='21'/>
          <sibling id='2' value='10'/>
          <sibling id='3' value='21'/>
        </distances>
      <cell id='3' cpus='12-15' memory='2097152' unit='KiB'>
        <distances>
          <sibling id='0' value='21'/>
          <sibling id='1' value='31'/>
          <sibling id='2' value='21'/>
          <sibling id='3' value='10'/>
        </distances>
      </cell>
    </numa>
  </cpu>

A <cell> defines a NUMA node. <distances> describes the NUMA distance
from the <cell> to the other NUMA nodes (the <sibling>s).  For example,
in above XML description, the distance between NUMA node0 <cell id='0'
...> and NUMA node2 <sibling id='2' ...> is 31.

Valid distance values are '10 <= value <= 255'.  A distance value of 10
represents the distance to the node itself.  A distance value of 20
represents the default value for remote nodes but other values are
possible depending on the physical topology of the system.

When distances are not fully described, any missing sibling distance
values will default to 10 for local nodes and 20 for remote nodes.

If distance is given for A -> B, then we default B -> A to the same
value instead of 20.

Signed-off-by: Wim ten Have <wim.ten.have@oracle.com>
Reviewed-by: Daniel P. Berrange <berrange@redhat.com>
Signed-off-by: Jim Fehlig <jfehlig@suse.com>
2017-11-12 19:39:00 -07:00
..
basictypes.rng numa: describe siblings distances within cells 2017-11-12 19:39:00 -07:00
capability.rng rng: Fix formatting 2017-09-12 13:41:21 +02:00
cputypes.rng numa: describe siblings distances within cells 2017-11-12 19:39:00 -07:00
domain.rng conf: set up for per-grammar overrides in schemas 2014-04-15 21:07:59 +02:00
domaincaps.rng schema: domaincaps: make machine element optional 2017-03-26 18:35:14 +04:00
domaincommon.rng domain: Allow 'model' attribute for ide controller 2017-11-03 13:15:54 -04:00
domainsnapshot.rng qemu: Store save cookie in save images and snapshots 2017-06-07 13:36:02 +02:00
interface.rng docs: make interface start mode element optional 2017-03-27 10:22:15 -04:00
network.rng rng: Fix formatting 2017-09-12 13:41:21 +02:00
networkcommon.rng domain_conf: Introduce <mtu/> to <interface/> 2017-01-26 09:59:56 +01:00
nodedev.rng rng: Fix formatting 2017-09-12 13:41:21 +02:00
nwfilter.rng rng: Fix formatting 2017-09-12 13:41:21 +02:00
secret.rng conf: Add new secret type "tls" 2016-09-09 08:20:05 -04:00
storagecommon.rng docs,rng: Adjust storage pool name grammar checks 2017-10-05 08:10:46 -04:00
storagepool.rng docs,rng: Adjust storage pool name grammar checks 2017-10-05 08:10:46 -04:00
storagevol.rng storage: unify permission formatting 2014-12-16 15:47:56 +01:00