From nobody Sun May 5 13:15:36 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1586971919; cv=none; d=zohomail.com; s=zohoarc; b=G/oBFzD7UA8qcO5Wf102upWeIxQv5vYnpkZ+/soQ+kbESByG9rX6DBXagUsgiDDWUTYiejHt2ycbxp4NslfVfXXohfj6pGsCWU9WUoL8yjOk1l2awo8hojBaio1Gkl52lzPdogM+R3v401MG+hxCZHX/qYfyf0Lzq7c5mjOPLks= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586971919; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=m8aIftUYyaQZVAEtmTqRF4M7LtErmTRhg5j3TgdKZ7U=; b=RLBtsO9NvNlp+R2YpdfWd3kKwZYNWr+nEqlhRJvXPd+WFOg+Iq/w2WgkMQi4eDbgXgOFbv+dBb/05Rl8zJcnVErl5s8+mDAic58qWJDRKB0gSVyxA1DP7JLsh+IX0BZkQgocOQLxOmwSj8KmB372HkKJrhp2m3Y4bQFe9r1ZRbU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1586971919908370.1200913165102; Wed, 15 Apr 2020 10:31:59 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-91-dK4scPGaMXK8ktz9phjMkw-1; Wed, 15 Apr 2020 13:31:56 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 420B210CE781; Wed, 15 Apr 2020 17:31:50 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 035E2116D7C; Wed, 15 Apr 2020 17:31:50 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 86DD893362; Wed, 15 Apr 2020 17:31:46 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03FHVju3020427 for ; Wed, 15 Apr 2020 13:31:45 -0400 Received: by smtp.corp.redhat.com (Postfix) id 3AF9511D2D9; Wed, 15 Apr 2020 17:31:45 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.195.84]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 2C75C11A267 for ; Wed, 15 Apr 2020 17:31:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586971918; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=m8aIftUYyaQZVAEtmTqRF4M7LtErmTRhg5j3TgdKZ7U=; b=iCT9xzK06xmCliX7iQzOJOysMKrZyXxLLHMa4yI6dR0t4WT5XMSPFrRgQU9SnDYqMTCrLN +rKA5r2msYZP9/7K80j+O//n3Aex+aRVjysNxf4Wybwc6nqhtoN7V0M99hcXf66SYRlNvb stz4AmFAXSWFK826qi7a02W7is6IUfo= X-MC-Unique: dK4scPGaMXK8ktz9phjMkw-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 1/4] docs: Use consistent style in pci-addresses.rst Date: Wed, 15 Apr 2020 19:31:33 +0200 Message-Id: <20200415173136.500247-2-abologna@redhat.com> In-Reply-To: <20200415173136.500247-1-abologna@redhat.com> References: <20200415173136.500247-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Indent all code snippets by the same number of spaces, and don't embed the :: marker in the line preceding a code block. This commit is best viewed with 'git show -w'. Signed-off-by: Andrea Bolognani Reviewed-by: Cornelia Huck --- docs/pci-addresses.rst | 60 ++++++++++++++++++++++-------------------- 1 file changed, 32 insertions(+), 28 deletions(-) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index fbc741e344..0b83bb231f 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -196,24 +196,26 @@ In the simplest case, the following XML snippet =20 :: =20 - - - - -
- -
- - - - - -
- -
- - -will result in the following in a Linux guest:: + + + + +
+ +
+ + + + + +
+ +
+ + +will result in the following in a Linux guest: + +:: =20 0001:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device =20 @@ -221,7 +223,7 @@ Note that the PCI bridge is not visible in the guest; s= 390x always has a flat topology. =20 Neither are any changes in the PCI address visible in the guest; replacing -the PCI address for the virtio-net device with +the PCI address for the ``virtio-net`` device with =20 :: =20 @@ -236,15 +238,17 @@ snippet =20 :: =20 - - - - -
- -
- + + + + +
+ +
+ =20 -will yield the following result in a Linux guest:: +will yield the following result in a Linux guest: + +:: =20 0007:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device --=20 2.25.2 From nobody Sun May 5 13:15:36 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) client-ip=205.139.110.61; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1586972064; cv=none; d=zohomail.com; s=zohoarc; b=G7XCwvYT10Z9vcwnJ1oBppbDbVZ90O2UokylCJ9lsXTWjKRNtsWATa4aMJODAZdXTMYCtFAQu/cHSMHAc7T9OV4S6VZa+ZtFxunRbJqDyz7qO2exU0S3Qim6z26eB5WUPgT/AtRSA8jeYPVJQPWaHwjcP43a9xkVxcqfCw8x7Eo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586972064; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=lvWSLEpXpoM5eKQiEbxBcyGCxmx5Q4L/NQblCktT63w=; b=VNBih4Ts4WPG41hTYIqfDdB/zXUZBJRNm1mJqROwaIrdY9m1mAObVQPbkUlxkydI9pKsc3IZGbQSHmHkdddnQU9uNbi6rS4o6pdCVivvQLjT4Q2ajGBKdLQCv4apO/MGV8Ofcz013jG3unlzQwQH3+P2ftec891I/ZMVaqYaltE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) by mx.zohomail.com with SMTPS id 15869720646530.25191437637317904; Wed, 15 Apr 2020 10:34:24 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-372-x-zc1PK8O96d8Ytd3W_hJg-1; Wed, 15 Apr 2020 13:32:13 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id ED8438010E4; Wed, 15 Apr 2020 17:32:07 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C07E51265B2; Wed, 15 Apr 2020 17:32:07 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 6B34818089CF; Wed, 15 Apr 2020 17:32:07 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03FHVk3P020435 for ; Wed, 15 Apr 2020 13:31:46 -0400 Received: by smtp.corp.redhat.com (Postfix) id A4D2A11D2D9; Wed, 15 Apr 2020 17:31:46 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.195.84]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 90E8311A267 for ; Wed, 15 Apr 2020 17:31:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586971935; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=lvWSLEpXpoM5eKQiEbxBcyGCxmx5Q4L/NQblCktT63w=; b=jUzD25jwJY0mB2/qJed9QBv/XkqPSt3j6Un9lgctfmEsjgpT1y7XWGmKF8kHQw8UI92yEN qaNTktKECEIDcUtwc/EdWtxMQYhGEx8ueCyhSiCO5Wm9GquBkWRFur2QOFgI6qjjMz7Kly ++6IxE1idASX9k6XGR1ORosiCeJdBxU= X-MC-Unique: x-zc1PK8O96d8Ytd3W_hJg-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 2/4] docs: Move sections around in pci-addresses.rst Date: Wed, 15 Apr 2020 19:31:34 +0200 Message-Id: <20200415173136.500247-3-abologna@redhat.com> In-Reply-To: <20200415173136.500247-1-abologna@redhat.com> References: <20200415173136.500247-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" The section about VFIO devices is kept separate from the rest because it's less about domain XML and guest OS disagreeing on the PCI address of a device, and more about which of the two PCI addresses in the domain XML is even relevant to the guest OS. The section on zPCI addresses, on the other hand, falls squarely in the "more complex cases" category, so it should live in the corresponding section. Signed-off-by: Andrea Bolognani Reviewed-by: Cornelia Huck --- docs/pci-addresses.rst | 57 +++++++++++++++++++++--------------------- 1 file changed, 28 insertions(+), 29 deletions(-) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index 0b83bb231f..566c81d957 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -158,36 +158,8 @@ Once again, while the PCI addresses seen in the domain= XML and those seen by the guest OS do not match, the relationships between the various devices are preserved. =20 - -Device assignment -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -When using VFIO to assign host devices to a guest, an additional -caveat to keep in mind that the guest OS will base its decisions upon -the *target address* (guest side) rather than the *source address* -(host side). - -For example, the domain XML snippet - -:: - - - - -
- -
- - -will result in the device showing up as ``0000:00:01.0`` in the -guest OS rather than as ``0001:08:00.1``, which is the address of the -device on the host. - -Of course, all the rules and behaviors described above still apply. - - zPCI addresses -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +-------------- =20 For s390x machines, PCI addresses are handled yet differently. No topology information is relayed in the PCI addresses; instead, the @@ -252,3 +224,30 @@ will yield the following result in a Linux guest: :: =20 0007:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device + + +Device assignment +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +When using VFIO to assign host devices to a guest, an additional +caveat to keep in mind that the guest OS will base its decisions upon +the *target address* (guest side) rather than the *source address* +(host side). + +For example, the domain XML snippet + +:: + + + + +
+ +
+ + +will result in the device showing up as ``0000:00:01.0`` in the +guest OS rather than as ``0001:08:00.1``, which is the address of the +device on the host. + +Of course, all the rules and behaviors described above still apply. --=20 2.25.2 From nobody Sun May 5 13:15:36 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1586971942; cv=none; d=zohomail.com; s=zohoarc; b=l5Dmv7Y8FN8OqMYtZgFs4Hq7NOTlwM0jRxu4T7p3oC0PDC8U6oQFwvuHpgsnhRX+prDtZPE71wZPsE5w+AeKkkyii5+VOOhhfqIeCfRTqroepONY+81d3pZzWQWJ5Y+Flb2xhJ4StFlnf0SS1zhIcrDNMxf1/xGtuEvaIibwNZw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586971942; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=zJb+ZemsAwCMS8+lE7q7zX7bx12+/YEg4K7ZSryAskw=; b=OU4bL6J8/KYHIg5v30dcPoQ8GzkXsB6xzat7Zz4EdwTM/Hvq/cvNoA+108RzqsmVBeEZOnR/2ZAcQaAo6rEMAs3looVbMvdHRlS9q7eTJBxRO0iVBxS4PvogI3CMevWpMZX3Pgb6H6JjMf6kST4CghAjIRvTXV0sNTlLeBEfOiI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1586971942654368.48618486012026; Wed, 15 Apr 2020 10:32:22 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-61-sY6_dkehOdunDrya4q4Beg-1; Wed, 15 Apr 2020 13:32:18 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id F1183DB61; Wed, 15 Apr 2020 17:32:12 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C24F35C1D6; Wed, 15 Apr 2020 17:32:12 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 62F2793363; Wed, 15 Apr 2020 17:32:12 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03FHVm2Q020445 for ; Wed, 15 Apr 2020 13:31:48 -0400 Received: by smtp.corp.redhat.com (Postfix) id 1B07112651A; Wed, 15 Apr 2020 17:31:48 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.195.84]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 43F9811A267 for ; Wed, 15 Apr 2020 17:31:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586971941; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=zJb+ZemsAwCMS8+lE7q7zX7bx12+/YEg4K7ZSryAskw=; b=LKES6cVJS3KXiMNtcGSKSex0UcE1wq90EFVMF0co/vH+rcHSb7PRsgukDI2A4iEK0Q40oO JaVuoKDc0Qr3G4fRGFB/5UuGIMSMvknsjI3JZtPlWGxlp51tc6Ao8fWNXEWWwXXEYr+M52 wCj86xwzTZ1szAmTid/zm+vZ+A8XJf0= X-MC-Unique: sY6_dkehOdunDrya4q4Beg-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 3/4] docs: Remove MAC addresses from pci-addresses.rst Date: Wed, 15 Apr 2020 19:31:35 +0200 Message-Id: <20200415173136.500247-4-abologna@redhat.com> In-Reply-To: <20200415173136.500247-1-abologna@redhat.com> References: <20200415173136.500247-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Bolognani Reviewed-by: Cornelia Huck --- docs/pci-addresses.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index 566c81d957..86a41df6ce 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -177,7 +177,6 @@ In the simplest case, the following XML snippet
-
@@ -211,7 +210,6 @@ snippet :: =20 -
--=20 2.25.2 From nobody Sun May 5 13:15:36 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) client-ip=205.139.110.61; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1586971922; cv=none; d=zohomail.com; s=zohoarc; b=TDcdAomGD/MIHZsaybIQTyHbCYGC5pHt62WJwS83/CUP9nfNDNlhyyPvrATWApqccmfN6jWZlc7IbI2eTJV0Qkgce2lVZ9T6aLpdvmQDR3ns6/nokiSqDvJBmL7svWSlwUmk1YIKUzwmvnmrPzCZ4MvDfZqGHaL1I7crBovZ1DA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586971922; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=ZZfYAIzGVOF4OBWhu5PL4WmF+63FO2bmigtYqZ9GriE=; b=Ep/iIGXXPT/eolVaAXCUpa1mWTioTCZGbry5bXUbIGye1tlkJNBWnu6oNY8oY6aiBHm6uagstSqRRZZl2awe8PNWzFokEWFtrNzIUQADEo6xyi4WYL7ufG7ZC0tcxjOvVLa/WtdYjN6JSBk0gTmjnKZCry4NNi3o153UnAfm1Tk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-2.mimecast.com [205.139.110.61]) by mx.zohomail.com with SMTPS id 1586971922764836.3357944165587; Wed, 15 Apr 2020 10:32:02 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-10-O-za4UA8ODyUZn0Z5Xr6uQ-1; Wed, 15 Apr 2020 13:31:59 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 948FC802566; Wed, 15 Apr 2020 17:31:53 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 46EEB9F9AC; Wed, 15 Apr 2020 17:31:52 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id EB58D18089CD; Wed, 15 Apr 2020 17:31:51 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03FHVnRF020457 for ; Wed, 15 Apr 2020 13:31:49 -0400 Received: by smtp.corp.redhat.com (Postfix) id 53B4612651A; Wed, 15 Apr 2020 17:31:49 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.195.84]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 724B111A267 for ; Wed, 15 Apr 2020 17:31:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586971921; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=ZZfYAIzGVOF4OBWhu5PL4WmF+63FO2bmigtYqZ9GriE=; b=PzUVK8AfCGfWerW4SeavndqeOFLDclZYQBID93r+RXh+w8CoT99p4LyGqp/myifQ9KW/Zo 1laYICwVHfBRBv291aCuzD71+SM+Vry0rdp3wOVyhnXxpQYiMH6upQAqxEKVvQHM4WZWz3 jE+LZum6b3Fsz+PWFWOFDVvXP6ndVgU= X-MC-Unique: O-za4UA8ODyUZn0Z5Xr6uQ-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 4/4] docs: Remove one example from pci-addresses.rst Date: Wed, 15 Apr 2020 19:31:36 +0200 Message-Id: <20200415173136.500247-5-abologna@redhat.com> In-Reply-To: <20200415173136.500247-1-abologna@redhat.com> References: <20200415173136.500247-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" The idea behind this document is to show, with actual examples, that users should not expect PCI addresses in the domain XML and in the guest OS to match. The first zPCI example already serves this purpose perfectly, so in the interest of keeping the page as brief and easy to digest as possible the second one is removed. Signed-off-by: Andrea Bolognani Reviewed-by: Cornelia Huck --- docs/pci-addresses.rst | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index 86a41df6ce..1d2dc8e5fc 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -204,25 +204,6 @@ will result in the exactly same view in the guest, as = the addresses there are generated from the information provided via the ``zpci`` element (in fact, from the ``uid``). =20 -Therefore, replacing the virtio-net device definition with the following X= ML -snippet - -:: - - - - -
- -
- - -will yield the following result in a Linux guest: - -:: - - 0007:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device - =20 Device assignment =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.25.2