From nobody Tue May 13 07:03:27 2025 Delivered-To: importer2@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer2=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1675110758; cv=none; d=zohomail.com; s=zohoarc; b=mmom+ccUuoaOuMGWbQFkjk9QZvC9TS0NwYkCySBmCCrkTe+2fHjvqa6GuWAP26uVAg48PdvY5Lfz1aKE9yQIISMuX/WXTx53LbEz8gNbCPl7TDsj7mziZzIEcE5CP1WJodPR24l0oSm9Q9FYDsGsNPZj7Vo01jjSqx18mDpXQSs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1675110758; h=Content-Type:Content-Transfer-Encoding:Cc: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=I4XNQdhv6ZtyeuNVlIseJKebey1JzlwjNMp41O5jDVk=; b=F9/uOGxQZ0m7EtFI8VprSBonoeBS3aOYtGUk1ifHfYjeY6pSPPjKcSNaQlSP/iso8OZZPGijK2eHCb/0zYKlVJy+NznBBdqzhqzb/X7x7bjuY6cbIFG1m6VT4eR3406ovjG3UwamOxht9wQmpVIvzZdPibdRUN+XFoe8ZAnlrq8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer2=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1675110758789801.3942100762484; Mon, 30 Jan 2023 12:32:38 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pMahL-0001su-9g; Mon, 30 Jan 2023 15:24:15 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pMaf9-0007ZU-2P for qemu-devel@nongnu.org; Mon, 30 Jan 2023 15:21:59 -0500 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pMaf2-0007UE-2C for qemu-devel@nongnu.org; Mon, 30 Jan 2023 15:21:58 -0500 Received: from mail-ej1-f70.google.com (mail-ej1-f70.google.com [209.85.218.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-497-29UQ5aIbOxiKsYLHyMunVQ-1; Mon, 30 Jan 2023 15:21:50 -0500 Received: by mail-ej1-f70.google.com with SMTP id d10-20020a170906640a00b008787d18c373so7037903ejm.17 for ; Mon, 30 Jan 2023 12:21:50 -0800 (PST) Received: from redhat.com ([2.52.144.173]) by smtp.gmail.com with ESMTPSA id ce4-20020a170906b24400b0078d3f96d293sm7366835ejb.30.2023.01.30.12.21.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 30 Jan 2023 12:21:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1675110111; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=I4XNQdhv6ZtyeuNVlIseJKebey1JzlwjNMp41O5jDVk=; b=GWz3Z2aaP1Hv54C/+r0MrR7YZnf7zRUwIQinDIXgKjVV1/bRy5MCIRfmyItWFO880eU1Zn Gj2YHYKvwxaB2/s+agqtGoaMH0aUo3eeIMQNaEX0r7woJkmTGVj3svSp8AGbr9zHaw8d1h 6TGzp7SvWYd8Oe6rHPSgMGebAA2HWeM= X-MC-Unique: 29UQ5aIbOxiKsYLHyMunVQ-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=I4XNQdhv6ZtyeuNVlIseJKebey1JzlwjNMp41O5jDVk=; b=XY8ZNU6qhBSiRBVDYhSMTzg7qaFZ7eyHkXL6yXxXpQV7LHmonxJRxnjea38nA1KFqv VwPsE9Zs3UWlj7nFKt5tEKfLPianAQrxQEBbTl/M3rK9yTOVRtPRLytkXFvRuujG9CUK U2vGsr7oDnjPiaUcyriX+u0BcESDVehNWzrg4lUUrSPP3z+ERiCoVO9zUU32ZmXlbW1Z 7qFPjJyDZCzcSFI+3BwYZyc88Bz4CFPEQZnyBZmPYSGgNMM6qotGEibmdkg6k+8RCQER RhJMCk3F7SXrKGlW/tFSD6SIlnarQQC1vgRV3uUr2U+P5rhGiFAd81VgqtQvPhmCntmj J9eA== X-Gm-Message-State: AO0yUKW7bKln8Pos1uQS9clANcg6snVBSI+SA1+pkKO2nu2AnD4DiUX5 UgSu7RZTZa+DkAABBYWZNKkng1CsSb1Px0C8sdwWEssdZmTIi+UZRl/TOr/S+P4MdzNfnoOj36A CYMHJZ8Hap4wGX2geIKa67ClRZ1ACLjdWAqlaGX5f+kyqUFjjPKbH1iMWp9aG X-Received: by 2002:a17:906:9bd8:b0:883:ba98:204d with SMTP id de24-20020a1709069bd800b00883ba98204dmr9486979ejc.65.1675110108917; Mon, 30 Jan 2023 12:21:48 -0800 (PST) X-Google-Smtp-Source: AK7set8KknPptBk/Adku+r3H8P35498yRd++/yBVUaPkhxXs42uHEHS/LuGONdENi6IJxDlDF1AfVw== X-Received: by 2002:a17:906:9bd8:b0:883:ba98:204d with SMTP id de24-20020a1709069bd800b00883ba98204dmr9486957ejc.65.1675110108689; Mon, 30 Jan 2023 12:21:48 -0800 (PST) Date: Mon, 30 Jan 2023 15:21:45 -0500 From: "Michael S. Tsirkin" To: qemu-devel@nongnu.org Cc: Peter Maydell , Marcel Apfelbaum , Andrew Jones , Laszlo Ersek , Daniel P =?utf-8?B?LiBCZXJyYW5nw6k=?= , Marcel Apfelbaum Subject: [PULL 56/56] docs/pcie.txt: Replace ioh3420 with pcie-root-port Message-ID: <20230130201810.11518-57-mst@redhat.com> References: <20230130201810.11518-1-mst@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable In-Reply-To: <20230130201810.11518-1-mst@redhat.com> X-Mailer: git-send-email 2.27.0.106.g8ac3dc51b1 X-Mutt-Fcc: =sent Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer2=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=mst@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer2=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer2=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1675110760264100004 From: Marcel Apfelbaum Do not mention ioh3420 in the "how to" doc. The device still works and can be used by already existing setups, but no need to be mentioned. Suggested-by: Andrew Jones Reviewed-by: Laszlo Ersek Signed-off-by: Marcel Apfelbaum Signed-off-by: Daniel P. Berrang=C3=A9 Message-Id: <20230123174205.683979-1-berrange@redhat.com> Reviewed-by: Michael S. Tsirkin Signed-off-by: Michael S. Tsirkin --- docs/pcie.txt | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/pcie.txt b/docs/pcie.txt index 89e3502075..df49178311 100644 --- a/docs/pcie.txt +++ b/docs/pcie.txt @@ -48,8 +48,8 @@ Place only the following kinds of devices directly on the= Root Complex: strangely when PCI Express devices are integrated with the Root Complex. =20 - (2) PCI Express Root Ports (ioh3420), for starting exclusively PCI Exp= ress - hierarchies. + (2) PCI Express Root Ports (pcie-root-port), for starting exclusively + PCI Express hierarchies. =20 (3) PCI Express to PCI Bridge (pcie-pci-bridge), for starting legacy P= CI hierarchies. @@ -70,7 +70,7 @@ Place only the following kinds of devices directly on the= Root Complex: -device pxb-pcie,id=3Dpcie.1,bus_nr=3Dx[,numa_node=3Dy][,addr=3D= z] PCI Express Root Ports and PCI Express to PCI bridges can be connected to the pcie.1 bus: - -device ioh3420,id=3Droot_port1[,bus=3Dpcie.1][,chassis=3Dx][,sl= ot=3Dy][,addr=3Dz] \ + -device pcie-root-port,id=3Droot_port1[,bus=3Dpcie.1][,chassis= =3Dx][,slot=3Dy][,addr=3Dz] \ -device pcie-pci-bridge,id=3Dpcie_pci_bridge1,bus=3Dpcie.1 =20 =20 @@ -112,14 +112,14 @@ Plug only PCI Express devices into PCI Express Ports. ------------ =20 2.2.1 Plugging a PCI Express device into a PCI Express Root Port: - -device ioh3420,id=3Droot_port1,chassis=3Dx,slot=3Dy[,bus=3Dpcie= .0][,addr=3Dz] \ + -device pcie-root-port,id=3Droot_port1,chassis=3Dx,slot=3Dy[,bus= =3Dpcie.0][,addr=3Dz] \ -device ,bus=3Droot_port1 2.2.2 Using multi-function PCI Express Root Ports: - -device ioh3420,id=3Droot_port1,multifunction=3Don,chassis=3Dx,addr= =3Dz.0[,slot=3Dy][,bus=3Dpcie.0] \ - -device ioh3420,id=3Droot_port2,chassis=3Dx1,addr=3Dz.1[,slot=3Dy1][= ,bus=3Dpcie.0] \ - -device ioh3420,id=3Droot_port3,chassis=3Dx2,addr=3Dz.2[,slot=3Dy2][= ,bus=3Dpcie.0] \ + -device pcie-root-port,id=3Droot_port1,multifunction=3Don,chassis=3D= x,addr=3Dz.0[,slot=3Dy][,bus=3Dpcie.0] \ + -device pcie-root-port,id=3Droot_port2,chassis=3Dx1,addr=3Dz.1[,slot= =3Dy1][,bus=3Dpcie.0] \ + -device pcie-root-port,id=3Droot_port3,chassis=3Dx2,addr=3Dz.2[,slot= =3Dy2][,bus=3Dpcie.0] \ 2.2.3 Plugging a PCI Express device into a Switch: - -device ioh3420,id=3Droot_port1,chassis=3Dx,slot=3Dy[,bus=3Dpcie.0][= ,addr=3Dz] \ + -device pcie-root-port,id=3Droot_port1,chassis=3Dx,slot=3Dy[,bus=3Dp= cie.0][,addr=3Dz] \ -device x3130-upstream,id=3Dupstream_port1,bus=3Droot_port1[,addr=3D= x] \ -device xio3130-downstream,id=3Ddownstream_port1,bus=3Dupstream_port= 1,chassis=3Dx1,slot=3Dy1[,addr=3Dz1]] \ -device ,bus=3Ddownstream_port1 --=20 MST