From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id B328BE81E06 for ; Fri, 6 Oct 2023 15:06:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230158AbjJFPGp (ORCPT ); Fri, 6 Oct 2023 11:06:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33450 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232611AbjJFPGo (ORCPT ); Fri, 6 Oct 2023 11:06:44 -0400 Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 03868A6; Fri, 6 Oct 2023 08:06:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1696604803; x=1728140803; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=gNgwqDPrxhz8wCl3Okr47BvVxVZ4M+5ATpm+bjH86Rc=; b=WN7pWWPJDQpmmFMV+n52UU1g/oIKyq3EXbggq7Srn0vRvXezisd7Wlzr bEyLSDM9K8wFCyVhQrE6uwf+oaJvUJ/DSWvRxponIRE1eUeMBBmjHwAfc N/SWknu52lpS5BklsavYmPvcQy2mpIlOpGcrWloJPAeQx+rywkgLF1Ftd mVRilQKqnzqlRj/QgQYRIMWdiXK83dPQmFE0diLZNKiBKAKsfJNUFW2Go nKS35pV674RP/vvsRAUTFFNdZ6qNTR/IeM8Z9XvTK6NcmJHM8FSt9iUeH aZYC52r35bD0+5dCIH/sZ/XYSUL3rTo0XhsICjzkFN/BVNibpWU12wS6G Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10855"; a="470034212" X-IronPort-AV: E=Sophos;i="6.03,204,1694761200"; d="scan'208";a="470034212" Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 06 Oct 2023 08:06:43 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10855"; a="702079788" X-IronPort-AV: E=Sophos;i="6.03,204,1694761200"; d="scan'208";a="702079788" Received: from black.fi.intel.com ([10.237.72.28]) by orsmga003.jf.intel.com with ESMTP; 06 Oct 2023 08:06:41 -0700 Received: by black.fi.intel.com (Postfix, from userid 1003) id B2831430; Fri, 6 Oct 2023 18:06:39 +0300 (EEST) From: Andy Shevchenko To: Yang Yingliang , Andy Shevchenko , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Jonathan Corbet , Bjorn Helgaas Subject: [resend, PATCH v1 1/1] PCI: Update the devres documentation regarding to pcim_*() Date: Fri, 6 Oct 2023 18:06:34 +0300 Message-Id: <20231006150634.3444251-1-andriy.shevchenko@linux.intel.com> X-Mailer: git-send-email 2.40.0.1.gaa8946217a0b MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org There were many changes to PCI core in scope of managed resources APIs. Update documentation to list the current state of affairs. Signed-off-by: Andy Shevchenko --- Documentation/driver-api/driver-model/devres.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/Documentation/driver-api/driver-model/devres.rst b/Documentation/driver-api/driver-model/devres.rst index 8be086b3f829..c5f99d834ec5 100644 --- a/Documentation/driver-api/driver-model/devres.rst +++ b/Documentation/driver-api/driver-model/devres.rst @@ -322,10 +322,8 @@ IOMAP devm_platform_ioremap_resource_byname() devm_platform_get_and_ioremap_resource() devm_iounmap() - pcim_iomap() - pcim_iomap_regions() : do request_region() and iomap() on multiple BARs - pcim_iomap_table() : array of mapped addresses indexed by BAR - pcim_iounmap() + + Note: For the PCI devices the specific pcim_*() functions may be used, see below. IRQ devm_free_irq() @@ -392,8 +390,16 @@ PCI devm_pci_alloc_host_bridge() : managed PCI host bridge allocation devm_pci_remap_cfgspace() : ioremap PCI configuration space devm_pci_remap_cfg_resource() : ioremap PCI configuration space resource + pcim_enable_device() : after success, all PCI ops become managed + pcim_iomap() : do iomap() on a single BAR + pcim_iomap_regions() : do request_region() and iomap() on multiple BARs + pcim_iomap_regions_request_all() : do request_region() on all and iomap() on multiple BARs + pcim_iomap_table() : array of mapped addresses indexed by BAR + pcim_iounmap() : do iounmap() on a single BAR + pcim_iounmap_regions() : do iounmap() and release_region() on multiple BARs pcim_pin_device() : keep PCI device enabled after release + pcim_set_mwi() : enable Memory-Write-Invalidate PCI transaction PHY devm_usb_get_phy() -- 2.40.0.1.gaa8946217a0b