From nobody Sun May 5 01:51:42 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) client-ip=205.139.110.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 205.139.110.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=1586947929; cv=none; d=zohomail.com; s=zohoarc; b=Rzv6Ms13Q3HNkXe1XlMk2lIjQp3iUZSwDzUNK4mo7y2KnP8xqKPG+i2SxQjpl5m5G8ZZQ5f1TKQI3nYBkS9AlGTcbqCKkLz4M41F8GK6pHKQq17fOAyobuqtg5hecaDkVCbZv5z4Gb8aZP1bKizI2B6XVIpUIYq7ggp1Sb0B/R8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586947929; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=joqX0kw8wuRv1vHje8rK/kcBDkq9ElyToBPl5ig8L/U=; b=EjP5mHdk/f7+4DOeVMytIkmEBh+5nb4Yt61eSrwHMzq9S0LRA4Wi+Q5r4kHWIqkpRRvbHH5198XhJezfEr3W+HEi8z7Rvd3WEID+LBydohvbqpUd4xqeDaG9FV/NzGH7m9Id9ufTKG61tM46V1JkWCXpbWhnihPfUywv+AqpIvM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.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 [205.139.110.120]) by mx.zohomail.com with SMTPS id 158694792988230.936238290680194; Wed, 15 Apr 2020 03:52:09 -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-252-2CMOwsqWPG6xOz8KIeOMiA-1; Wed, 15 Apr 2020 06:52:06 -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 5A82118B9FC2; Wed, 15 Apr 2020 10:52:00 +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 ECCC95C1C5; Wed, 15 Apr 2020 10:51:58 +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 B784293068; Wed, 15 Apr 2020 10:51:57 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03FAptCp023860 for ; Wed, 15 Apr 2020 06:51:55 -0400 Received: by smtp.corp.redhat.com (Postfix) id 818311001DC0; Wed, 15 Apr 2020 10:51:55 +0000 (UTC) Received: from localhost (ovpn-113-55.ams2.redhat.com [10.36.113.55]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 28DCB1001B30 for ; Wed, 15 Apr 2020 10:51:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586947928; 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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=joqX0kw8wuRv1vHje8rK/kcBDkq9ElyToBPl5ig8L/U=; b=idEovF21eHqfuh4N5HUhNu+RzRqB5qDLb/bvLAjH0iBrjQC3ObHZloemQ55pTop8EZWRfe 04Vtqxr30U1HclWOQKiE8cECOCqW7ZGihRUKMJGw667GxDIPon0SifYH0oCx654nyl2cYr gqZ5awJOiKtu0Q1kRm5KseYImPzjV0Q= X-MC-Unique: 2CMOwsqWPG6xOz8KIeOMiA-1 From: Cornelia Huck To: libvir-list@redhat.com Subject: [PATCH] docs: add zpci information to pci-addresses.rst Date: Wed, 15 Apr 2020 12:51:51 +0200 Message-Id: <20200415105151.22832-1-cohuck@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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" Add some information on how pci address work on s390x. Signed-off-by: Cornelia Huck Reviewed-by: J=C3=A1n Tomko --- docs/pci-addresses.rst | 63 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index 923783a151b0..9e241a24fcfb 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -184,3 +184,66 @@ guest OS rather than as ``0001:08:00.1``, which is the= address of the device on the host. =20 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 + +For s390x machines, PCI addresses are handled yet differently. No +topology information is relayed in the PCI addresses; instead, the +``fid`` and ``uid`` elements of the ``zpci`` device convey information. +In the simplest case, the following XML snippet + +:: + + + + + +
+ +
+ + + + + +
+ +
+ + +will result in the following in a Linux guest:: + + 0001: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 f= lat +topology. + +Neither are any changes in the PCI address visible in the guest; replacing +the PCI address for the virtio-net device with + +:: + +
+ +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``). + +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 2.21.1