External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-01-08 22:15:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Improve zPCI section in pci-addresses.rst

Browse Source 
Improving the zPCI example by choosing more distinct values and
adding explanation for fid.

Signed-off-by: Boris Fiuczynski <fiuczy@linux.ibm.com>
Reviewed-by: Cornelia Huck <cohuck@redhat.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
This commit is contained in:
Boris Fiuczynski 2020-04-17 14:27:34 +02:00 committed by Andrea Bolognani
parent c889b2d614
commit e94ddeac06
1 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/pci-addresses.rst
View File

@ -176,14 +176,14 @@ In the simplest case, the following XML snippet
<model name='pci-bridge'/> <model name='pci-bridge'/>
<target chassisNr='1'/> <target chassisNr='1'/>
<address type='pci' domain='0x0000' bus='0x00' slot='0x01' function='0x0'> <address type='pci' domain='0x0000' bus='0x00' slot='0x01' function='0x0'>
<zpci uid='0x0002' fid='0x00000001'/> <zpci uid='0x0001' fid='0x00000000'/>
</address> </address>
</controller> </controller>
<interface type='bridge'> <interface type='bridge'>
<source bridge='virbr0'/> <source bridge='virbr0'/>
<model type='virtio'/> <model type='virtio'/>
<address type='pci' domain='0x0000' bus='0x01' slot='0x01' function='0x0'> <address type='pci' domain='0x0000' bus='0x01' slot='0x01' function='0x0'>
<zpci uid='0x0001' fid='0x00000000'/> <zpci uid='0x0007' fid='0x00000003'/>
</address> </address>
</interface> </interface>
@ -191,21 +191,23 @@ will result in the following in a Linux guest:
:: ::
0001:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device 0007:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device
Note that the PCI bridge is not visible in the guest; s390x always has a flat Note that the PCI bridge is not visible in the guest; s390x always has a flat
topology. topology. The PCI address in the guest is generated from the information
provided via the ``zpci`` element: more specifically, ``uid`` is used as the
PCI domain. ``fid`` doesn't appear in the PCI address itself, but it will be
used in sysfs (``/sys/bus/pci/slots/$fid/...``).
Neither are any changes in the PCI address visible in the guest; replacing Any changes in the PCI address are not visible in the guest; replacing the PCI
the PCI address for the ``virtio-net`` device with address for the ``virtio-net`` device with
:: ::
<address type='pci' domain='0x0000' bus='0x01' slot='0x07' function='0x3'> <address type='pci' domain='0x0000' bus='0x01' slot='0x06' function='0x4'>
will result in the exactly same view in the guest, as the addresses there will result in the exactly same view in the guest, as the ``fid`` and ``uid``
are generated from the information provided via the ``zpci`` element (in values in the ``zpci`` element remain unchanged.
fact, from the ``uid``).
Device assignment Device assignment