From patchwork Fri Mar 12 11:07:49 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398561 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098952jai; Fri, 12 Mar 2021 03:08:57 -0800 (PST) X-Google-Smtp-Source: ABdhPJzCKZB0dOwPKCT9w3Ub92j8/MWEe0Dtk369oD4TDZkf1gAphqVDfQQ9qHmuUqBklTuW6xjn X-Received: by 2002:a17:906:3409:: with SMTP id c9mr7796382ejb.314.1615547336981; Fri, 12 Mar 2021 03:08:56 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547336; cv=none; d=google.com; s=arc-20160816; b=cm7vTmgLpsDP74BX9OG7zDeo1ybrze7vWqLHBVGn3Lxfgdc47IdA1o3eSfKdElYm2b w5TGZqbq+5NbTyFi6qOb+ucefSnCbpIZd3GzIfZgaQk0ZtYcgwEEiA/G5HWt5OBCmRrg uRdwzWujQaGzxYuqH59xjEhAlAJyNqAj1vrn8Jmh5+zuA9T2nLtZAPvh+KFUB8QpXl7o EkL8cQLgcHKtv5BtvJ055b2+aEZjPj1/GTMOQR3wyT1yBgjQZA67yDb5G/R8lM4E2kE0 RF50oKKGS9ZKF2fe6lKynD4flBUiR+49Haq1TgL/jt57AD7DjT8RC+z7r2eBdQI0V0UW DxXQ== 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=h5iCVi3kGcdP7GfFug+7AAOmAXys2cxySqnBTCX8/Wo=; b=Bd3dXwDMcrvAcVl52PtOrpTLXcxAEhjrh0jsKSuktaFvrfKS0Ncsu8RCyEzKVX8Obq KkG/QE9nRWkBV3ax0hb4kGWWfXTpRwmQwhWUW/UU97zP3Lp3KkZkRW4mN2aend1ypins +jYJHq6Pc4ShxIeAdS6KA31hS0iUYNGxkk9vRDPUQR/gkvckzHGx3MH8evB5LjnLr65F 2xU2HeGyzqO7zibN0DqbfGsAI+XnkQtT+HP57mh04ifDMPEWTU3gK4VEA496Q0dlw3EI XC6C25d6uPPUzq7hVfc58o64cyLjBFnUPq2E4PdmleKPptefxOz2k2or89MYeie8hzMb CWkQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="MiZ/wksg"; 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 b26si2139744eds.574.2021.03.12.03.08.56; Fri, 12 Mar 2021 03:08:56 -0800 (PST) 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="MiZ/wksg"; 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 S233897AbhCLLIP (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:15 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43694 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233761AbhCLLIE (ORCPT ); Fri, 12 Mar 2021 06:08:04 -0500 Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 051CFC061761 for ; Fri, 12 Mar 2021 03:08:04 -0800 (PST) Received: by mail-wr1-x42c.google.com with SMTP id k8so1538598wrc.3 for ; Fri, 12 Mar 2021 03:08:03 -0800 (PST) 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=h5iCVi3kGcdP7GfFug+7AAOmAXys2cxySqnBTCX8/Wo=; b=MiZ/wksgjgzrYq05xxSVqsr6IYVhuJu6Ohdsuz+m4EwHwmcD8iTbvBFUhbGR1MJDpd rCOvFEoVBZNa8258gbc16/z8Ol1lcno9gqt6HkgXSE9wVlZbwWJgV17ZGIaJD5RLLoxP 8O4QdSH8bMzq6LyiF9Fu2q9zFeZt45BWnu1kzkq6U2luPrTVN3s0U228i+uxOjkUEMqf M1PQ7YcNY93XjjJM7a+FLbZshl2JBoZcKp9QwfaU/4zlHyIj/fZNsway0u43AoncVEKW N2DGEiJh1hBznIIbsbtWUz234sT6sHlWsCAzAZilKG6hBkRt/HESoBkDMlwURgst+dF0 RqOg== 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=h5iCVi3kGcdP7GfFug+7AAOmAXys2cxySqnBTCX8/Wo=; b=kY/fqH8FjgRjQwT1guAIP/t8loLx84jeJ0Q5AnR/13T4w4IFB4nL5vt5xgZrPKLtRH NUSkut5zB24h+QNTmjBH+MV+OlnM7HpKMVAN/uDEuoL8IOQH9auE8Z71djTSvHL+1wRA MqcH6S4Y21eWGrZcOsqx/4pTa7gwQK74mHUnrWMcavi+ygv0Z0iJb1+mWGUBp9+aZxLo sLNcckUTZyg1B1eGrp0V7sj5WnocgwYh/emHlsy1441aMm7AsmoS/0BvOW9Qb+HIFKbv OAXpcpbgwq/TYmPyCRRY9OmCd1Heevz3bpzaEoeDCVKdzO+CmDxCNpR5lABJyOU1aYT9 xqCQ== X-Gm-Message-State: AOAM5311Lpidd9FdFt1C2owtGpE7V5fnXDRuq7SwQIZSricrZlJLOALr 3NJan1ZYoCCZPw68sDLB++uTWg== X-Received: by 2002:adf:ef4a:: with SMTP id c10mr13109500wrp.427.1615547282654; Fri, 12 Mar 2021 03:08:02 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:02 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , devicetree@vger.kernel.org Subject: [PATCH 01/10] of: device: Fix function name in header and demote kernel-doc abuse Date: Fri, 12 Mar 2021 11:07:49 +0000 Message-Id: <20210312110758.2220959-2-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/device.c:72: warning: expecting prototype for of_dma_configure(). Prototype was for of_dma_configure_id() instead drivers/of/device.c:263: warning: Function parameter or member 'dev' not described in 'of_device_modalias' drivers/of/device.c:263: warning: Function parameter or member 'str' not described in 'of_device_modalias' drivers/of/device.c:263: warning: Function parameter or member 'len' not described in 'of_device_modalias' drivers/of/device.c:280: warning: Function parameter or member 'dev' not described in 'of_device_uevent' drivers/of/device.c:280: warning: Function parameter or member 'env' not described in 'of_device_uevent' Cc: Rob Herring Cc: Frank Rowand Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/device.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/of/device.c b/drivers/of/device.c index 6cb86de404f1c..64ee363abde24 100644 --- a/drivers/of/device.c +++ b/drivers/of/device.c @@ -53,7 +53,7 @@ int of_device_add(struct platform_device *ofdev) } /** - * of_dma_configure - Setup DMA configuration + * of_dma_configure_id - Setup DMA configuration * @dev: Device to apply DMA configuration * @np: Pointer to OF node having DMA configuration * @force_dma: Whether device is to be set up by of_dma_configure() even if @@ -256,7 +256,7 @@ int of_device_request_module(struct device *dev) } EXPORT_SYMBOL_GPL(of_device_request_module); -/** +/* * of_device_modalias - Fill buffer with newline terminated modalias string */ ssize_t of_device_modalias(struct device *dev, char *str, ssize_t len) @@ -273,7 +273,7 @@ ssize_t of_device_modalias(struct device *dev, char *str, ssize_t len) } EXPORT_SYMBOL_GPL(of_device_modalias); -/** +/* * of_device_uevent - Display OF related uevent information */ void of_device_uevent(struct device *dev, struct kobj_uevent_env *env) From patchwork Fri Mar 12 11:07:50 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398552 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098842jai; Fri, 12 Mar 2021 03:08:48 -0800 (PST) X-Google-Smtp-Source: ABdhPJwRfjHsE60VL2pLvdkz2vDuquQH3n3J9JVrk8/VGgQF3ecSUuowqSXlDP8dy7JJ1/wyH/ns X-Received: by 2002:a17:906:4f8a:: with SMTP id o10mr8035671eju.484.1615547328848; Fri, 12 Mar 2021 03:08:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547328; cv=none; d=google.com; s=arc-20160816; b=z7/VOJKv8SV+KuxZjEuUCt8FKub+lT23zwt2oZxw4bALIX/48HdzzrhnSYVdtvqHBW h7wY2u6dkzzX6HARImUBkAS7ZQrd9oQ6g3pPvbgv/eLGtKdG3ZWuY1x88l6EgU2PrzvE nVMc6z4/KATuygU2qM2YMzisSxmCJ1jJNf3qNlHwdJVOReSdJbGgzC/+IJZ/ckvTVc+C f7++/OcCwLthXam6+3gmjQzMI9mnI5myNzLLvHO0mv7xW3vAJeAb35plJpyEEvXdWGwx zAfDfU4XIQZo6qXRbUnJLbdkV+1UOIHwH0LJ98DsjI8rX5Bv9qEetzk+mvSSvqFCJN69 7v/Q== 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=bB37NURGh8EFIJQIa++3BQSCU0th5hoxHg0xcGpcKp8=; b=Ys6a4B0BygMRftl2NDlo7MKlxKPp+Mjop2RzDQWrlONu/TAmPTrIweQKFZiHnEY4gm njvTSXyhI0JfdFM8MGZ5Gm7gJQYb1K1pSNwoBVeMZ7hnxOB2+O/teWI4V9tbhvxd/NLz ls7/fTockuIgB5xlq5NtjW+IosdW7oV1pbY8XiA98O9Wp5csK4zHVhsSb1sAuYlKFQsT 7u/mzj9O+MPqX07S3ud+Bi2yKzphE4aHeakDwDJI5Al9u1bOkehOoGRQyyw3VFmOFUrs 4ZE6ZmdSiB328y1INIp/ake+b4gwL/mU5SoUdWsyWdIoNk2Y12VEralKkvHLqt12gcBP NQpQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=tmsGKcKg; 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 b26si2139744eds.574.2021.03.12.03.08.48; Fri, 12 Mar 2021 03:08:48 -0800 (PST) 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=tmsGKcKg; 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 S233745AbhCLLIQ (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:16 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43702 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233770AbhCLLIF (ORCPT ); Fri, 12 Mar 2021 06:08:05 -0500 Received: from mail-wr1-x435.google.com (mail-wr1-x435.google.com [IPv6:2a00:1450:4864:20::435]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CC54BC061574 for ; Fri, 12 Mar 2021 03:08:04 -0800 (PST) Received: by mail-wr1-x435.google.com with SMTP id y16so4583909wrw.3 for ; Fri, 12 Mar 2021 03:08:04 -0800 (PST) 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=bB37NURGh8EFIJQIa++3BQSCU0th5hoxHg0xcGpcKp8=; b=tmsGKcKgEnsj0KhVWe2+k8A1ABsaHdyGtihJMLmEKBibW/MwchKqZMucJ2Bf+JeJ3H emjiTOGPn2KKQHgYfwXPrPP0h4r5bpWUTcm/MqMz4umjl7cmtNMU6tLxJZMB1CfwtwoY RzOMlRnrDNriNMrFjVPrsEFYifdnuqjZ1LW0RJ+P+DSIZiMBtarte05Al7uuVAYGJdgo wah2axV51h3tdIaVigzP4kWCabECr2Ev2XhZtcdQ0cUo1UTJxkj1tXXeKzohVxF3Pio6 5XXUaA2g5cFG7/OXLNewYIBG9BAb7ce+/laDOYDRarSDwxv+UpsTlj5RXLqk5LaC/+YN vegA== 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=bB37NURGh8EFIJQIa++3BQSCU0th5hoxHg0xcGpcKp8=; b=CsYnHgMwp99Hw1AGlA8vms7OkIJ3vxjtcQH6xkHAwunRMwUNnB+8G4NeDpEAnYckhV J6hct6PVZ50o3hxjlFAXPfvZASUeugQIzTTusfakFCcVIt8ZSwUF9Kq6d0cqpc5hhQEq HqSox3gNw4q+0Qz8Wk6g/8lMNFMpH4tT7hUw5vEGNQ6FC7i1cxjHBraAww7Gts4Yqmt9 3Ubxj+Bd+01OSdE2iQk78ZGO32m/z/ZWThjipYkvYan62MSzErb/wXny6xxExIeyOWd6 ZbbSdqgkqal23Xgsv+DdaYeoBBEkxaYrxBnuQ55e5gMCk9pRr3JYrBmYASgkrYspYYuH WBIA== X-Gm-Message-State: AOAM530mfxYcUqWSeNdkc+i1kU8ZILo4VK+TnRLwdYR9uanUpMTYnZrG kXtyWqXwV9SH9t03vkLj/lqtuQ== X-Received: by 2002:adf:e68e:: with SMTP id r14mr13195066wrm.273.1615547283597; Fri, 12 Mar 2021 03:08:03 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:03 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , devicetree@vger.kernel.org Subject: [PATCH 02/10] of: dynamic: Fix incorrect parameter name and demote kernel-doc abuse Date: Fri, 12 Mar 2021 11:07:50 +0000 Message-Id: <20210312110758.2220959-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/dynamic.c:234: warning: Function parameter or member 'np' not described in 'of_attach_node' drivers/of/dynamic.c:286: warning: Function parameter or member 'np' not described in 'of_detach_node' drivers/of/dynamic.c:326: warning: Function parameter or member 'kobj' not described in 'of_node_release' drivers/of/dynamic.c:326: warning: Excess function parameter 'kref' description in 'of_node_release' Cc: Rob Herring Cc: Frank Rowand Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/dynamic.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/of/dynamic.c b/drivers/of/dynamic.c index 9a824decf61f1..93b35f3c92c18 100644 --- a/drivers/of/dynamic.c +++ b/drivers/of/dynamic.c @@ -227,7 +227,7 @@ static void __of_attach_node(struct device_node *np) of_node_clear_flag(np, OF_DETACHED); } -/** +/* * of_attach_node() - Plug a device node into the tree and global list. */ int of_attach_node(struct device_node *np) @@ -279,7 +279,7 @@ void __of_detach_node(struct device_node *np) __of_phandle_cache_inv_entry(np->phandle); } -/** +/* * of_detach_node() - "Unplug" a node from the device tree. */ int of_detach_node(struct device_node *np) @@ -318,7 +318,7 @@ static void property_list_free(struct property *prop_list) /** * of_node_release() - release a dynamically allocated node - * @kref: kref element of the node to be released + * @kobj: kernel object of the node to be released * * In of_node_put() this function is passed to kref_put() as the destructor. */ From patchwork Fri Mar 12 11:07:51 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398560 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098940jai; Fri, 12 Mar 2021 03:08:55 -0800 (PST) X-Google-Smtp-Source: ABdhPJyX8S9fcOht1H3+uq3rLCGgP9oq7kjLdNZo5PrKgRYKbl46Il2f/E/GzTZyNhPPOX4x1iPQ X-Received: by 2002:a17:907:75d9:: with SMTP id jl25mr7719272ejc.452.1615547335523; Fri, 12 Mar 2021 03:08:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547335; cv=none; d=google.com; s=arc-20160816; b=rlQIF+lIlva9L0iei2R3oV7ODDHw9NgO3YjXDbDCnylEEC6Ps0Yty4sO8eYyuiA7UE /StnHZc5r3ljtCWpjf51lwnjRzATNk7jMKpfDjmXfb1W8jpc5VzTalxJJ1afB7S1oHh9 WLWHaAb7jYvW47jFqVzmo0h4FPIk1J3qzYDOfkdvBMP6/peK3ont+YPwWfZMmrqz9BeI ubdtiIjrMRbXGH4NDLgGDJnXKoThY1pgRz55tAOnoXUS1IjE06AwoNEZemE/7koaeDw4 jSJMXdQbz8+Ip6hwf9P5CYRs5pLW272/ZcNNqg7dz0htRg7jsVPubcS/Oj0TIreIQJgd z6dA== 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=D47E9cXI25ZmpKM2KpzUfb+svP/iduBPVqgRHs8FW7k=; b=IbwIk17sGuCB0nyobRnAaZBGhoWb8ofeC2Nfj6OnQx8GQXTJvqIxDiaJ7rxcFcEuPL o0CCgHuw42ROUBdrLDSvYd0i9rkixOUymZPs57Lr4LdTWf/+sqIXkNViCFR90MS7Ngjb NtVAhgCUJTd0+jgxXu9PfhaEP6zRYFpIyf44tafCMMZdUYlv38FGiFIU7aNoBsYGEt5U bHFq7dJdQIll/PTIOuX7Ms6+bNOHyW2wKSbzesZ893tq62+dKH9ZkQPUwuvdJmnWckya jTliQioXT7NPQIKlqA1CxB23T/yk6KhC4r35phCrdwJQsCotmbpdDyRMOlXiTrgU4k8k L8fA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=GeWMOCvX; 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 b26si2139744eds.574.2021.03.12.03.08.55; Fri, 12 Mar 2021 03:08:55 -0800 (PST) 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=GeWMOCvX; 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 S233751AbhCLLIQ (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:16 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43706 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233778AbhCLLIG (ORCPT ); Fri, 12 Mar 2021 06:08:06 -0500 Received: from mail-wr1-x42d.google.com (mail-wr1-x42d.google.com [IPv6:2a00:1450:4864:20::42d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C277AC061761 for ; Fri, 12 Mar 2021 03:08:05 -0800 (PST) Received: by mail-wr1-x42d.google.com with SMTP id v15so4574831wrx.4 for ; Fri, 12 Mar 2021 03:08:05 -0800 (PST) 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=D47E9cXI25ZmpKM2KpzUfb+svP/iduBPVqgRHs8FW7k=; b=GeWMOCvXnVuoHuazmNjC2e7st0AiUkA8rkKG/ooTPLUla12O0Th3XVVJC2pd5EYa/c hhY7p53QKr9DOiI+k7gX/wgGPFAL7JvhhMfQaM2GJZrhiMVmXfNqXErr/r5WEs29gs73 Q2IetHszH8t/JJUyfC6NcSDlIp6zpUCx7RS0sBm0mXsNxBaR5Vzc5Mqs89m97vAuxPfe tD3t90EbkUFFjlrRyiR3UCIA12+/bQTxm/Fzd1o6QPmKrd2/BMDlQ0V+KT+0LLaV0OVb s/O0kqiyyfz37YiL1xhldpez7c75y+hHdjEa+e2KQydYJAdr+VwW64dvfiMY4WLnnHl5 q9QA== 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=D47E9cXI25ZmpKM2KpzUfb+svP/iduBPVqgRHs8FW7k=; b=N1jecOeoO9j900BDkukUuVL5WkIJJLrNmeVIQi7gQ0NchhUniREaq4PrMVq/edW93g JnP5BdFG4k/2KPCaFOcndGBjO/uGwkBMynCrZxwwloSQLJbZPil3xOl/Drlp/FHdlx2R IzheBH8Q/7Iy3BESzvFNpemaIFBsTxY2QZV2ChkI+MJoKT2HpNn4FxR5PVvjDTWFbmQp E00npUNhWWth6pPzldqO+XYUUDgUZSsNvAO7d9Ux2BHkdDrXzjZ0MYc02bmQmCC5KsRm cOog6K8AhJeaYiY/v22E4CgDFLd51s1nC4Y7w0D+shE3BCoPZUwNiwteRqpV1UjqpGfu s7kg== X-Gm-Message-State: AOAM531VMVof83lnUoQzhOCDQX8Kwk6wdDibgfgIJRe5qIoowwC501ya lhF2T4wVHXWycwEwxoQMlohhiA== X-Received: by 2002:a5d:534b:: with SMTP id t11mr13156836wrv.186.1615547284507; Fri, 12 Mar 2021 03:08:04 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:04 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , Kees Cook , Anton Vorontsov , Colin Cross , Tony Luck , benh@kernel.crashing.org, devicetree@vger.kernel.org Subject: [PATCH 03/10] of: platform: Demote kernel-doc abuse Date: Fri, 12 Mar 2021 11:07:51 +0000 Message-Id: <20210312110758.2220959-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/platform.c:298: warning: Function parameter or member 'lookup' not described in 'of_dev_lookup' drivers/of/platform.c:298: warning: Function parameter or member 'np' not described in 'of_dev_lookup' Cc: Rob Herring Cc: Frank Rowand Cc: Kees Cook Cc: Anton Vorontsov Cc: Colin Cross Cc: Tony Luck Cc: benh@kernel.crashing.org Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/platform.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/of/platform.c b/drivers/of/platform.c index 0da86209ddaab..0ed46d301431b 100644 --- a/drivers/of/platform.c +++ b/drivers/of/platform.c @@ -290,7 +290,7 @@ static struct amba_device *of_amba_device_create(struct device_node *node, } #endif /* CONFIG_ARM_AMBA */ -/** +/* * of_dev_lookup() - Given a device node, lookup the preferred Linux name */ static const struct of_dev_auxdata *of_dev_lookup(const struct of_dev_auxdata *lookup, From patchwork Fri Mar 12 11:07:52 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398555 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098883jai; Fri, 12 Mar 2021 03:08:51 -0800 (PST) X-Google-Smtp-Source: ABdhPJyrgB/6+0QeIlaD1BnQBsyZJFOUgqUk/9YaqMeTOrG/k1PPDVdEQjH+q5oagr9e/gJCtwhD X-Received: by 2002:a17:906:8614:: with SMTP id o20mr7676882ejx.386.1615547331485; Fri, 12 Mar 2021 03:08:51 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547331; cv=none; d=google.com; s=arc-20160816; b=CeyqaSlBRku2nFabt5OUufmjehYmL5N5qYvwd2faQbJdUljKEV7XeO+TlrIbnJXI/D WWpSWGeYHc6ie0C6DPGZF2BQoGbcb4ywqpGay3iwQrBCF0rUH00ESEuYqIDklQmXoOpp 6Fd09wGHxhte0QS5pI8Rx5fPczHKxslxhH2hcdsG5NQ3PiI8kH3HyEOY+OEuIeZysSwP cx0mGfjh0iWw9ccjVlbbaDNPnVzhRQHcPVYUNnQreA+rafwYbCP5T7SNf1Hec+54ds/3 sabYL6S+v2ITAydI6+BmjUOWpR2mxwltoZDvwJ3U0fz9av0ZR9xQcI5uGG0Atajp2etH P+TQ== 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=xE16iWVrd/Dz2OStGgcbMQc82tadivuaZyZu3WDq4F4=; b=l+DMz+IrGVPcO5Kczfb7JzwgLrd+YrwKHi022vjeYb6CGh+YYECW2eQjFKaB2VGY2/ qJD1/kWjKGIHsbAwQUGtIQgNBpVMyWwgmtVP8g2HL1CEz2dDGqU0aCdGJWRvPXiI9oRQ PmlPDPTsm+anmXbLchGTzdtXrX0mTy8i3DnQwxXFiXFnzfJHHBaS2+OXlY0swO78HAgO 5/iBgA59GitnIRwjhZZpMc2unxVnLduylB4gzFoeUyXMCtcs1Sxa+LhVVraU7ZENjQz3 W60Y6kj8oQkazH4WCI7iiZBcHYv/WhdddXPoqLdzMZZOHZL95tM6/6oyauhINi6Xa2g5 USAA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=EeAJHIWU; 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 b26si2139744eds.574.2021.03.12.03.08.51; Fri, 12 Mar 2021 03:08:51 -0800 (PST) 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=EeAJHIWU; 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 S233910AbhCLLIR (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:17 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43710 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233779AbhCLLIH (ORCPT ); Fri, 12 Mar 2021 06:08:07 -0500 Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AE684C061574 for ; Fri, 12 Mar 2021 03:08:06 -0800 (PST) Received: by mail-wr1-x42c.google.com with SMTP id l11so4567897wrp.7 for ; Fri, 12 Mar 2021 03:08:06 -0800 (PST) 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=xE16iWVrd/Dz2OStGgcbMQc82tadivuaZyZu3WDq4F4=; b=EeAJHIWUnnRZrbfgqRD8sH2Bb66d8WsCAn34rgGxA/jfeVYyJ+mEcFI1+cJVsLmoAu GrMSJd6sc2u0qwU6gfduVq9xSLQ18QwQpgSrlFZcmLRsApiNR4Op3sNIFuWnSRunwdiI tNKCxcWujNnIx8pi80XzVz1hYfnMPArSy7bU/yEWXDzc6AMX6dfhTXujg9f0LXzSPDTp Gz0mHr6iQstp5z0SR5UqQ50E/nIOCOM6ue1/QdC2fXv5TwXEgdPyvzGAMhX1GsXyiJWX mZ++VXA8u9xxknhkdI4KCrjmsKFk2hC6neZgTcNuLnV9QFlOvbYAegmz/l7lKyw7dYHs C76g== 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=xE16iWVrd/Dz2OStGgcbMQc82tadivuaZyZu3WDq4F4=; b=b5FfrAq/NdK5XK/Bn/XMquatNZDWaG4JjCyiDo6RcIg4LYiZy24+ZTVK7j9KWWlq0k U8B7Lhj3K5zrdPRshIvgCoF64krQMcHQY8LHH5RySj3/E3G+5hc7OpXJsu9NmXeXY1j5 fxTnnyfm0IKWzHzD880tn1/tNH3j0ayqJaX0gXWFmoAVdZTahgxK2M/8Yv1HpdjiQRKs +ipWwkLC+VwZ47EPF01X0A9kTPAVm+0oKjQGsRgY90FaUd0Qedmq9EzPBDBywllSTxm/ hELKp7M9wQXdb4zav5YCOK/FZCyUR2dYinz/jGWfZCH7DYYjIYhoWNg29T69tKmS6tVI Hpww== X-Gm-Message-State: AOAM530ZrfqpxI0rXhrusekqD0/LIXc43e/kPWRR7ecu/feARVKHF/vC 2FQQPjE+wya8ToxsXPxkl+DOmWBKijljCA== X-Received: by 2002:a5d:6c69:: with SMTP id r9mr13168817wrz.11.1615547285441; Fri, 12 Mar 2021 03:08:05 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:05 -0800 (PST) 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 demote non-conformant kernel-doc headers Date: Fri, 12 Mar 2021 11:07:52 +0000 Message-Id: <20210312110758.2220959-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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, 8 insertions(+), 8 deletions(-) -- 2.27.0 diff --git a/drivers/of/base.c b/drivers/of/base.c index 8a348f0d3c5e7..e0319e5f5793a 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. @@ -1772,7 +1772,7 @@ int of_count_phandle_with_args(const struct device_node *np, const char *list_na } EXPORT_SYMBOL(of_count_phandle_with_args); -/** +/* * __of_add_property - Add a property to a node without lock operations */ int __of_add_property(struct device_node *np, struct property *prop) @@ -1793,7 +1793,7 @@ int __of_add_property(struct device_node *np, struct property *prop) return 0; } -/** +/* * of_add_property - Add a property to a node */ int of_add_property(struct device_node *np, struct property *prop) @@ -1837,7 +1837,7 @@ int __of_remove_property(struct device_node *np, struct property *prop) return 0; } -/** +/* * of_remove_property - Remove a property from a node. * * Note that we don't actually remove it, since we have given out @@ -2125,9 +2125,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 From patchwork Fri Mar 12 11:07:53 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398553 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098862jai; Fri, 12 Mar 2021 03:08:49 -0800 (PST) X-Google-Smtp-Source: ABdhPJxOCoid80lnpCE+dtlPTJ2ldzY7oE4xswfq9N1dNSv52xtRYd92TQ7otVoidKsepiWHUczV X-Received: by 2002:a17:906:b20b:: with SMTP id p11mr8057732ejz.0.1615547329697; Fri, 12 Mar 2021 03:08:49 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547329; cv=none; d=google.com; s=arc-20160816; b=sAythrTA+ImZ1oWMbUAZtRYpXJ41w4As75xbOMhP508faKZhPFoL9wdiOxvECeP/7S mMIiv86+Z4wCOMf3Yc26dvKkiBLi6HcJLdZCfwyK0lB2AaN63L8J1fYpanBzAMwedGu8 uPqi4gJC2c1QQUQiH2pIndpFmvntR5Rh/rkYnROJpSMC305Aah3ZCkaLBZkuvbDIIIs6 wb0xjYGoe29H41Qc9fIXJtTI+2Fe7s0xKCHUF3fe6d4SzLS4SMlJfy2OukiZHaa+oMo+ DBpVSPfeuBhEvTPeJWABH8R519zBpxNgWUJcZOPLtfDHuLCUrxNlDLfjQ57RTaobiX2e 2uOw== 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=LUHr4ymMi5VBqrEoXKDtGcta5lpuLHD7VRSm0+qQluo=; b=h13sSGcTfOjVAhHbdCiaYNgAO85r2Ummuf8dclPNvuKm/0XxBJmJjVO/Ao2YDEOIqw 3wiyha+MQcNlBiL9iqqRkPZPIN27sLFOyEon6A8qz4MBHN7gfwko82v9YmwSoGwPv+Ye DhIcFpbFG81HZYB0dp4jTjebYY8TLKCZXgKZoCjYuQpio8bIZEO+kG4X3wdErKKBgqyC G56eVdhS83ytvofYcKCN2dW/j+Oga0KxMjiCgNBN8jqtx1y9xYke8V48vIkTRYg5JM/X KvulqeA9Mtw5pvVEZMjDPqRqIhf1EIOSaEZl1Y8nOMU+SemqtmCYZzXFME/yHGdgbIO3 le1w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=OsUv5iLh; 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 b26si2139744eds.574.2021.03.12.03.08.49; Fri, 12 Mar 2021 03:08:49 -0800 (PST) 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=OsUv5iLh; 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 S233762AbhCLLIS (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:18 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43720 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233794AbhCLLII (ORCPT ); Fri, 12 Mar 2021 06:08:08 -0500 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 A3345C061574 for ; Fri, 12 Mar 2021 03:08:07 -0800 (PST) Received: by mail-wr1-x434.google.com with SMTP id j18so1538921wra.2 for ; Fri, 12 Mar 2021 03:08:07 -0800 (PST) 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=LUHr4ymMi5VBqrEoXKDtGcta5lpuLHD7VRSm0+qQluo=; b=OsUv5iLhDgVhzhV0LgtfnRfdzSikIjb7ns1xlfS49V36qOY1J3vfBg4n7bat4iDp+h AQ5oMDxUUOgzdq4yCF/9y7XtceVljvkjbEm425LoibpX1+zdwxHJuiHCPNQyFxeObLdL w0DjPjN7ery3banas/9niexyypuvzerUOtQJSoI/RA61ZC5vx5qeLSksVr8fSBTtzs+u h8FiAzGy4ijoGkLsKP0f4sthFzaFuqAiinDXe/X90am1N8pX5IskzxNHvWUE4XNnUxz7 8PEqcIExAqwI6GCqx3yog1itbJYOV+ObEwkSnBbF5kY1ZHi0YIknnZIXgIsd4bRbhy+g WDkg== 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=LUHr4ymMi5VBqrEoXKDtGcta5lpuLHD7VRSm0+qQluo=; b=QMY+3XNK+b24w51WtwCU+7eBrBg4prxQRTRXt9UvZYVXxTd4tA6Q1GnvDNVvMJkpah oQgnq0vcUgALuFVcmPK7kFJKhhovFaeg2sDHN0ecag0JdsQXBBkBX6GYqphhCjwSg05I oAaBzgxRUHQiEWHZgj6OrnrHWQUSijOBwVkm10lNURGQl/0ho35vsUUxvv4Tmct6zf+Q 39vua+6qHUM01kyzE6l9tE4ONcPeqpl2HF9rXXADUWrJz+sztVXlqr0+uxfw9LbGEnFe 7RS9RoqgRi6yqkP4ZzUEmQrMcoV3GEGyLVJBEaEtVJg+wqMpETfX+wAGlcj/sZtvQaVF 0yQg== X-Gm-Message-State: AOAM532IPLxX3TXXP8gDDPlFAretRkP0EAF94lnDaHOIQVzO7wftWxyA M3ZFyzdxmeUgWGtm97FKxQ47/g== X-Received: by 2002:adf:ee4f:: with SMTP id w15mr13382205wro.199.1615547286375; Fri, 12 Mar 2021 03:08:06 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:05 -0800 (PST) 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 05/10] of: property: Provide missing member description and remove excess param Date: Fri, 12 Mar 2021 11:07:53 +0000 Message-Id: <20210312110758.2220959-6-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/property.c:1239: warning: Function parameter or member 'optional' not described in 'supplier_bindings' drivers/of/property.c:1366: warning: Excess function parameter 'dev' description in 'of_link_property' Cc: Rob Herring Cc: Frank Rowand Cc: "David S. Miller" Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/property.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/of/property.c b/drivers/of/property.c index 5036a362f52e7..5faf24a791c9d 100644 --- a/drivers/of/property.c +++ b/drivers/of/property.c @@ -1225,6 +1225,7 @@ static struct device_node *parse_##fname(struct device_node *np, \ * @parse_prop.prop_name: Name of property holding a phandle value * @parse_prop.index: For properties holding a list of phandles, this is the * index into the list + * @optional: Describes whether a supplier is mandatory or not * * Returns: * parse_prop() return values are @@ -1344,7 +1345,6 @@ static const struct supplier_bindings of_supplier_bindings[] = { /** * of_link_property - Create device links to suppliers listed in a property - * @dev: Consumer device * @con_np: The consumer device tree node which contains the property * @prop_name: Name of property to be parsed * From patchwork Fri Mar 12 11:07:54 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398554 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098871jai; Fri, 12 Mar 2021 03:08:50 -0800 (PST) X-Google-Smtp-Source: ABdhPJysqbtC8aa2XwFMdUqdGk8J/7p0BDwPAz6NScjvQ7UzTeud5qvfdp7LfXo5qq1eVCbt3t4x X-Received: by 2002:a17:906:6044:: with SMTP id p4mr7997206ejj.82.1615547330150; Fri, 12 Mar 2021 03:08:50 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547330; cv=none; d=google.com; s=arc-20160816; b=ow+UNrt0rSsckGHC8k09Y1Fo0k7h3w6YDvnVzKloL8vVDjKtBYGdcA8SCsS7DL99ch rdDqY+UvK1m+u0s5mpNA49xB8zgXVAvgDS/ppGhEwSzWOzYB8mxOizo+qHmCYEXA6W3q 4olm12MJ10OUZ5bzywgPn04YYA8Bcj/VjbfLli0SMN+xlxmFwBW2i/C3c9HQYcUc+izg e+RBmWXPnw6qPQCTCzvtUk/EYYlrpwPguQ/ied6fWZ0SNbuS/df/XhNVu7yelMZ/OpyV rD2p4x+hZkADQoLAXlVRVIkghD9F+CB5O0b5CpdmksN4upUZArgximk7ulF4kBKp10sh BjZg== 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=0k9bZZ6oep6a8gAswjqXP9lEO++F0b2FjoK2nqaF0JQ=; b=tHkU5/rIZYcSVVrO0zWU55XA11hmy5Ykh2YqKyD4bKkh+iLT65R3IPPxnE9AAXrk03 Y2y6VaanafyhHWIZ0FMoOAOn2D903M5YmlldAtlY4BczdoNmsik/9cq0rHk7f9bmTriq Kh2XiG5P2rBIC3UXYFdLGHd8Co0LhJu0b7ifQ6yXbUnYaazVdV1X7U+Hru67583SdB1Z rvZSRaqcjfyPkHoYX3oxBam6nciLx7SbA7S+S9XA8J81KsGuLHsZKGWx9i+cCjBTMJYV Cpv63hJ7CjOhCqlyzoMmwl9R0kpEIkJc7f8MU8R1zFD0udGzutZ9dVACxom0lFeqf/Rr uMUQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=mlx3SwYK; 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 b26si2139744eds.574.2021.03.12.03.08.49; Fri, 12 Mar 2021 03:08:50 -0800 (PST) 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=mlx3SwYK; 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 S233914AbhCLLIR (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:17 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43724 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233813AbhCLLII (ORCPT ); Fri, 12 Mar 2021 06:08:08 -0500 Received: from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com [IPv6:2a00:1450:4864:20::42e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 61A34C061762 for ; Fri, 12 Mar 2021 03:08:08 -0800 (PST) Received: by mail-wr1-x42e.google.com with SMTP id w11so4546980wrr.10 for ; Fri, 12 Mar 2021 03:08:08 -0800 (PST) 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=0k9bZZ6oep6a8gAswjqXP9lEO++F0b2FjoK2nqaF0JQ=; b=mlx3SwYKgets0dI286MU1qf+QdAehdwSkI3REXJk6LdrlclARx4DshlQpHLevNaVKQ DOJrVrL4VYk4KkaILsN+AyiW31ulsdIi8GhWDtybTbOLuzarGIYTljhGIr8E6Gny4sc7 NDxWEevHpSVpiwQQgM+51Nok6G8YL1NV2lhdFMO5BDXUMrGL9/EE14RTUnGeOVK35Cpk KUgxOQ9vkP3p6/hF4gETlmO8Q1YVnwDARTAlEs36AGI0/u7ym+9hP6Wt8z7ievurh2gP ZGqMYpB5ahjbN5MMHasdSCji/yrMG3Ppqgs0VSJe5kEeyQ7I0M1uDq3ZGUUPvDlYgqhr YFMw== 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=0k9bZZ6oep6a8gAswjqXP9lEO++F0b2FjoK2nqaF0JQ=; b=TUXck6mPzEfJT3ze9XfM9uz089xKFSxVUbmoLxDfxLioD0/1KsLM2C7t4xCbn3ntRb v19MMN7gvTF3WvwHEPoEAvyxd+HWDK6bTqW2NaFYRcL0LsuGb0xa0AaFj3a5D5OpBSc4 oC/4Mp7wJWd+jbZM251gNPihRetArsvoSOBPqFRFzYcKEzQC3FDidcvuNRHTfCdUbhL6 nQxOsWtsEIce5rE611HxS7W6t8FrQqp0S8DiEuccblKMlteQo6+yf+amC73vCWWD2yex NMPg7KJauZWYoTvth8/1w/KzuyZRCigkobLhQzG9/blcNiJ/uAPeC+XRCsGJpQUCKxQG 1aGA== X-Gm-Message-State: AOAM533KrBWIYJSZ8ZoLdKqoEZ6dLuFtQmKZCC+1AMLVPJkJDlm+y43k q83xguLzhYOyLxx3Ie9SwOF1QQ== X-Received: by 2002:a5d:67cf:: with SMTP id n15mr13267191wrw.95.1615547287168; Fri, 12 Mar 2021 03:08:07 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:06 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , devicetree@vger.kernel.org Subject: [PATCH 06/10] of: address: Demote non-conformant kernel-doc header Date: Fri, 12 Mar 2021 11:07:54 +0000 Message-Id: <20210312110758.2220959-7-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/address.c:868: warning: Function parameter or member 'dev' not described in 'of_address_to_resource' drivers/of/address.c:868: warning: Function parameter or member 'index' not described in 'of_address_to_resource' drivers/of/address.c:868: warning: Function parameter or member 'r' not described in 'of_address_to_resource' Cc: Rob Herring Cc: Frank Rowand Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/address.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/of/address.c b/drivers/of/address.c index 73ddf2540f3fe..9350697ae5aad 100644 --- a/drivers/of/address.c +++ b/drivers/of/address.c @@ -855,7 +855,7 @@ static int __of_address_to_resource(struct device_node *dev, return 0; } -/** +/* * of_address_to_resource - Translate device tree address and return as resource * * Note that if your address is a PIO address, the conversion will fail if From patchwork Fri Mar 12 11:07:55 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398558 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098912jai; Fri, 12 Mar 2021 03:08:53 -0800 (PST) X-Google-Smtp-Source: ABdhPJwKbZlEadtKQagNBD+xb1DGiynevzEu9G7tF0S2Yc/ijjhx0woA1IsQX+KLAE80bQFBYkP0 X-Received: by 2002:a05:6402:68e:: with SMTP id f14mr13405578edy.169.1615547333260; Fri, 12 Mar 2021 03:08:53 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547333; cv=none; d=google.com; s=arc-20160816; b=i6o+xjKs/oAs6Hv2MVOT9I71sBXDz1HuBFkZiyhUC+000GAoVwO20skM0gSurHTgBT AzKXYoKCBHftQv6PgCVFoETFvgNgL5oHg/t8A8N1MhiM3ltftNVLTffWcPTOZ/fAMOBl hWqH96y1eJMX/bC4Zug6pNbE1yMyEzkY7ujWvlu2fEniprTtMyoHAGdSuOdz8n5sWFHr JoGgUYBNJLTloVeWCEDMlrz/g9ZV/gO3sPERue/N04IpoDIAcIB6o7L1Te6TtOTePHzQ d+8W9mcpwd9gN26tlvw+jDyA8gN2F8Ookt/G06jN9XW+ikF8TQTNdYJ3l7pkrZh05dv/ ec5w== 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=THhKmywjPm3PSEVsHRgJ9yFTX2Li2LH1I2Fys+RHMbE=; b=xEeeZVes8yOtecdnXq8SX/Oxu6eLUCATDDuA3PYf9Mo6sySX3rqVNWg00uns1J97a4 JjkhqtmVrsB3KloBhN0T9LW4+YA5qbVEgaaKQa+TyTs9M8H7ROeXQLrAFSs7u4CLypUh NquU+gKl2HZz+Hln3qH89aI+vOCXXBbVKMDT9TgQ0osqukcpZavhBtx6EX2w6w6EI8CP +bwiTHJH02rAi0Dd7E5g02DNlVDHvVxD6aMdnMp+1qbucLkzntlVZ9CO/0AhcF2LFphO hBDZp8hdGuTZJi5rcJNPNpbY+zJ+uPaOpa7YBq7OhVaED/NnG1FUg56Zd22KONi2VZgr Hq1g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=aI9TlIjX; 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 b26si2139744eds.574.2021.03.12.03.08.53; Fri, 12 Mar 2021 03:08:53 -0800 (PST) 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=aI9TlIjX; 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 S233919AbhCLLIS (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:18 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43738 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233835AbhCLLIJ (ORCPT ); Fri, 12 Mar 2021 06:08:09 -0500 Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 755B2C061761 for ; Fri, 12 Mar 2021 03:08:09 -0800 (PST) Received: by mail-wr1-x42c.google.com with SMTP id j7so1541433wrd.1 for ; Fri, 12 Mar 2021 03:08:09 -0800 (PST) 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=THhKmywjPm3PSEVsHRgJ9yFTX2Li2LH1I2Fys+RHMbE=; b=aI9TlIjXysV5NO5te1tQfH8c+2PYDCD+Wy2lUjD3kFpYtm+upwffmJQd8DgW07vrbr +BTTPocgGko+6YTXpPeBwfl5snKyLMHh2nzaNfAlNa3w0J5zzBlsnUc+14WDH/5t7ALA P7LS2kOqbTapoK/3V9vkIt2tU5dosgbbtl5iiI2atOR4Cw2JE+6VHEYNY+hmFtR7bQ16 TKX/zrYPKiybQfjV8jE223NJVJSd6+D8NlCbnEVlRClDQ5p/zOwgasZSbzIsoUAsg53X v9MPwpz1ECsSifRsUrWfUtml5EHjeYiW+cd1L6S0E//fscpnPXtkxVikp9CeAyZeIWau N1Hg== 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=THhKmywjPm3PSEVsHRgJ9yFTX2Li2LH1I2Fys+RHMbE=; b=sTXQLhrYgS125Cg7Zy7Tfm4QV0koFIWXv05VQG6BpmiIgj1UByljCs783U9ht7VBAb 254MsYiNIunl3btak2pIHB094UovzvKrA80gVa5TmPu1xJO+ihJopnpLLZ5ooc7N+a89 vFNcvXlEYd/CLPujIdKJG+EpgRnFud3j4Mlk8SNvfVSfbc7H3CyTNLeN+4P7hfhP0kLk ELTSnF96uokbXgcPEKi8ODcwwHOtaKckiWpe9FpSWkhJVQGBgb/LXQZpGMreJ3myECEh k3P7q+t4hsKmaVy/J6a33xy7WCGFWH5C6Xbo3qjrKir+z0VI4aL3oDbYXZ/Ja+amnh7l Licg== X-Gm-Message-State: AOAM531iRkVKujLcG8TexDkbB5oMUVcBniBDXW/U8FsBOi9LOuhJeGpw J4iACF0KPtw8vHA1/0iHEpZ0ag== X-Received: by 2002:adf:a18a:: with SMTP id u10mr13500935wru.197.1615547288130; Fri, 12 Mar 2021 03:08:08 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:07 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , benh@kernel.crashing.org, devicetree@vger.kernel.org Subject: [PATCH 07/10] of: fdt: Demote kernel-doc abuses Date: Fri, 12 Mar 2021 11:07:55 +0000 Message-Id: <20210312110758.2220959-8-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/fdt.c:478: warning: Function parameter or member 'node' not described in '__reserved_mem_reserve_reg' drivers/of/fdt.c:478: warning: Function parameter or member 'uname' not described in '__reserved_mem_reserve_reg' drivers/of/fdt.c:525: warning: Function parameter or member 'node' not described in '__reserved_mem_check_root' drivers/of/fdt.c:547: warning: Function parameter or member 'node' not described in '__fdt_scan_reserved_mem' drivers/of/fdt.c:547: warning: Function parameter or member 'uname' not described in '__fdt_scan_reserved_mem' drivers/of/fdt.c:547: warning: Function parameter or member 'depth' not described in '__fdt_scan_reserved_mem' drivers/of/fdt.c:547: warning: Function parameter or member 'data' not described in '__fdt_scan_reserved_mem' drivers/of/fdt.c:547: warning: expecting prototype for fdt_scan_reserved_mem(). Prototype was for __fdt_scan_reserved_mem() instead drivers/of/fdt.c:663: warning: Function parameter or member 'parent' not described in 'of_scan_flat_dt_subnodes' drivers/of/fdt.c:708: warning: Function parameter or member 'node' not described in 'of_get_flat_dt_prop' drivers/of/fdt.c:708: warning: Function parameter or member 'name' not described in 'of_get_flat_dt_prop' drivers/of/fdt.c:708: warning: Function parameter or member 'size' not described in 'of_get_flat_dt_prop' drivers/of/fdt.c:758: warning: Function parameter or member 'node' not described in 'of_flat_dt_match' drivers/of/fdt.c:758: warning: Function parameter or member 'compat' not described in 'of_flat_dt_match' drivers/of/fdt.c:778: warning: Function parameter or member 'node' not described in 'of_get_flat_dt_phandle' drivers/of/fdt.c:778: warning: expecting prototype for of_get_flat_dt_prop(). Prototype was for of_get_flat_dt_phandle() instead drivers/of/fdt.c:955: warning: Function parameter or member 'node' not described in 'early_init_dt_scan_root' drivers/of/fdt.c:955: warning: Function parameter or member 'uname' not described in 'early_init_dt_scan_root' drivers/of/fdt.c:955: warning: Function parameter or member 'depth' not described in 'early_init_dt_scan_root' drivers/of/fdt.c:955: warning: Function parameter or member 'data' not described in 'early_init_dt_scan_root' drivers/of/fdt.c:991: warning: Function parameter or member 'node' not described in 'early_init_dt_scan_memory' drivers/of/fdt.c:991: warning: Function parameter or member 'uname' not described in 'early_init_dt_scan_memory' drivers/of/fdt.c:991: warning: Function parameter or member 'depth' not described in 'early_init_dt_scan_memory' drivers/of/fdt.c:991: warning: Function parameter or member 'data' not described in 'early_init_dt_scan_memory' Cc: Rob Herring Cc: Frank Rowand Cc: benh@kernel.crashing.org Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/fdt.c | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) -- 2.27.0 diff --git a/drivers/of/fdt.c b/drivers/of/fdt.c index dcc1dd96911a9..1fb3348eb9516 100644 --- a/drivers/of/fdt.c +++ b/drivers/of/fdt.c @@ -470,7 +470,7 @@ void *initial_boot_params __ro_after_init; static u32 of_fdt_crc32; -/** +/* * __reserved_mem_reserve_reg() - reserve all memory described in 'reg' property */ static int __init __reserved_mem_reserve_reg(unsigned long node, @@ -516,7 +516,7 @@ static int __init __reserved_mem_reserve_reg(unsigned long node, return 0; } -/** +/* * __reserved_mem_check_root() - check if #size-cells, #address-cells provided * in /reserved-memory matches the values supported by the current implementation, * also check if ranges property has been provided @@ -539,7 +539,7 @@ static int __init __reserved_mem_check_root(unsigned long node) return 0; } -/** +/* * fdt_scan_reserved_mem() - scan a single FDT node for reserved memory */ static int __init __fdt_scan_reserved_mem(unsigned long node, const char *uname, @@ -650,6 +650,7 @@ int __init of_scan_flat_dt(int (*it)(unsigned long node, /** * of_scan_flat_dt_subnodes - scan sub-nodes of a node call callback on each. + * @parent: parent node * @it: callback function * @data: context data pointer * @@ -689,7 +690,7 @@ int __init of_get_flat_dt_subnode_by_name(unsigned long node, const char *uname) return fdt_subnode_offset(initial_boot_params, node, uname); } -/** +/* * of_get_flat_dt_root - find the root node in the flat blob */ unsigned long __init of_get_flat_dt_root(void) @@ -697,7 +698,7 @@ unsigned long __init of_get_flat_dt_root(void) return 0; } -/** +/* * of_get_flat_dt_prop - Given a node in the flat blob, return the property ptr * * This function can be used within scan_flattened_dt callback to get @@ -751,7 +752,7 @@ int __init of_flat_dt_is_compatible(unsigned long node, const char *compat) return of_fdt_is_compatible(initial_boot_params, node, compat); } -/** +/* * of_flat_dt_match - Return true if node matches a list of compatible values */ static int __init of_flat_dt_match(unsigned long node, const char *const *compat) @@ -771,7 +772,7 @@ static int __init of_flat_dt_match(unsigned long node, const char *const *compat return score; } -/** +/* * of_get_flat_dt_prop - Given a node in the flat blob, return the phandle */ uint32_t __init of_get_flat_dt_phandle(unsigned long node) @@ -947,7 +948,7 @@ int __init early_init_dt_scan_chosen_stdout(void) } #endif -/** +/* * early_init_dt_scan_root - fetch the top level address and size cells */ int __init early_init_dt_scan_root(unsigned long node, const char *uname, @@ -983,7 +984,7 @@ u64 __init dt_mem_next_cell(int s, const __be32 **cellp) return of_read_number(p, s); } -/** +/* * early_init_dt_scan_memory - Look for and parse memory nodes */ int __init early_init_dt_scan_memory(unsigned long node, const char *uname, From patchwork Fri Mar 12 11:07:56 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398557 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098901jai; Fri, 12 Mar 2021 03:08:52 -0800 (PST) X-Google-Smtp-Source: ABdhPJxsDUcmwt0wFAWhkCX3a6hsVbplZ9xE4b32DCqun04EvkEePRuQsDuGXRX/vL2jM1+EUY+0 X-Received: by 2002:a17:906:358c:: with SMTP id o12mr8141823ejb.156.1615547332530; Fri, 12 Mar 2021 03:08:52 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547332; cv=none; d=google.com; s=arc-20160816; b=d6KGRVyz58p6/9R2g9cO8+iQiejckPOH2ttHKeR6vm1k1wueqIjaj9PmsBCgdh/4Mc N3FALq+1pBy7IlB4Q03WwCjwp9lKAyOoB4e1yS97JEnM5Xw828d5m4XD7nmOBNV5wwAn nUNL5tcl/pO4Ruae3hEz4xR9A5qZwLMPcUvl4DlLxppMUX93kFpE1RxaqGhyUbsWolOS iiCNoqVciH07MD1grTRHhNknkTem7y6UpEHnK7mnZRsLZ22lYr3qCYaJ0JFJ+NjdWvTH N4N0dEp+csDGXEGyzQi1wL1YHD9hOV3K6TmY2Z/JTvrZFywScAoYHCEIzEjZsA/1KnF+ uWCg== 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=uhFSV6Hqzt9zCZfztk/Zxp+QtBdpm5r07mTFNAPSF1U=; b=Hsu3wXmmjijs//1uD9TOHlSn9XAdfnhrbvHIspKoygGSnoLyevsbEF9fYBuGuvU4Xj WhVjkQqtbV2F2oOVJ87s+shOh7XGI4aGjrWfES9dTfmcFO37fynWq2B7aDB8E2HdkG9T RXOuXXt4dggCKKxIfNCcrvRd1RyWBzETai+OrhBL8AYr3YE2fiWshKrWmbdWkBLGvDLO R9KSzdQ/yvP8V4ebNe5D3BvSV6u4uKMGceN5ou8wxmkMuyaaspV5u1Xn3Plck2uDHinh HC4PJKIJN3pVUTDZ5VnPj6eraKXGno9yQMcqVrpdCawzLNVnZqZ1GvYXspQanB7PWyOY jG6g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pnyGgcuH; 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 b26si2139744eds.574.2021.03.12.03.08.52; Fri, 12 Mar 2021 03:08:52 -0800 (PST) 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=pnyGgcuH; 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 S233924AbhCLLIT (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:19 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43740 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233838AbhCLLIK (ORCPT ); Fri, 12 Mar 2021 06:08:10 -0500 Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [IPv6:2a00:1450:4864:20::32f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 612AAC061574 for ; Fri, 12 Mar 2021 03:08:10 -0800 (PST) Received: by mail-wm1-x32f.google.com with SMTP id d139-20020a1c1d910000b029010b895cb6f2so14929421wmd.5 for ; Fri, 12 Mar 2021 03:08:10 -0800 (PST) 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=uhFSV6Hqzt9zCZfztk/Zxp+QtBdpm5r07mTFNAPSF1U=; b=pnyGgcuHAR6LtC2mCsQxH2xirFJ+yIbnNAkBIXgauwReKVyo8iVuN1BjI123xgGw52 Vaxnzti2nlyxKn/ao0jLzrRE/6fmKeSN123EXSi5zVgQV7P1faQVwYhCs9UKv8OAg461 sEmMWlJFpcFBFpD8JFq/5VPMz6wvRpTzFUvQc/JK9EXBTAW4VuyUs7iGOfciUS3AbYqg qsVgljqtY5y/QCbDrTTFqU6IVNXLdb2R5bgVW+olqgj1/fNnr6CS4Y90awS/hQ03Ax6c AwGVtHq3/9w1sTgXG2EwhGUrnv6X1AT+gmSO5eZikfISeQ7S7xK8AzXNkH7OS2OifI5P 4HCQ== 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=uhFSV6Hqzt9zCZfztk/Zxp+QtBdpm5r07mTFNAPSF1U=; b=fRU++X8jzgs3L4A+TOBm0jt4YXVYy7p5q8jh/ms0RRKgnPRe1XNr5o6xxrFef+fqOL nKeW7tuBVzUARQbKzZQcGAEI7ISGOlMCzQahh9brK0qw7SZm8zKSDuc0BcH9TB5P4dwP PZlf0YUSI81cFM7MiUtF6Z0hHsQBqU1Bl52nKbh+F1RwbmOpKpr/Iq7jRhdPqAf2TkkZ 4cUggosRvLJR4CiPvZTNVvvvvyG2yipFoZjAPDNhhQY3zVCYJdshM8HTgTNIbQuhqROH vehS26RS5MgsUjp6zOEqSUx0QhVdLiLPkbvjiEdNb4XW7ltm5cmgK7LzvRGInNu+yVhq Otlw== X-Gm-Message-State: AOAM532IR8KNlKTmvqFM+zzNg3G9LofmuXRtWusTxI4sIwizWdAu2tkL REUBCm0rawKokNi3Iut8BC9x3g== X-Received: by 2002:a7b:c759:: with SMTP id w25mr12404907wmk.139.1615547289092; Fri, 12 Mar 2021 03:08:09 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:08 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Andrew Lunn , Heiner Kallweit , Russell King , Rob Herring , Frank Rowand , netdev@vger.kernel.org, devicetree@vger.kernel.org Subject: [PATCH 08/10] of: of_net: Demote non-conforming kernel-doc header Date: Fri, 12 Mar 2021 11:07:56 +0000 Message-Id: <20210312110758.2220959-9-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/of_net.c:104: warning: Function parameter or member 'np' not described in 'of_get_mac_address' drivers/of/of_net.c:104: warning: expecting prototype for mac(). Prototype was for of_get_mac_address() instead Cc: Andrew Lunn Cc: Heiner Kallweit Cc: Russell King Cc: Rob Herring Cc: Frank Rowand Cc: netdev@vger.kernel.org Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/of_net.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/of/of_net.c b/drivers/of/of_net.c index 6e411821583e4..9b41a343e88ab 100644 --- a/drivers/of/of_net.c +++ b/drivers/of/of_net.c @@ -78,7 +78,7 @@ static const void *of_get_mac_addr_nvmem(struct device_node *np) return mac; } -/** +/* * Search the device tree for the best MAC address to use. 'mac-address' is * checked first, because that is supposed to contain to "most recent" MAC * address. If that isn't set, then 'local-mac-address' is checked next, From patchwork Fri Mar 12 11:07:57 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398559 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098920jai; Fri, 12 Mar 2021 03:08:53 -0800 (PST) X-Google-Smtp-Source: ABdhPJyIqWMnncOmHKLD4QYa7MALGGZ5nSYXHgNxOOoif0yH5YuZJ/rWD5bOpDfFWYRG06HmSZHf X-Received: by 2002:a05:6402:3122:: with SMTP id dd2mr13322582edb.253.1615547333813; Fri, 12 Mar 2021 03:08:53 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547333; cv=none; d=google.com; s=arc-20160816; b=VZvaCFoS+DteT7Ttf8QbEH+p9sI5zZ/qcqsBRNSzcXmaonrO+QDD9+siyQu+LRSH2C f10qBkVaPffWa44r6hFbjwaCTMttYYGkjRAPIi6niK9i1eUqcCdEXM0y+EnO99gBTzGD iLfsuJJEOz8sbKuWPXGJqOfgZfKZ0V+OfdXqy0Mkoklkviw26BVn9POBYA0HWkW10ePj P+QqM6bwd4pc+ZwS1x7HWvmnjqtAS9IWs3j6q6smg9tuz04S1I0A4xU1SZ3Ru+bolyab iAo4vGGTdxwgLZpVCodgItttomEKxFG9RUTS1mlM8jGYKwDR7hdJcKJACo5RjNkGXSXy d+eA== 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=0qmJtn2ROcq97cCAA/GgmHQVBHx/QLh0PdVV8I8LApw=; b=RM347xuwu3jzQq2ykCyCESJ+8p8Sxny5m++QM647uB2cNcH4AM5Qmoc+/0r1tXTWSd dStIEDqT1Sd32LrYgIZMWaA2AF12dTu6mmwK8UhkPQlJT890NPficIdfXOJVskwDHwbj hj36c7yFbgi+tRnNfd59CHp1X619UPT9J35AUS+q5Sr0L5FPuQYBQxajTfEwVZefDyvp dpKV7f33s+pf6LWQ6+H3DDzHxVpD/HZuNtGryNQIB9KaTi0+8XbFvRgGEwAujKibj6RF eu5y+RDI6hmJTP5tAGmd4UJ3HdUS3j+7qXV5LrtdlkS9hgdhcMzN6T4KzLqTtDP1QM4S NG5Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=G5ue6+jR; 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 b26si2139744eds.574.2021.03.12.03.08.53; Fri, 12 Mar 2021 03:08:53 -0800 (PST) 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=G5ue6+jR; 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 S233936AbhCLLIT (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:19 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43752 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233868AbhCLLIL (ORCPT ); Fri, 12 Mar 2021 06:08:11 -0500 Received: from mail-wm1-x329.google.com (mail-wm1-x329.google.com [IPv6:2a00:1450:4864:20::329]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4068CC061574 for ; Fri, 12 Mar 2021 03:08:11 -0800 (PST) Received: by mail-wm1-x329.google.com with SMTP id c76-20020a1c9a4f0000b029010c94499aedso15545324wme.0 for ; Fri, 12 Mar 2021 03:08:11 -0800 (PST) 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=0qmJtn2ROcq97cCAA/GgmHQVBHx/QLh0PdVV8I8LApw=; b=G5ue6+jRiPOzq/lTADL9GS6ZiSQV1lqYa6OFSDlKj5E005qW0tpjcCwKDRUtDZbKd+ 2csTU8r1cM6ZAGC423BbrQXTqqsexOPlNp2MtoU4tiHUW339WrkZm9+xPjd88bySsvh4 urQZ2szjy6rw7/lwmKq7VsTYDclnBGrB5jkAo989HorY2VpunPe3w6On523sRmlX/eJy 1P47iupyOtjC38861DiFU+8ET7Bkam+LPUV0/uYES5xjMmhLm0pT+9z+ILWIoUgn5VtX r6TZ/YOB57py9JU7d9g+TbxJOOT+XF++6EWy89GdsjTEIEU0pN2STtyCUpK+7Oo21rZN +N/A== 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=0qmJtn2ROcq97cCAA/GgmHQVBHx/QLh0PdVV8I8LApw=; b=laFFEGO1TVnkbcN3QLG1jcbmd7meLFjkabAVJSdkJuciDuZ/s7lYcrpudlpxgvR2IB BLCEQD7J9PUfBJ1Jm2uf1V9IasdQQvyOQvXT7+/3st0efDSlJL/GriUz/JQTwqGkxxRG Hgb0N3chDTrNYxZ1toP0XF+/nqudXUsusHaxrgqv3RPEs89fksMybqPhWdECLz7FBqAt uVwW3sAUyCAINQ3H4Jlw4Kwk6chWojQZsr6vGCAkdYLjqC9qChwDusG/464JJHJ9PfZT uYxA264ZGlDLZqc8FRD4mxG4qS3EBk5KEOLG6M7QCgKrl957eH7Tf3bfDUR5Cc66K2Jt gCmg== X-Gm-Message-State: AOAM531bcsEJqOI6LpG07VZ0bkJdsAPMtCtP+YBqrfz8ptsIoHS5lx+n ueuc10wcJcX2SRcz8NN0SxMpgw== X-Received: by 2002:a1c:1dd5:: with SMTP id d204mr12259143wmd.127.1615547289996; Fri, 12 Mar 2021 03:08:09 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:09 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Pantelis Antoniou , Frank Rowand , Rob Herring , devicetree@vger.kernel.org Subject: [PATCH 09/10] of: overlay: Fix function name disparity Date: Fri, 12 Mar 2021 11:07:57 +0000 Message-Id: <20210312110758.2220959-10-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/overlay.c:147: warning: expecting prototype for of_overlay_notifier_register(). Prototype was for of_overlay_notifier_unregister() instead Cc: Pantelis Antoniou Cc: Frank Rowand Cc: Rob Herring Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/overlay.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/of/overlay.c b/drivers/of/overlay.c index 50bbe0edf5380..1c867a5e4c7c2 100644 --- a/drivers/of/overlay.c +++ b/drivers/of/overlay.c @@ -140,7 +140,7 @@ int of_overlay_notifier_register(struct notifier_block *nb) EXPORT_SYMBOL_GPL(of_overlay_notifier_register); /** - * of_overlay_notifier_register() - Unregister notifier for overlay operations + * of_overlay_notifier_unregister() - Unregister notifier for overlay operations * @nb: Notifier block to unregister */ int of_overlay_notifier_unregister(struct notifier_block *nb) From patchwork Fri Mar 12 11:07:58 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 398556 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp1098896jai; Fri, 12 Mar 2021 03:08:52 -0800 (PST) X-Google-Smtp-Source: ABdhPJxi1AOge8F6jtYM3M6PAjbPFyFykaSU/itHBBpNYgmW8U9BbPuwH4gkIfeQ72hqv3PO4QgU X-Received: by 2002:a17:906:384e:: with SMTP id w14mr7770923ejc.285.1615547332167; Fri, 12 Mar 2021 03:08:52 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615547332; cv=none; d=google.com; s=arc-20160816; b=kv2tF5SQB7q9teSL6wHFYkkBkf2SxlokGDssiLCJOP2fNcacPx6xTEbQfXPOoPhXoo Sv9E1deU8FCsRhx2YezMeQmqw8/CuJLco+pWkqLkDCM5ykn83+0V9vydeg3wxD4U/Y4u IY+kfL2DAUESMf2LmZau2LaoDZxxSt5ov5pwTnpTBGAT8o02fGP47N8VyoDIcKcm/mRu G3srMjeponwUNM52h96pm3Gh5/nKTmdEMWslby1iEqxhJ1mE0mkG46GVxvbBnlNvHKzK V7nEUpRkC70nNy6I5zAYEiSyMW03NS+pBkm3v9jqOatAlHQ4TCVyf1DjPPFTba5S6bbA Lr3g== 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=CqsJEFNZDm1zRQWkx9oBbTS7v3YGOj5LKMbHcTRx7PQ=; b=kkJXAWz2eOkDQ+Icz1HwvyWIxY0eaCzC//WTyK9fNOh37vCqKRaS1h93CQ402pcrm+ N88miGwoqpB1nd3EsHfIKGkOkA+JIKeNjh+tMAJC7wt6G3zxVA1NQ5LxYTGhQpP5Yh5/ VBoBPxjRHMHwjnevPmAjvL7KPOwyilHOs+XQO0MnSziTTpejLzAXKGr1pfniHxR/Sz/B E70TRjeEq0BeNlOyu7xdvHriNwj1IBOxASQxpSyAE5NJaSPPWhdD26mlJGkrSa6K9iL4 LvbEdGIChVXDYJGfbkBUXvB+cN9BtPipZz6aSVqRxjntBIwZ0nwm/iDhyaf3RYYtpxT6 We3w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=IS2cn8bY; 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 b26si2139744eds.574.2021.03.12.03.08.51; Fri, 12 Mar 2021 03:08:52 -0800 (PST) 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=IS2cn8bY; 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 S233939AbhCLLIU (ORCPT + 6 others); Fri, 12 Mar 2021 06:08:20 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43758 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233888AbhCLLIM (ORCPT ); Fri, 12 Mar 2021 06:08:12 -0500 Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 216BAC061574 for ; Fri, 12 Mar 2021 03:08:12 -0800 (PST) Received: by mail-wr1-x432.google.com with SMTP id o14so768772wrm.11 for ; Fri, 12 Mar 2021 03:08:12 -0800 (PST) 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=CqsJEFNZDm1zRQWkx9oBbTS7v3YGOj5LKMbHcTRx7PQ=; b=IS2cn8bYyoEKgx9TQnyV83erYgi3O4sqNhgKMBQ1a3mi78NghSnMF8OXAEd82RjNVZ uQZMokDl1yxFnIsc/BTxNSbqabLeW6L3YizE5d7XRQH6cS/CJWbcV+PhxsstpW6sbz74 WVf6pv4DutsDKl32B0nJElPnlq1YpBJKACB6+8CchMaf/QJmHei7TJjBhUZsYcHLDwQu ASp4bozMnmDtgXdV+ChlKymXZYqiCJBkmR4w3Hkc9keFWZEAjkkkhpiKTnVTo536M9NE uLU9M9x5pdlw9abS0dn8vEG9MqjkBuUNxUVx0F1rbTxwwd2AKM33P9rHBbIZ9hUDZ0e5 IzIg== 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=CqsJEFNZDm1zRQWkx9oBbTS7v3YGOj5LKMbHcTRx7PQ=; b=a6dcqBdU00qFu8fqF2WbQdVsrZz2kMGWTS5Bg/tgmZ5so9g86SPG3avlOdbp3Vj3SV UBj0EUb/CKl/a7LAJtTG6HHTP13fr1TXxXAe+GNYqbo0O2WRjAwbYh8BAL/2KLUYJbn4 e2P64m3ocD/qtvJUeWOVrQOjeDKsxiq3Kzbym5dTWeZepGNQ4GtaymZusEwpWEuPgnFt +3ms2oTbwTFg3n8pYos/Y7Z1xQNkzJe0HPz90fenS0lCSuIbKupprekGwWU48O1PKU88 C9ugcLDGtIZ/tqYCsW5EIvpJo2XCiwjmCw9P5oHvbIlxpGBXwzT0VjRQGytfowmLPPHA M1AA== X-Gm-Message-State: AOAM532H/fJ28Z8R6RrJY8v830aj/UBl86H02dFlGDxs787Jmg6MoTul lUilzJJUFg0DJQUgWmW1bLpe4Q== X-Received: by 2002:adf:e3c9:: with SMTP id k9mr14067319wrm.308.1615547290812; Fri, 12 Mar 2021 03:08:10 -0800 (PST) Received: from dell.default ([91.110.221.204]) by smtp.gmail.com with ESMTPSA id f126sm1813003wmf.17.2021.03.12.03.08.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 03:08:10 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Rob Herring , Frank Rowand , Marek Szyprowski , Josh Cartwright , devicetree@vger.kernel.org Subject: [PATCH 10/10] of: of_reserved_mem: Demote kernel-doc abuses Date: Fri, 12 Mar 2021 11:07:58 +0000 Message-Id: <20210312110758.2220959-11-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210312110758.2220959-1-lee.jones@linaro.org> References: <20210312110758.2220959-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/of_reserved_mem.c:53: warning: Function parameter or member 'node' not described in 'fdt_reserved_mem_save_node' drivers/of/of_reserved_mem.c:53: warning: Function parameter or member 'uname' not described in 'fdt_reserved_mem_save_node' drivers/of/of_reserved_mem.c:53: warning: Function parameter or member 'base' not described in 'fdt_reserved_mem_save_node' drivers/of/of_reserved_mem.c:53: warning: Function parameter or member 'size' not described in 'fdt_reserved_mem_save_node' drivers/of/of_reserved_mem.c:76: warning: Function parameter or member 'node' not described in '__reserved_mem_alloc_size' drivers/of/of_reserved_mem.c:76: warning: Function parameter or member 'uname' not described in '__reserved_mem_alloc_size' drivers/of/of_reserved_mem.c:76: warning: Function parameter or member 'res_base' not described in '__reserved_mem_alloc_size' drivers/of/of_reserved_mem.c:76: warning: Function parameter or member 'res_size' not described in '__reserved_mem_alloc_size' drivers/of/of_reserved_mem.c:171: warning: Function parameter or member 'rmem' not described in '__reserved_mem_init_node' Cc: Rob Herring Cc: Frank Rowand Cc: Marek Szyprowski Cc: Josh Cartwright Cc: devicetree@vger.kernel.org Signed-off-by: Lee Jones --- drivers/of/of_reserved_mem.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/of/of_reserved_mem.c b/drivers/of/of_reserved_mem.c index a7fbc5e37e19e..15e2417974d67 100644 --- a/drivers/of/of_reserved_mem.c +++ b/drivers/of/of_reserved_mem.c @@ -45,7 +45,7 @@ static int __init early_init_dt_alloc_reserved_memory_arch(phys_addr_t size, return memblock_reserve(base, size); } -/** +/* * fdt_reserved_mem_save_node() - save fdt node for second pass initialization */ void __init fdt_reserved_mem_save_node(unsigned long node, const char *uname, @@ -67,7 +67,7 @@ void __init fdt_reserved_mem_save_node(unsigned long node, const char *uname, return; } -/** +/* * __reserved_mem_alloc_size() - allocate reserved memory described by * 'size', 'alignment' and 'alloc-ranges' properties. */ @@ -164,7 +164,7 @@ static int __init __reserved_mem_alloc_size(unsigned long node, static const struct of_device_id __rmem_of_table_sentinel __used __section("__reservedmem_of_table_end"); -/** +/* * __reserved_mem_init_node() - call region specific reserved memory init code */ static int __init __reserved_mem_init_node(struct reserved_mem *rmem)