Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp1317229pxb; Fri, 26 Feb 2021 07:53:37 -0800 (PST) X-Google-Smtp-Source: ABdhPJyNjJFig963X0aLc/64VA5gY58Kxs7m8N9xJ5TdQKdiFOgdhOnLpWHNgPydZENnxDQ+/lFq X-Received: by 2002:a17:906:70d4:: with SMTP id g20mr4170677ejk.361.1614354817185; Fri, 26 Feb 2021 07:53:37 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1614354817; cv=none; d=google.com; s=arc-20160816; b=UvHKZavQGlscSaRiq3+HEH4RBBIP4GpLo+gXD5fhaEuEuD9h1Ova0FEAM+a5sEDGWJ 1n2RQ4NV/ALOmkLCpD0PRYiOzR64jM1+3keCDIyTp/9bqg2mrTutAaHVTdRrl1/aIBRp jfs78uBtTsZGQ0bbgeIWNXeyi3CX5ev5RubjHfIDQzW74aGzwxxYBrXwJnJBxSCYjyHD 3NKlM+MX2nvySAXh5FRLPnsk4k4c8vpMLDdKR+WTnUFI5f1fctYMBLH7Zxg/OlCVcN4x FS4Hb0KtMw6iStLsYdGCQP7da0TMb0BljgopGT7wGUohbRWTXNzAEHUwX9y71w7Pd+Gq 65kw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=EYv/mJxKPjVOLew2rn62IgtnY4RP7SORjigSii1Fy/A=; b=uxPTJSPiBMqZxxPnvsE6K91Gtiu8MAWRlHA5awoRxNgRnzkpBVUBMEutYVgIc9purP msBj/tlrO0vLDzwf1kC71K8cKro8boM2oeWmbahGPQ7akKKt8wUaTzUgavJ0spkNV5cB JxAvF2G8/S+7LvMEKzsdZyYP1nspTMio1eBX+7GAWOFiBfGFgS8Yb8uKUKNFWdwVgOaD i8hYqmZCKIeLOyKBHYkH6xMHZT9N4q7i0VuCytWKHAwj7St1lPpHTPWJ40xaIBBsRyYD Cq42SrE1FPwd7pJLBhlsh+0mWJCZgIWvIbKb2Y1N5DJ2hik1PleMSdh6XMep5O3oxvi5 FWHA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=NxFxvhxK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id a3si6279024ejd.122.2021.02.26.07.53.13; Fri, 26 Feb 2021 07:53:37 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=NxFxvhxK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230053AbhBZPv6 (ORCPT + 99 others); Fri, 26 Feb 2021 10:51:58 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40928 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229990AbhBZPvu (ORCPT ); Fri, 26 Feb 2021 10:51:50 -0500 Received: from mail-pg1-x52b.google.com (mail-pg1-x52b.google.com [IPv6:2607:f8b0:4864:20::52b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 99693C061786; Fri, 26 Feb 2021 07:51:08 -0800 (PST) Received: by mail-pg1-x52b.google.com with SMTP id n10so6429575pgl.10; Fri, 26 Feb 2021 07:51:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=EYv/mJxKPjVOLew2rn62IgtnY4RP7SORjigSii1Fy/A=; b=NxFxvhxK5304614G2GOSt84YpgjPPRtwbTMh4OsIpkOHSYT6unL5QE4aEbMeR0uHVS r0iflqX7w1AM2r3GjoVhQSKJYWzEVcGAuPUJbbfe03qRgXb6fnl03ZbiV2jnK6kQhfNX bW1B6yfYhAgyfdRirwgAgnWJ8A043YuIR6jkpdT1J7nCJJ5aWzG7OE3OKg8cbaxCnzfe vHoGaC4s+QJolWbY3EHZ6YASEnD4D4McaHlYjdYVqKl84/+xwek0a1gnvGtymSsVle59 RWOe9KvgLCi8lYYbS1zT2PzUUE7m9Sj8j55os30LY2rlyPHNRTeI/Nvkm1oEAYSkbzPl 4Jbw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=EYv/mJxKPjVOLew2rn62IgtnY4RP7SORjigSii1Fy/A=; b=fa9Y6sPPLC4G3+1fcifbS9+EJLyUb6rqebogXPFFQsXxKHjM+TLkyMEUjVKFjQlChx s1LAHCqy/ZiWAdgHGXDFecXv2sKp0FHZAYN1v5p2DNB220vmpBvj9BoIto9yZpMJoRBv c4G61ISaE0AZTNkBGAVU+DTrEhxTEhxn/JZl+eOIBLkVVETEMJ5wU8KY3u8fDBRBSlUW v4tbls7k1ZzAoMN7pI6cVvCAdZUAWKT5lv+QwUOpFqIUKjv6UbD1QW/KsPASCUmihDUp 17csC05p9L69Bmb+RbE0NMxlCDJU/SNoZWoHmWCwOxCv4uvFE6hqsa1IiSABCwegPLxu aupA== X-Gm-Message-State: AOAM530ReWQ/FKob6GPXDqVWAmQ2fIvXBDw/Kh48s94/Jp1R2iFUicgR z9iQ7E85y3j1qI+h7x6LPyQ= X-Received: by 2002:a63:4761:: with SMTP id w33mr3484306pgk.118.1614354668272; Fri, 26 Feb 2021 07:51:08 -0800 (PST) Received: from localhost (89.208.244.53.16clouds.com. [89.208.244.53]) by smtp.gmail.com with ESMTPSA id v7sm10397503pfv.93.2021.02.26.07.51.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Feb 2021 07:51:08 -0800 (PST) From: Dejin Zheng To: corbet@lwn.net, jarkko.nikula@linux.intel.com, andriy.shevchenko@linux.intel.com, mika.westerberg@linux.intel.com, rric@kernel.org, bhelgaas@google.com, wsa@kernel.org, linux-doc@vger.kernel.org, linux-i2c@vger.kernel.org, linux-pci@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Dejin Zheng Subject: [PATCH v5 2/4] Documentation: devres: Add pcim_alloc_irq_vectors() Date: Fri, 26 Feb 2021 23:50:54 +0800 Message-Id: <20210226155056.1068534-3-zhengdejin5@gmail.com> X-Mailer: git-send-email 2.25.0 In-Reply-To: <20210226155056.1068534-1-zhengdejin5@gmail.com> References: <20210226155056.1068534-1-zhengdejin5@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add pcim_alloc_irq_vectors(), a device-managed version of pci_alloc_irq_vectors(). introducing this function can simplify the error handling path in many drivers. Signed-off-by: Dejin Zheng --- v4 -> v5: - No change v3 -> v4: - No change v2 -> v3: - No change v1 -> v2: - Modify some commit messages. Documentation/driver-api/driver-model/devres.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/driver-api/driver-model/devres.rst b/Documentation/driver-api/driver-model/devres.rst index cd8b6e657b94..a52f65b6352f 100644 --- a/Documentation/driver-api/driver-model/devres.rst +++ b/Documentation/driver-api/driver-model/devres.rst @@ -380,6 +380,7 @@ 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_alloc_irq_vectors() : managed IRQ vectors allocation pcim_enable_device() : after success, all PCI ops become managed pcim_pin_device() : keep PCI device enabled after release -- 2.25.0