From patchwork Thu Mar 18 10:40:30 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403966 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp356777jai; Thu, 18 Mar 2021 03:41:38 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwLuC73lPrCS1qdQQ9DRYKSsoaODIQrhtvUGd0A1OPklao2uGOJ/L/cdndfEgWEye4OvZvn X-Received: by 2002:a17:906:fcd2:: with SMTP id qx18mr19131040ejb.327.1616064098471; Thu, 18 Mar 2021 03:41:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616064098; cv=none; d=google.com; s=arc-20160816; b=BlzKxJpPiArbhpsLTpsqvexgPwJY3+ZmphuCeKCerp6QDzsMJzSjq312E8f5Y4Kxx/ PmwLeqx1mrbyvnTL48HjB1zCBiq9G4atstPFbbM6+tXThYKGyuoSsiSWqYpaxpX5ukI9 /Yrgoc4yeqfMSfHA39DeaIKelAu1YbJJo6o+EfIl0mgvLcb4qK229IUbET7vkvVGDO7Y c/XHntySWHaqFbBwVhOD5H7/2wGRSw2wzOAC+a8xgMM89iEQ5mYhtTR8QYQDqQD6NeSQ PelcH0u2UHBfTW59s917ob9qvqcVCj0mA9yOXlm5jmKmegmRMchkvdF9tEDYszbisSN5 XXlA== 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=E4h/C6T84HxYsM0qAYAlk6c6TY3ISMeByeH+9EbuzfU=; b=yu7gJWZj3UUtfzuWXnPQ614NHILYvQ7jGJkGICFkIjYipvDk9D8LghXVSlvpmRAVPN iQXsmMJ1MfspjZKFWUR1FaTOHxtcbEoIl3Zq1beNeL7nF5P+nrrreP21GlQOTO5tPIPD kDncsAzxLAfYhe9tixLgDhcp+z8hGWr7aCQNUaGPhqzqWfs991BinRtqUIUm91fBQgLS S/LGFLNRcec3ot4jiJwA0B1VdzIU4VbllUMdnCnhD8o4Ql97SoyIopaVTcB+ttxSp2jG VMyGuvsGrux92D30MzGkYIPVLykUuLJoQMivKwzkWvL1Splwx23Qv3OaVXUA9PniP4fl le9A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=KRRNlLMv; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id z22si1279805edx.180.2021.03.18.03.41.38; Thu, 18 Mar 2021 03:41:38 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-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=@linaro.org header.s=google header.b=KRRNlLMv; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230203AbhCRKlE (ORCPT + 6 others); Thu, 18 Mar 2021 06:41:04 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33358 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230232AbhCRKkt (ORCPT ); Thu, 18 Mar 2021 06:40:49 -0400 Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1046EC061763 for ; Thu, 18 Mar 2021 03:40:49 -0700 (PDT) Received: by mail-wr1-x434.google.com with SMTP id 61so4940763wrm.12 for ; Thu, 18 Mar 2021 03:40:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=E4h/C6T84HxYsM0qAYAlk6c6TY3ISMeByeH+9EbuzfU=; b=KRRNlLMvzBiVLMTp4uW28iRLrI+eTs1hQfXzmzC2/MtESViCMqhjBq0SsrvYsW5I4O eJB+PRtNxU8nWaByICbJeuEzTmZBsoMRpgyZ5L8Q8GbRk+QlVXInAPDIImQ/qacJGwbq HKE4iXo6wFAav6YXwFyW1UmHhZNIrYpreymbLoxTE0pZgPyTiZqWvqB5VugcD7Cy8MBu iPFRfqzXkDsYbSsL6GKFiXINf2umU1CY0dMd4QrSazFCsnZ1p0LNRnsRPRL+dJcwYzSa jreeMZYqEOnFjB5yATGGgLCIx+SEhmS1w0XprLmL++OpkJFv8Vl1CHra0MdezCw5Q4H3 AlOQ== 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=E4h/C6T84HxYsM0qAYAlk6c6TY3ISMeByeH+9EbuzfU=; b=J6IJhr4nis2/cGFaOG9BkOWyRW83BX6t56Gd70LAqEnTzwOao2VNIigwOASw+sVy71 5DeoHLEx58+ok84h/ASH/o7GaizmYD3C/ictliOkYaDEf1rmDy7/kfPJhSPyZx4ZeuVS QPEkA9RNiP+Ffpm3+PNS4HW7D3UMtWzfHec2NxBjN3fmHPIL0hwEJ52oqTsJDTmbxkVx T8eECOwfeGp6XTL3LHue3tuyeLFp12WOT0wfDrIToZ3R9YbuCQIiexa9LexxTZFXI+VA 7+6M/AlOdQLcNi3kK86Abf4TNz03b5glSQjPcka53smWjelZMZ5KEAHIXP5QhJTiku6Z gqqg== X-Gm-Message-State: AOAM533tsVnIGimUdmIUmcSxtlJwDX2CAaRuS7xmgJ9mtscxZPtZBtz9 8PK2swUBwvPohq751Btb+y8Mkg== X-Received: by 2002:a5d:42d2:: with SMTP id t18mr8945779wrr.258.1616064047835; Thu, 18 Mar 2021 03:40:47 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id z1sm2426033wru.95.2021.03.18.03.40.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 18 Mar 2021 03:40:47 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , "David S. Miller" , devicetree@vger.kernel.org Subject: [PATCH 04/10] of: base: Fix some formatting issues and provide missing descriptions Date: Thu, 18 Mar 2021 10:40:30 +0000 Message-Id: <20210318104036.3175910-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210318104036.3175910-1-lee.jones@linaro.org> References: <20210318104036.3175910-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/of/base.c:315: warning: Function parameter or member 'cpun' not described in '__of_find_n_match_cpu_property' drivers/of/base.c:315: warning: Function parameter or member 'prop_name' not described in '__of_find_n_match_cpu_property' drivers/of/base.c:315: warning: Function parameter or member 'cpu' not described in '__of_find_n_match_cpu_property' drivers/of/base.c:315: warning: Function parameter or member 'thread' not described in '__of_find_n_match_cpu_property' drivers/of/base.c:315: warning: expecting prototype for property holds the physical id of the(). Prototype was for __of_find_n_match_cpu_property() instead drivers/of/base.c:1139: warning: Function parameter or member 'match' not described in 'of_find_matching_node_and_match' drivers/of/base.c:1779: warning: Function parameter or member 'np' not described in '__of_add_property' drivers/of/base.c:1779: warning: Function parameter or member 'prop' not described in '__of_add_property' drivers/of/base.c:1800: warning: Function parameter or member 'np' not described in 'of_add_property' drivers/of/base.c:1800: warning: Function parameter or member 'prop' not described in 'of_add_property' drivers/of/base.c:1849: warning: Function parameter or member 'np' not described in 'of_remove_property' drivers/of/base.c:1849: warning: Function parameter or member 'prop' not described in 'of_remove_property' drivers/of/base.c:2137: warning: Function parameter or member 'dn' not described in 'of_console_check' drivers/of/base.c:2137: warning: Function parameter or member 'name' not described in 'of_console_check' drivers/of/base.c:2137: warning: Function parameter or member 'index' not described in 'of_console_check' Cc: Rob Herring Cc: Frank Rowand Cc: "David S. Miller" Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/base.c | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) -- 2.27.0 diff --git a/drivers/of/base.c b/drivers/of/base.c index 8a348f0d3c5e7..457d1ec27300b 100644 --- a/drivers/of/base.c +++ b/drivers/of/base.c @@ -305,7 +305,7 @@ bool __weak arch_match_cpu_phys_id(int cpu, u64 phys_id) return (u32)phys_id == cpu; } -/** +/* * Checks if the given "prop_name" property holds the physical id of the * core/thread corresponding to the logical cpu 'cpu'. If 'thread' is not * NULL, local thread number within the core is returned in it. @@ -1128,7 +1128,7 @@ EXPORT_SYMBOL(of_match_node); * will; typically, you pass what the previous call * returned. of_node_put() will be called on it * @matches: array of of device match structures to search in - * @match Updated to point at the matches entry which matched + * @match: Updated to point at the matches entry which matched * * Returns a node pointer with refcount incremented, use * of_node_put() on it when done. @@ -1774,6 +1774,8 @@ EXPORT_SYMBOL(of_count_phandle_with_args); /** * __of_add_property - Add a property to a node without lock operations + * @np: Caller's Device Node + * @prob: Property to add */ int __of_add_property(struct device_node *np, struct property *prop) { @@ -1795,6 +1797,8 @@ int __of_add_property(struct device_node *np, struct property *prop) /** * of_add_property - Add a property to a node + * @np: Caller's Device Node + * @prob: Property to add */ int of_add_property(struct device_node *np, struct property *prop) { @@ -1839,6 +1843,8 @@ int __of_remove_property(struct device_node *np, struct property *prop) /** * of_remove_property - Remove a property from a node. + * @np: Caller's Device Node + * @prob: Property to remove * * Note that we don't actually remove it, since we have given out * who-knows-how-many pointers to the data using get-property. @@ -2125,9 +2131,9 @@ EXPORT_SYMBOL_GPL(of_alias_get_highest_id); /** * of_console_check() - Test and setup console for DT setup - * @dn - Pointer to device node - * @name - Name to use for preferred console without index. ex. "ttyS" - * @index - Index to use for preferred console. + * @dn: Pointer to device node + * @name: Name to use for preferred console without index. ex. "ttyS" + * @index: Index to use for preferred console. * * Check if the given device node matches the stdout-path property in the * /chosen node. If it does then register it as the preferred console and return