From patchwork Thu Nov 17 15:07:59 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 21709 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp452496wrr; Thu, 17 Nov 2022 07:10:39 -0800 (PST) X-Google-Smtp-Source: AA0mqf67UtZnIhURiKq0/1cCJvQy9nYs5tH3UaupbAH5Qitn8MFQOfAxUPbJDIl6S2KGQqu7oSDp X-Received: by 2002:a17:907:a803:b0:7ae:bfeb:f484 with SMTP id vo3-20020a170907a80300b007aebfebf484mr2583265ejc.174.1668697839365; Thu, 17 Nov 2022 07:10:39 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668697839; cv=none; d=google.com; s=arc-20160816; b=GxLI7+6Nk6dBl2aCRdO99hNp5dDzIbyrWb/9uZTcBy58qQcXatg3AddI1xCJOK0nin D9ZcdyXXG4hFbEf72TLx0vvPAwn5hQSk8Qr3od5JPoTq8frsmNrs+p6mEtjui4+5ZvoB T56NZufUhs5Oi1NUIAZPRyWDq0SRYCYuTrW5pBdAyXHbKxolUHXcy4G6bLEWAsECzbZQ 1OjLC5QR5+2SDxFQbQlUSDdJ4qXjZx5e2b4g/HTMcrQG03aHN2QYYWCPBYD9tHpL5s10 vnzBiewZ5zk0p0Vp0ar7+iibCRDIKE+fOVsXNQmr6WL7DPv/DajE/57Z1hOD+3iB6RHC pY0w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:robot-unsubscribe :robot-id:message-id:mime-version:references:in-reply-to:cc:subject :to:reply-to:sender:from:dkim-signature:dkim-signature:date; bh=UaWecbbSjg3Tm0wvLI1YflnP0pLAt0Tas3tsFTOhOOc=; b=gGxQY3q7gsQmdMZ+/7jlu+MM+zn1gcJJAzbJqMsAYk94XcCDsM6I+4MSjDCtfOgET7 ym3nnFjQC8IrIKWb3tnLU+Tf5Abr2BwGF4bzFe1x8XYo3Uesby05ysff+d26rqJBfMaI OCqgUESpxR4Y+UDRcoNG0LQ9EcHyrSrGmFfzd9saTCpO6jpzUc2xbim4kqm1zJZ7BtyA 9o26Y4vbPHS+GjY2QbBDyrK0WLq0M5W9cZZY2zOCdFMzYAsrWF5K3muGvfNn02q9hYwX G9+SmbxmEPk/FHVyVBaeWzbwGh5fy1Rb3Kzfvp3v++g1GVxt0uvuSLTobJR2ln0xyL0d gC/Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=kWqSDsXH; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b=5IshFqBH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ji15-20020a170907980f00b007417c6edb0asi802406ejc.402.2022.11.17.07.10.06; Thu, 17 Nov 2022 07:10:39 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=kWqSDsXH; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b=5IshFqBH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240180AbiKQPIx (ORCPT + 99 others); Thu, 17 Nov 2022 10:08:53 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53630 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234795AbiKQPIC (ORCPT ); Thu, 17 Nov 2022 10:08:02 -0500 Received: from galois.linutronix.de (Galois.linutronix.de [IPv6:2a0a:51c0:0:12e:550::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 50043769D3; Thu, 17 Nov 2022 07:08:02 -0800 (PST) Date: Thu, 17 Nov 2022 15:07:59 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1668697681; h=from:from:sender:sender:reply-to: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=UaWecbbSjg3Tm0wvLI1YflnP0pLAt0Tas3tsFTOhOOc=; b=kWqSDsXH5Kfu0wMY0zghrvt5aV2hU+WTVN/WrvDZcJF27Scenmv6ywA6Xe3niIUu1K6VXf X1u64rrgLENYYL1WnJgPk+QoMRc0DvX+JOyRrtsOmKzhSM7gRG2TGM9CyizS/YqwqJb6dQ 6Y9+y1+06WvUczkz5v8WLq7TVRJrH5EK9tqXxbZqnaH45iFD1LliBdkyJIW2JTp00TuV5u BZug7qnDzgnn58AoW37gvip1F3osCMGRARs8ApEbdGaMI8pJ8ABRF8lm5AoQ7qS/A9Z8lh bC974/xuTaKJH9FQH+nxCT9/+V9ZrO8FwZ045RD1AIlKbne/+J0mMgpNNPbseg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1668697681; h=from:from:sender:sender:reply-to: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=UaWecbbSjg3Tm0wvLI1YflnP0pLAt0Tas3tsFTOhOOc=; b=5IshFqBHNQG7UslwOOZOi6BWujQ3o7yZ8JtBSFyxbzKmBF0xfDNLTrIKnVmgs0dDFjnIgw BoYNaK2Deg0T1nCw== From: "tip-bot2 for Ahmed S. Darwish" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: irq/core] Documentation: PCI: Add reference to PCI/MSI device driver APIs Cc: "Ahmed S. Darwish" , Thomas Gleixner , Jason Gunthorpe , Bjorn Helgaas , x86@kernel.org, linux-kernel@vger.kernel.org, maz@kernel.org In-Reply-To: <20221111122015.397739421@linutronix.de> References: <20221111122015.397739421@linutronix.de> MIME-Version: 1.0 Message-ID: <166869767973.4906.15641891890847821145.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749208403354013744?= X-GMAIL-MSGID: =?utf-8?q?1749756505621574167?= The following commit has been merged into the irq/core branch of tip: Commit-ID: 88614075a952b1af50f5fb10c958e311f6b4f68a Gitweb: https://git.kernel.org/tip/88614075a952b1af50f5fb10c958e311f6b4f68a Author: Ahmed S. Darwish AuthorDate: Fri, 11 Nov 2022 14:55:04 +01:00 Committer: Thomas Gleixner CommitterDate: Thu, 17 Nov 2022 15:15:21 +01:00 Documentation: PCI: Add reference to PCI/MSI device driver APIs All exported device-driver MSI APIs are now grouped in one place at drivers/pci/msi/api.c with comprehensive kernel-docs added. Reference these kernel-docs in the official PCI/MSI howto. Signed-off-by: Ahmed S. Darwish Signed-off-by: Thomas Gleixner Reviewed-by: Jason Gunthorpe Acked-by: Bjorn Helgaas Link: https://lore.kernel.org/r/20221111122015.397739421@linutronix.de --- Documentation/PCI/msi-howto.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/PCI/msi-howto.rst b/Documentation/PCI/msi-howto.rst index aa2046a..8ae461e 100644 --- a/Documentation/PCI/msi-howto.rst +++ b/Documentation/PCI/msi-howto.rst @@ -285,3 +285,13 @@ to bridges between the PCI root and the device, MSIs are disabled. It is also worth checking the device driver to see whether it supports MSIs. For example, it may contain calls to pci_alloc_irq_vectors() with the PCI_IRQ_MSI or PCI_IRQ_MSIX flags. + + +List of device drivers MSI(-X) APIs +=================================== + +The PCI/MSI subystem has a dedicated C file for its exported device driver +APIs — `drivers/pci/msi/api.c`. The following functions are exported: + +.. kernel-doc:: drivers/pci/msi/api.c + :export: