From patchwork Fri Mar 31 07:52:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Geert Uytterhoeven X-Patchwork-Id: 77607 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp395770vqo; Fri, 31 Mar 2023 01:06:16 -0700 (PDT) X-Google-Smtp-Source: AKy350Z/Nurd6nf0916pls3I5yBFmEFnFpPC5715IPtjNl9NSTwVPsH1AK5wldxMtbBczZyAGHCq X-Received: by 2002:a62:1948:0:b0:627:f740:51f9 with SMTP id 69-20020a621948000000b00627f74051f9mr9259809pfz.3.1680249975987; Fri, 31 Mar 2023 01:06:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1680249975; cv=none; d=google.com; s=arc-20160816; b=MT3xVBbn/HIElHNhfa0Q+bWzC8kkHVqqIxGeOo3cmrHsylyIeIZvJpgBqAJBBpLRaQ KjdTLNKj9H4tVRjTov9LN/u+I1EltXqZ39RIx/BQ9hyS27PTARqvRudyTMU7HhI1f3Ob CRIA/EMvNlg1ItlYonDANLK8Z75Id7q0pGB207AwmSaH7IbP3guZSzDwx97N1/BmlYHl VYo4ATM9+iVIg0XAtOd3vhP8eHmiXXJ4jAfVtlaFBnzvAc31t8nskYD4hBeol7W4VnCt 0RVblZhIfDc5PgzEVs54Ph4J8Qp5bewUWVFkhHL4yAdUweYmKY20kItJwXdVCr/TQUrn uD5A== 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; bh=yMdH41meGqShd3bY+plNTdYl8PLyrMSSJDM+RDgcY5Q=; b=ijXakk0KB3m+aU8yRdwrrUS8nQbOGFjzDpx18EF6WBifYWsHbMbg4nKNjoX4B4ETxS B2r+mZ7hJxIuG1dl6erB6BwhtpqODFgwwkgsa8FthT4Pk+L1Meq1YiVNCTVWfc9046b/ s1vgUJvOhmONQ8sV3+Sm940gA7VLbhxNCQkmggjqAsyNetr9kYjRCfwIHFAQMrgGEmrd EOY5GhW71IUiot24MiDG6Sszs7AJAwwHwxQ/OP5zStzJDrKsYuNvrkx8UFRDG34jZaR1 ddwNYytc3JxsmGzN6WV9A6JuvvM+KMTBrXleltU2eFeZwJX8BBxpRBWWPcEA/yfBS4G+ 8vaQ== ARC-Authentication-Results: i=1; mx.google.com; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id a63-20020a639042000000b0050f8d6d85fcsi1856912pge.303.2023.03.31.01.06.03; Fri, 31 Mar 2023 01:06:15 -0700 (PDT) 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; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231189AbjCaHxl (ORCPT + 99 others); Fri, 31 Mar 2023 03:53:41 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57882 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231366AbjCaHxM (ORCPT ); Fri, 31 Mar 2023 03:53:12 -0400 Received: from albert.telenet-ops.be (albert.telenet-ops.be [IPv6:2a02:1800:110:4::f00:1a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 425A911176 for ; Fri, 31 Mar 2023 00:52:38 -0700 (PDT) Received: from ramsan.of.borg ([84.195.187.55]) by albert.telenet-ops.be with bizsmtp id evsc290071C8whw06vsc8b; Fri, 31 Mar 2023 09:52:36 +0200 Received: from rox.of.borg ([192.168.97.57]) by ramsan.of.borg with esmtp (Exim 4.95) (envelope-from ) id 1pi9Y6-00FTC0-I1; Fri, 31 Mar 2023 09:52:36 +0200 Received: from geert by rox.of.borg with local (Exim 4.95) (envelope-from ) id 1pi9Yp-008Ra0-Qw; Fri, 31 Mar 2023 09:52:35 +0200 From: Geert Uytterhoeven To: Rob Herring , Frank Rowand Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Geert Uytterhoeven Subject: [PATCH 1/3] of: address: Document return value of of_address_to_resource() Date: Fri, 31 Mar 2023 09:52:28 +0200 Message-Id: <61ffcb5e87511dfa21af169efd04806101c48b8a.1680248888.git.geert+renesas@glider.be> X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 X-Spam-Status: No, score=-0.4 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_NONE autolearn=unavailable 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?1761869799164290605?= X-GMAIL-MSGID: =?utf-8?q?1761869799164290605?= Add the missing return value documentation to the linuxdoc comment block for the of_address_to_resource() function. Signed-off-by: Geert Uytterhoeven --- drivers/of/address.c | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/of/address.c b/drivers/of/address.c index 4c5c3b7ab99449f2..6312b10885e85864 100644 --- a/drivers/of/address.c +++ b/drivers/of/address.c @@ -882,6 +882,8 @@ static int __of_address_to_resource(struct device_node *dev, int index, int bar_ * @index: Index into the array * @r: Pointer to resource array * + * Returns -EINVAL if the range cannot be converted to resource. + * * Note that if your address is a PIO address, the conversion will fail if * the physical address can't be internally converted to an IO token with * pci_address_to_pio(), that is because it's either called too early or it