From patchwork Thu Nov 12 13:19:54 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324191 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp648638ejb; Thu, 12 Nov 2020 05:20:10 -0800 (PST) X-Google-Smtp-Source: ABdhPJzYxqzooCzIQW07x5ubYh0f5VgePRyKRpNnW5+haVtz9JvXiP35xoTAzOdGlA6og4fNfbQx X-Received: by 2002:aa7:d717:: with SMTP id t23mr4985884edq.286.1605187209904; Thu, 12 Nov 2020 05:20:09 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187209; cv=none; d=google.com; s=arc-20160816; b=Ws4E8O4hJDWEiV7EwDLbXxP2A1TJKNroQ8ADcWAMBj2O8hNKPeiVxnlCrTdrboQAbc LIesPvA3xj3UNQ4S7iPAGO9GwJ4bfa1FPVqXb5+6qvceU7Jtbe6renT+WfKgneeLlPnz YIZZwtpOz2Qsjdj8vyUFbgiDYF9TBk9lJWWyP1crATuhmbJPVoVNIbdVtpFDQr5sW7lD m1JwD2h9MKH0BaWTD5e9AFxXHNR6wmYOiOFRWDN2gHrKDm8l2wuxGcJPR7BvnyZNlxEh olCynFjBiG365/usZVWbI02o9hwHyzcRWI6Ny4UU6VWrcSQA9+b6qz1x9b9JB99YyYko jKyg== 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=8jk6HVNhRUeEoNSWaOGwYJftWHgUEkFSpcCabqTm85s=; b=HK9yiXOe3RPJZ3soeU0OPiOLxMUQThnw/Wgd3K/12cFgSp9yNS+bzTv4XxZZWNlW4U p8SIeWy6Hibxyraz0npl/5GzL2i26szu7Pi6Sm/3fVi0OEfx6BGLiMeFyAso/EmpQqK1 MRKxcuHuxgs7pbSNMLF5w9cyBo9ccpRzDoy0AS7Ad+jjiV/Qg1JQ3mU3lxYlXw3Zc+Vk U8kJmDqDD+al8M2zBzo/lEsw32wxZro/2k5AVS87y9GT4dNoHyNENumMYCEgcVAwKPT1 Nbq4Ouvt+ObwzEvFVE5++8woX4oXdUsngYddFhsBnA3MFm/uqf17FU8154r76+jYSlbe Z+gA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="sYfuYLr/"; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 r1si3721604ejh.137.2020.11.12.05.20.09; Thu, 12 Nov 2020 05:20:09 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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="sYfuYLr/"; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728207AbgKLNUI (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:08 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48350 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727993AbgKLNUF (ORCPT ); Thu, 12 Nov 2020 08:20:05 -0500 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 74B14C0613D6 for ; Thu, 12 Nov 2020 05:20:05 -0800 (PST) Received: by mail-wm1-x344.google.com with SMTP id p19so6164457wmg.0 for ; Thu, 12 Nov 2020 05:20: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=8jk6HVNhRUeEoNSWaOGwYJftWHgUEkFSpcCabqTm85s=; b=sYfuYLr/GzDr2sN/zXiJloI1wO0uWu41b9GLLElDCpwpM7Zwt/WM1IxysnWMk1jIwZ 1hMmGzs7IMj+ipZ2lwITHkFGIyrmiHMOIy8aIX6LOo32DuiZZOZ+vJ0JDAWjAEWs6cUb FCJYW0Sw2sx5qDJjlXNig5xR7y+dMVX2DaRtkcicQ7QHb1gOW1OT47pxmzuAmwVoPgcK 9HhL77b7olhyPPl5kKPS0Y+x4Dvs9hI4+IuhVuUD7G/Xxxr+U3BZsjRBDIx3TMQptyA7 kAW0jNeuYY+O4h/f3And5Obfdr6uCoZRpePi4s/0EWp8kA2kvl9rGObE/sArQAqjlhp1 1sLA== 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=8jk6HVNhRUeEoNSWaOGwYJftWHgUEkFSpcCabqTm85s=; b=SLOhhaEeZFz7HaMRKTwVSJEr/whW4LfCOJSoRBH8x6W9FQDZlsyR4ZO2GDz7uHQCWf Q5JazeUra317mZWD7MBO0dSyDaHz9vXUsLxyicx/JJtFR8AoIDwam9S82Lpfr39P2VKV PZrYshKuLEUeeR22Dj62P4fCxnjAx8hi+n5CST+fJnIuo0UJfutcjjfOkBC59iJHMbSa p7SDolGxJNcYwnQFc+z18zhYQ4D4QT8gUFPQ6FdF0f0D2WJn18Fz5QTHlEtE/aV5JtCj yVbgFNSG1cIMsexJ9uZNGGV139+nC6PYEyChjbM8WE3EPI5lPZnHm6dS32Ss0QNqhR5j zT7g== X-Gm-Message-State: AOAM530PUAhiSKR1raLnxL702+lCebiS13lDKQxserRWH/iuqAKpJaT+ Gl2bwMtH3npmjskDXOBJOU05OA== X-Received: by 2002:a1c:c203:: with SMTP id s3mr9791779wmf.77.1605187204118; Thu, 12 Nov 2020 05:20:04 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:03 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 1/6] staging: net: wimax: i2400m: control: Fix some misspellings in i2400m_set_init_config()'s docs Date: Thu, 12 Nov 2020 13:19:54 +0000 Message-Id: <20201112131959.2213841-2-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/control.c:1195: warning: Function parameter or member 'arg' not described in 'i2400m_set_init_config' drivers/net/wimax/i2400m/control.c:1195: warning: Excess function parameter 'arg_size' description in 'i2400m_set_init_config' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/control.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/control.c b/drivers/staging/wimax/i2400m/control.c index fe885aa56cf37..1e270b2101e86 100644 --- a/drivers/staging/wimax/i2400m/control.c +++ b/drivers/staging/wimax/i2400m/control.c @@ -1183,11 +1183,11 @@ static int i2400m_cmd_get_state(struct i2400m *i2400m) * Set basic configuration settings * * @i2400m: device descriptor - * @args: array of pointers to the TLV headers to send for + * @arg: array of pointers to the TLV headers to send for * configuration (each followed by its payload). * TLV headers and payloads must be properly initialized, with the * right endianess (LE). - * @arg_size: number of pointers in the @args array + * @args: number of pointers in the @arg array */ static int i2400m_set_init_config(struct i2400m *i2400m, const struct i2400m_tlv_hdr **arg, From patchwork Thu Nov 12 13:19:55 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324195 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp649362ejb; Thu, 12 Nov 2020 05:20:40 -0800 (PST) X-Google-Smtp-Source: ABdhPJxl9ubt1ZQq82R+WEM2s2JFaIxWoTnhXEMV7NX31zqJ4GSfWuZ1DEcvoLrLIDTgkgYMvYrW X-Received: by 2002:a17:906:3b81:: with SMTP id u1mr29595200ejf.542.1605187240154; Thu, 12 Nov 2020 05:20:40 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187240; cv=none; d=google.com; s=arc-20160816; b=dhFYla/kuBOB/z8lw0Hn/PAXAnEuKlzO+I0XgjyLn7AYVb9I71sNzaSEcGqBAeM8x5 IN13ohISgcjyj2TyxMA8E9ml6ZLXbe0q7Pyojr+jmSkdx1TS8IUUmG3cs3x++1B8iEe4 Fcd0qdEB6kYbP/FmwhsuZGHX9k9x6DHt394Ej8qKIIkvynuAxRxRA09vLumA+OVRBi2n PxG5YxHopPYDpOE6uE7ZNDOFQ5M+QrPixz9sCCZSb1r8IdyaI8e1JLntOXhYByBvUVBb ujmj+TIDC/fPFMJXo7xwwljm4wMfQnORkmbw3PcDnaEZYPtHsF2+wp3J21Bv11LS+hJ5 M9JA== 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=1EvnHF8fJtxX0TvIRevhCbYRdcfG85M/ScXKW761pZc=; b=bm0f6j8yfgEfLiENgfBQsFOvhrG+NyulT2jwBfWIuUwn0Qx7HgL8ddKqyj1dEXrAxi Tk8onW0SRNe9fFUcsDPLUqOQon2IpeZVS8um1HHn+eJ/qcBPsjNoMBnGIdyNYlIqvnzb jVnGxM7PFYpOmmu/42iPqSXUzuRKeY4jj9i/pX8m4amXuc/AchgroXWSbfd7goLjFP3V BrZ4wwKikW2QzdVoTYSp4ZQ8631n3M9mvhGyfJNYwGavNG+Y0Qx0sxPKOqKhNu7Nu6dS fQcWJ5daLgEr3bCCzf3YBbAtul31AnemX/hmzmSK6WJTIRvnLd1E4v+Fqt9sBInRPMCJ QQ3Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=UlKfMiMk; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 l91si3880904edl.566.2020.11.12.05.20.39; Thu, 12 Nov 2020 05:20:40 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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=UlKfMiMk; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728266AbgKLNUM (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:12 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48358 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728219AbgKLNUJ (ORCPT ); Thu, 12 Nov 2020 08:20:09 -0500 Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 53D6CC0613D1 for ; Thu, 12 Nov 2020 05:20:07 -0800 (PST) Received: by mail-wm1-x341.google.com with SMTP id c9so5233762wml.5 for ; Thu, 12 Nov 2020 05:20: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=1EvnHF8fJtxX0TvIRevhCbYRdcfG85M/ScXKW761pZc=; b=UlKfMiMkOGEGNZogzeC2joDgluOiMtaAKYZlbLR89inDce3Y2gmRzUDP6cATJW6rik yJi37oJWC8h0dmq5PmaPrHP/j4w7FBozQtvEi5jTt1yX7Z+1EcZbAou78CciHQAbfaid eWYtsROUDZao8rm4Kpy+o/1rfO6WLhZay8uLC9lvRiixueauO6xI7EF+fi4M/b+Kd7n/ gwnf1w0L3Mmksa29walXzQR5t0/yCu2Sa+yh3ZKiVnfT8EppB3DXaVh7gZMzOqprPy0K LhcWxqEHzao6mX15IC8JcjUvRoiZUIrm0Vu0ZQpG4yqpl+uLT3Ft5Gczz6jAwUn0d9cs gAsg== 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=1EvnHF8fJtxX0TvIRevhCbYRdcfG85M/ScXKW761pZc=; b=uO3UbiKroAZ/hQ6ytnPlvNAjnm604BLrcjmheUJ8Ue3o81THRXyGFCQ4HCnKkurzv+ pnQy1luzYM2ja7uwekuAbGvcQ3p4D9dXrUX3pBhHy/SCGefvcXzlbrsYW+OmON8emKRP qkhJIxgkhWWKCa8sDrtchnsl1AJCeJRPGd26Y8zOhtRPotWX9/0iudsBSJh5I0wFXlRe rQUj9ZQUoTu+PdQTa38C5xoe8x0bIM3clA7J3Ir+HoITL3EJLgW699I/ZlV1oVemsE6a Ozp7moN8/vCqv2mYiswou2zxAzahrTBONyTjFtERc5Y91OMgMnqM7NYZPcSNVKRn+Dh4 RhFw== X-Gm-Message-State: AOAM531TwBI2uwzVvnIeKVX9rBWIRpeR0O6KWLYQsEqL4EmpeBUh0Xlp XJsCRvAGAzuttRjzM0gpEMiO2w== X-Received: by 2002:a7b:c925:: with SMTP id h5mr9598763wml.5.1605187206038; Thu, 12 Nov 2020 05:20:06 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:05 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 2/6] staging: net: wimax: i2400m: driver: Demote some non-conformant kernel-docs, fix others Date: Thu, 12 Nov 2020 13:19:55 +0000 Message-Id: <20201112131959.2213841-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/driver.c:681: warning: Function parameter or member 'i2400m' not described in 'i2400m_dev_reset_handle' drivers/net/wimax/i2400m/driver.c:681: warning: Function parameter or member 'reason' not described in 'i2400m_dev_reset_handle' drivers/net/wimax/i2400m/driver.c:775: warning: Function parameter or member 'i2400m' not described in 'i2400m_init' drivers/net/wimax/i2400m/driver.c:842: warning: Function parameter or member 'bm_flags' not described in 'i2400m_setup' drivers/net/wimax/i2400m/driver.c:942: warning: Function parameter or member 'i2400m' not described in 'i2400m_release' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/driver.c | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/driver.c b/drivers/staging/wimax/i2400m/driver.c index dc8939ff78c0e..f5186458bb3d4 100644 --- a/drivers/staging/wimax/i2400m/driver.c +++ b/drivers/staging/wimax/i2400m/driver.c @@ -665,7 +665,7 @@ void __i2400m_dev_reset_handle(struct work_struct *ws) } -/** +/* * i2400m_dev_reset_handle - Handle a device's reset in a thread context * * Schedule a device reset handling out on a thread context, so it @@ -685,7 +685,7 @@ int i2400m_dev_reset_handle(struct i2400m *i2400m, const char *reason) EXPORT_SYMBOL_GPL(i2400m_dev_reset_handle); - /* +/* * The actual work of error recovery. * * The current implementation of error recovery is to trigger a bus reset. @@ -766,7 +766,7 @@ void i2400m_bm_buf_free(struct i2400m *i2400m) } -/** +/* * i2400m_init - Initialize a 'struct i2400m' from all zeroes * * This is a bus-generic API call. @@ -831,6 +831,7 @@ EXPORT_SYMBOL_GPL(i2400m_reset); * i2400m_setup - bus-generic setup function for the i2400m device * * @i2400m: device descriptor (bus-specific parts have been initialized) + * @bm_flags: boot mode flags * * Returns: 0 if ok, < 0 errno code on error. * @@ -933,7 +934,7 @@ int i2400m_setup(struct i2400m *i2400m, enum i2400m_bri bm_flags) EXPORT_SYMBOL_GPL(i2400m_setup); -/** +/* * i2400m_release - release the bus-generic driver resources * * Sends a disconnect message and undoes any setup done by i2400m_setup() From patchwork Thu Nov 12 13:19:56 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324192 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp648883ejb; Thu, 12 Nov 2020 05:20:18 -0800 (PST) X-Google-Smtp-Source: ABdhPJxhl7arhayQOJL4bw8VmPRPyD+ELj+DKN1dw4nLi9H2/Ys7R2QhyCkp9fq3FAM8mjF6hsG4 X-Received: by 2002:a05:6402:1acb:: with SMTP id ba11mr5023716edb.48.1605187217941; Thu, 12 Nov 2020 05:20:17 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187217; cv=none; d=google.com; s=arc-20160816; b=MMVtyITaNTHzSk/0krJKtq1rq5lK9ZWJOckG4AnFs9uOL+HmAOVHPjGuZBw1hylAQw /hl8gRxnEVSiNeZDOYwA+VmTmfDGfIxhX4mD3mgfA5F3+xi+mfiWfIIEulTYCVRiOlDf zGwLtXDHrq2eslAZsBYr2ZhE+r4sJyiF5GOliyquDtDYYo90wACRG1FJysblShFOXSuG 8eyqWud6QL6Fu8AH+7XpVEkYCxSN1PhNtbczBbxSoVW4t1aImgzFXqBVwFWFoqOwFI6T L3mP5FOmcCSdAKwQ5+EalgO1Ympy4LjKgbC7WM+jCpgrNPl4zgNMuIAST7+tZkGibAbe NDtQ== 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=eX+GAAptHKXOgkhhbpbMgVCvd1r24QVRM1QUTVGcPnU=; b=CGly7T8Qp182kH3cl9U6mE7hv8w4orI/d6WD9sJe8D0TCfURSp4JnD7ms0j4StTYpv Sr2s5i5wsaY4gWSujknzzfr5SKd3/1q3yj6vWw9TDBTzAx0DOmNOe9K/jSus1lwXbNuT d4F/f5d+4caKgyXeBXEuikUBnOAg8L0PthEzvKQlshHVmpNzcUN1JdotIWtrsujwkmNX T3I5SCdtWbG01apFNYmmj02vOX3yLdseTv/m+kHx3cQW84wPSl9D0ZSQd/LgAq3h0nsc 8S4Np06ZCckui7CUqHA/pswpSdipbvO3uyrSqF65MO+NFpfRvVm4fWSxkR+fggemkCP3 ZJ/g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=r7ks3WZ0; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 13si3957442edv.433.2020.11.12.05.20.17; Thu, 12 Nov 2020 05:20:17 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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=r7ks3WZ0; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728270AbgKLNUN (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:13 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48364 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728211AbgKLNUJ (ORCPT ); Thu, 12 Nov 2020 08:20:09 -0500 Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9125EC0613D6 for ; Thu, 12 Nov 2020 05:20:08 -0800 (PST) Received: by mail-wr1-x444.google.com with SMTP id l1so5955839wrb.9 for ; Thu, 12 Nov 2020 05:20: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=eX+GAAptHKXOgkhhbpbMgVCvd1r24QVRM1QUTVGcPnU=; b=r7ks3WZ03Rk/rlNiqW0vrdZ5f0tUwn8RyVrmHJ1/rAjKIhGNF03nERo+UOAnUayb5N ODPD8xNuJAxnt6bbKRCGGVtWQHsmibelQ7xDkgzEr34xgcVHJREwDVxTz1X4UQgu/okD WmQ6h3XZ06G/XaRepGbUq600vle6QN1hBmIQiyfLSlFPaAPgwBXGadAJYjfKp5KkZU/a bUQ4Fi/VnN0JiOc3piOLAA0BnfsWgFXtyQQ6NkG9ifBx0z1cDLmSfnm2vTuNzL8BVQiL sP1960KNh3E4xelGNqsJRYut3RaNaYttcmp8EKIwRg4RJvwNxlnHiEbgO8eCS94/xMnA 86jQ== 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=eX+GAAptHKXOgkhhbpbMgVCvd1r24QVRM1QUTVGcPnU=; b=dPDFcAsDfzZEuZ7rpcNVzjarHmi4RiqnjsizTeRA4nTlgdAScT2uZME8R2e//gGYPc UQ0GG50lUEtptjku85CF8SZBU2VQ1fkAsIH3h2Q6QRKnFH6L3wCsMxFTl2GILzJHom1q GI9GNdB/gSgroVcjnl0JbfzQxrARIkkUa4+ok+dJOiSdSNnuyJLhv09dtRa6SI19N6Mj qk9TBJp06d/rNqitn5WrSEoebljYPyxRTzcuVZQPyWu6Iyq1Deb3tcWJHuvEfVat5sS2 Je0w4qHlIiECvx/DhhuqtOrK8wMSW8paW+xvYQS/tj0a+vXcu+pnhoqbUkbxOIUGG067 Z73w== X-Gm-Message-State: AOAM530ytrHwK9U2KkDhL5rKYMCdnZn9+1oHTAuP6KXQtq14LvWpwUxl WKp5wXAKCUSqjHJ9o8oN9Be4Ww== X-Received: by 2002:a5d:548b:: with SMTP id h11mr16509802wrv.306.1605187207325; Thu, 12 Nov 2020 05:20:07 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:06 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , Yanir Lubetkin , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 3/6] staging: net: wimax: i2400m: fw: Fix some function header misdemeanours Date: Thu, 12 Nov 2020 13:19:56 +0000 Message-Id: <20201112131959.2213841-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/fw.c:584: warning: Function parameter or member 'i2400m' not described in 'i2400m_bm_cmd' drivers/net/wimax/i2400m/fw.c:584: warning: Excess function parameter 'returns' description in 'i2400m_bm_cmd' drivers/net/wimax/i2400m/fw.c:646: warning: Function parameter or member 'chunk' not described in 'i2400m_download_chunk' drivers/net/wimax/i2400m/fw.c:646: warning: Function parameter or member '__chunk_len' not described in 'i2400m_download_chunk' drivers/net/wimax/i2400m/fw.c:646: warning: Excess function parameter 'buf' description in 'i2400m_download_chunk' drivers/net/wimax/i2400m/fw.c:646: warning: Excess function parameter 'buf_len' description in 'i2400m_download_chunk' drivers/net/wimax/i2400m/fw.c:1548: warning: Function parameter or member 'flags' not described in 'i2400m_dev_bootstrap' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Yanir Lubetkin Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/fw.c | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/fw.c b/drivers/staging/wimax/i2400m/fw.c index 6c9a41bff2e0a..9970857063374 100644 --- a/drivers/staging/wimax/i2400m/fw.c +++ b/drivers/staging/wimax/i2400m/fw.c @@ -534,6 +534,7 @@ ssize_t __i2400m_bm_ack_verify(struct i2400m *i2400m, int opcode, /** * i2400m_bm_cmd - Execute a boot mode command * + * @i2400m: device descriptor * @cmd: buffer containing the command data (pointing at the header). * This data can be ANYWHERE (for USB, we will copy it to an * specific buffer). Make sure everything is in proper little @@ -566,7 +567,7 @@ ssize_t __i2400m_bm_ack_verify(struct i2400m *i2400m, int opcode, * * @flags: see I2400M_BM_CMD_* above. * - * @returns: bytes received by the notification; if < 0, an errno code + * Returns: bytes received by the notification; if < 0, an errno code * denoting an error or: * * -ERESTARTSYS The device has rebooted @@ -634,8 +635,8 @@ ssize_t i2400m_bm_cmd(struct i2400m *i2400m, * i2400m_download_chunk - write a single chunk of data to the device's memory * * @i2400m: device descriptor - * @buf: the buffer to write - * @buf_len: length of the buffer to write + * @chunk: the buffer to write + * @chunk_len: length of the buffer to write * @addr: address in the device memory space * @direct: bootrom write mode * @do_csum: should a checksum validation be performed @@ -1533,6 +1534,13 @@ void i2400m_fw_put(struct i2400m_fw *i2400m_fw) * i2400m_dev_bootstrap - Bring the device to a known state and upload firmware * * @i2400m: device descriptor + * @flags: + * I2400M_BRI_SOFT: a reboot barker has been seen + * already, so don't wait for it. + * + * I2400M_BRI_NO_REBOOT: Don't send a reboot command, but wait + * for a reboot barker notification. This is a one shot; if + * the state machine needs to send a reboot command it will. * * Returns: >= 0 if ok, < 0 errno code on error. * From patchwork Thu Nov 12 13:19:57 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324196 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp649388ejb; Thu, 12 Nov 2020 05:20:43 -0800 (PST) X-Google-Smtp-Source: ABdhPJw+aT/AnoRtc/wDRaoqGua8ip/3TPmKd/87eCw+UE6b+17jFimfyOJK01lukkivaLhULUC5 X-Received: by 2002:a17:906:8398:: with SMTP id p24mr31052036ejx.401.1605187243353; Thu, 12 Nov 2020 05:20:43 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187243; cv=none; d=google.com; s=arc-20160816; b=txIx90MEFOUK7SaNXJE1chD2P44vvXvqgKMrYKpI4rmEIcG/xABT24CZZcVo3hWyGj sD3L6J+fb2WMP5iKBrb0UdksqfMeEp361fz0Th3GkKYoLouFzNOyPGaZcmUIj7LDo8dY rb/Rtwvk7FAyWu2SZN8Rcg1UjSyhoLQnc3AcpDvOVN3BlYs0rUWwovoK7vvTnPaCRSVn XuIZX8DUq11hu+yMqiT2JMF7SRBSDQI3lxsF3LKfMNS34qWE95nnl6dVCMuYzn29CEsa RPif6tKz/b4HBrtUwOXQlX4PgkOlNW/fECorfgAp8BpwY2/gXkkcN1+UBNXpgu+dj5i7 OH4A== 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=LII9MNgt9pv1krh9xVWqsqClr9UQVbocm2wzkwzWn8k=; b=svN/gL5z2c1Fl7wYbRAspr1fBy8N1DqDrUn1UcKlJnRFzGnubjCefsXAAlJqkivnVK AOxsCPP1PRK3wI+RLNOlIilY7v/xTHJ26+1A3sd3Dx/1Xy+zzLIkgKKZDGTXaONvk3bb DM2b+pV8UK/2aXwqiWP9QVOf4c2DBq7cHgH/xyY7eC8Az7nDX2J8C3fPNShatbMBM27Z bpTkRftI4Pps+sQaViw/BX9lLyukpLvEdg2Kh2RwHVjyKkRtLlYuOZQb/8SBn86Reb25 t6c02kggzU237jyR8okQZ2Wckz3erUzzC+H/IgU0VDHPq5oQBdeXgV9fTTUGMtq10Ngj Ctrg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="y26/CrKR"; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 l91si3880904edl.566.2020.11.12.05.20.43; Thu, 12 Nov 2020 05:20:43 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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="y26/CrKR"; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728358AbgKLNUk (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:40 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48370 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728253AbgKLNUL (ORCPT ); Thu, 12 Nov 2020 08:20:11 -0500 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E3B2FC0613D1 for ; Thu, 12 Nov 2020 05:20:09 -0800 (PST) Received: by mail-wr1-x441.google.com with SMTP id b6so5979908wrt.4 for ; Thu, 12 Nov 2020 05:20: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=LII9MNgt9pv1krh9xVWqsqClr9UQVbocm2wzkwzWn8k=; b=y26/CrKRMckJBmsrPXZ57maQyGpG/r7AzJk8ZEg9fz7LcpbCmzBKSDcHI2Sg66PzQj uRmSVTWXX4lTIbA07TkRB/9QxaFl1Cv0MypR3nOXQTFCuEI6CDa+3LuyomDu8RNTfVkC kIRmmqwZBoADKBXDiBJdComCFtEW01ZVKh/A6bjcUc6kV3Y9Y+UzmQWvR5I7kEcI7O+f FOKD5uia49j3F+Oqj7O8g2vSW3pw3D1otIrV6NzSbNLJqbGX1EOaD6SUlMufZSq4DDar LyoPTe0usXqm50eHkHNF6+IYv8XSBemL8m1xZKwJRO8oi6joWMZEV/ss4ArBdENaXN/1 GWBw== 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=LII9MNgt9pv1krh9xVWqsqClr9UQVbocm2wzkwzWn8k=; b=fB7xp7Vvz2cWEW9wX8Ombpq4aDd5wieXi0qSbQv6+Jqv4fiGHsYvJ6GXjh2stPClKB gNhUfazCUbZsJZb+8cD8eM1pVL9hENj+pj4h/tgyrkzmWGbikVxNxrcxtOZWI8CPQnEx yGAC8vWrrMvjxgxjgKbvWOg1nwKlZRwy686bdztuyGdivBnOH4/43uWGp/iqfoy2gCfX ADKkCEXb7Au+FAt/LV5hTK8wlDkDOGScFEz3bKshOWE+Bpl6EJtoTCASa9T6OkOl9Ut9 TaQFUDJrY4QV3bfp0LWkey+kCk5/mxplUc7KgKVfqfGjrZv1+cf6L8n/tRBoBlw1B+vB 5/ww== X-Gm-Message-State: AOAM530APzm/R2Hg5emmQN5JKrl9tc+/gTFYi9uPqNTj/Yr7zwFsTvM4 Mv7wTkK6Wdvy9cOHKoMuZNgb1Q== X-Received: by 2002:adf:dc0f:: with SMTP id t15mr8729158wri.29.1605187208708; Thu, 12 Nov 2020 05:20:08 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:07 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , Yanir Lubetkin , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 4/6] staging: net: wimax: i2400m: netdev: Demote non-conformant function header Date: Thu, 12 Nov 2020 13:19:57 +0000 Message-Id: <20201112131959.2213841-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/netdev.c:583: warning: Function parameter or member 'net_dev' not described in 'i2400m_netdev_setup' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Yanir Lubetkin Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/netdev.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/netdev.c b/drivers/staging/wimax/i2400m/netdev.c index a7fcbceb6e6be..8339d600e77b5 100644 --- a/drivers/staging/wimax/i2400m/netdev.c +++ b/drivers/staging/wimax/i2400m/netdev.c @@ -574,7 +574,7 @@ static const struct ethtool_ops i2400m_ethtool_ops = { .get_link = ethtool_op_get_link, }; -/** +/* * i2400m_netdev_setup - Setup setup @net_dev's i2400m private data * * Called by alloc_netdev() From patchwork Thu Nov 12 13:19:58 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324193 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp648921ejb; Thu, 12 Nov 2020 05:20:19 -0800 (PST) X-Google-Smtp-Source: ABdhPJxUAKlDwtYCtywEO9XBkJkRNNp5rvXJIwlezFtKPqPOtyarO8CeJDi/rcdxCwBP2W51wXY0 X-Received: by 2002:a50:99d6:: with SMTP id n22mr5138038edb.261.1605187218427; Thu, 12 Nov 2020 05:20:18 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187218; cv=none; d=google.com; s=arc-20160816; b=mCZcLMntiy+qiGK5a89CsccqBG+xjT6NshW7VPnQuQzZ+NEL4gZGSteI4H+IG9nlSK PXWhEJwYQ+TWH1cp0hOObXzamnluIc+0Bh+Z2xXIs7qWlLsUEteDpef8nkWEJLKfZ/ZT Gy2O936K42ux9O9I+q/vjmNQncIaMZtsFaV0pkQwWaT3iJfjLJ3O5SefaKjFomSyVpb4 gKHowe7nRcZV6Fqor15Z7p2IuDdNNAyF/fS9TsHSFhYfK3PzJghoo4xAwtIi3pyV5Xds dId7gHXDyswnCcx8vV19cZ0MutX3sslPpyN3e6xdRdc8qQxtMkz4ilW/9p+9M/MVcvZ5 Cvag== 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=W7iFgNzjupYbkhuJ8ppUAnhnD6gEMwq5fnIgnkH5hQg=; b=quaRODyDRockhn45o/URcE44xGTtn9/6ZTlroPMRfYPPmQ6t7rZEUxM1vBk4L+wXnh zRFtkJjJwpgaVT6OIKLdeGks0d/xHJ+2fv38eYtynAuduUm9M984t53VLdLnoRG0wpBh dTcAFNA2enl9Z60XOEc9Tg5QxCLkwEP8xb2zfwo4F/gHJdSbia8zGcQPS8+X3DPzVEKT ua6YlchHaHHcdQgToz2UGRSPc9JubvI57HibMXgnkSjXyXbydgl2N1DU4YQ1HaFNKJzK Zzi8DB1d5ZFfAy06jsqw1xyl96lpPnqPix5vxIZaiU/w4QZsK3lmMHBTo+XIMZe08GxE vrpA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=xraKgwig; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 13si3957442edv.433.2020.11.12.05.20.18; Thu, 12 Nov 2020 05:20:18 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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=xraKgwig; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728312AbgKLNUP (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:15 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48380 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728285AbgKLNUN (ORCPT ); Thu, 12 Nov 2020 08:20:13 -0500 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6E8C8C0613D4 for ; Thu, 12 Nov 2020 05:20:11 -0800 (PST) Received: by mail-wr1-x441.google.com with SMTP id s8so5946207wrw.10 for ; Thu, 12 Nov 2020 05:20: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=W7iFgNzjupYbkhuJ8ppUAnhnD6gEMwq5fnIgnkH5hQg=; b=xraKgwigr/3WOJ5/Z6ypYZXDmivlx16frB+i1AcULwNtfPPaL2QkclE4D9d6xSDk+y KtX84j8cy3C8188Z56CgA2Ec4qtJL/w0pADmaA3TXMIRDJOF2yF1+4XG+X383rojWTeF Pw/SMd+y6waKOyHZ+5xSamHLhCWDAKRO+cKNGC+uREUoNQHAq+1EZnAcD+bO5Ivx65tP pELabNcfICfoyJLlHJHKfWqLa+0bD91R80sjfp104cukICbWR0tgLtD5kmvMwSrhsajC Cgklf98XLad3yOrLH2qTWFBvWW6Z7eLJ8wiJWY/4wrLkh9Y0YB5FJo2MWLcWofw/fHXu D1mQ== 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=W7iFgNzjupYbkhuJ8ppUAnhnD6gEMwq5fnIgnkH5hQg=; b=U3ojZd2/LWUjVMAMM7yk9dRDEnZAeDp6wGnnCOABL93ZLuby5EPXZW6oc/Fbd8BcqM CVtS/DXqD9EUglnLqTCnlOH82MRmULZ7oqqDpDiwg5TtcCB5RFcZKvFx0mIV44Eo1gya wwdRvANQZJ5Q++n9qfOxsfZMYTTjcgYQrEgBvECRSDpAFaSgfIyh1vht1u2/CzLnNgv7 XcEmTzm5m7rie33jprZ4GXNfcgnV9U7Fsyz2UkDFk6Verf5S8eZYnjgo2V0+3G057+28 n7a6o2prGwkzCFjxkEwlWeT59LIhC6rx4vtpj8DQOCbAMQzkV9S4pitrOL9T/UC/uD4O jBYg== X-Gm-Message-State: AOAM530sNZCqlPNCAH7DOHo00TRQjUVHGhKnfOJvx1nzgBDYkGSkXlPI zsY8LwDDF31H8oPkXwffKoAH4i67kGfjUKeh X-Received: by 2002:adf:f347:: with SMTP id e7mr25933848wrp.183.1605187210191; Thu, 12 Nov 2020 05:20:10 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:09 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , Yanir Lubetkin , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 5/6] staging: net: wimax: i2400m: tx: Fix a few kernel-doc misdemeanours Date: Thu, 12 Nov 2020 13:19:58 +0000 Message-Id: <20201112131959.2213841-6-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/tx.c:715: warning: Function parameter or member 'i2400m' not described in 'i2400m_tx' drivers/net/wimax/i2400m/tx.c:964: warning: Function parameter or member 'i2400m' not described in 'i2400m_tx_setup' drivers/net/wimax/i2400m/tx.c:1005: warning: Function parameter or member 'i2400m' not described in 'i2400m_tx_release' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Yanir Lubetkin Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/tx.c | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/tx.c b/drivers/staging/wimax/i2400m/tx.c index 1255302e251e4..e9436212fe54d 100644 --- a/drivers/staging/wimax/i2400m/tx.c +++ b/drivers/staging/wimax/i2400m/tx.c @@ -681,6 +681,8 @@ void i2400m_tx_close(struct i2400m *i2400m) /** * i2400m_tx - send the data in a buffer to the device * + * @i2400m: device descriptor + * * @buf: pointer to the buffer to transmit * * @buf_len: buffer size @@ -955,6 +957,8 @@ EXPORT_SYMBOL_GPL(i2400m_tx_msg_sent); /** * i2400m_tx_setup - Initialize the TX queue and infrastructure * + * @i2400m: device descriptor + * * Make sure we reset the TX sequence to zero, as when this function * is called, the firmware has been just restarted. Same rational * for tx_in, tx_out, tx_msg_size and tx_msg. We reset them since @@ -998,7 +1002,7 @@ int i2400m_tx_setup(struct i2400m *i2400m) } -/** +/* * i2400m_tx_release - Tear down the TX queue and infrastructure */ void i2400m_tx_release(struct i2400m *i2400m) From patchwork Thu Nov 12 13:19:59 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 324194 Delivered-To: patch@linaro.org Received: by 2002:a17:906:d156:0:0:0:0 with SMTP id br22csp649248ejb; Thu, 12 Nov 2020 05:20:33 -0800 (PST) X-Google-Smtp-Source: ABdhPJwFFo+gxVApwEpGAbHBeEXshuIh4CHoanBwEHPMQHiET7vOKy7AxqGiNzxkRcQneGa72j4R X-Received: by 2002:a17:906:2ad3:: with SMTP id m19mr29330664eje.81.1605187233131; Thu, 12 Nov 2020 05:20:33 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605187233; cv=none; d=google.com; s=arc-20160816; b=j1YmZKSvRw75agkt4/d3wXPqIE5YvLHc6njfVrcC8nV6af70CpaYrg6LdkVdqLxjMD mJRWiEq6kiqGPd1jw+aEmXx98+8cE5FYZIa7E/49MZY3tg/7BYSUNwvgTAlVjC+BN5vD 7DbcQkKLUsGiftYwHkQyBvIh5f/kD04xtOTuOtm2cznke1KBTQEmY8WmNlqCrPi6/0f0 gNTnui8OHztpkd1QfDOfaLfZf7+GsZOu0qNlA71le5JPv1YscUNhPfKtpmM6ocJgn4Xa NFjBJevRd+SyjDwrJq5Bsct2PUKrsD3DUu9I1MsqVKE2BTYKR6HEeH0KCtMvn61MDTdS stVw== 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=8bT6NBr573z4dRmUGzdy7vOSo0LG9hQOBgI7J9L19n0=; b=okyAwQVdUOShoxPvMpWwcJKZDFSUVoZKymNqgC/s8IDI1dm+YOUs9e3LS4+GzPlZwh F9kJxpWJZknMRJGdv1psuTEfJWrvh2ZaINpzl7Rf85ouxqf1qECoRVfwzfwggYR5o9vP HqTyrG2zFQiMFcj6R8vpy06uuFuvp2rM9flRm0FR2HRq8lFnUz4vOXg2ygnPMq2jNt5h ZOTShCHe9V/B48xNNHvy8YwR9IAIfkLLId9RPSkKEMSdyqMVxHFbDuNlmAIQiObbTCuo qCeOuhCqz60XZWL0A6o4S4zov54eehsXdxD1RmnXw9NNxh0aqiChqcphEbNCcMMFnnG2 8jHw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=mgsPSO4V; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 d9si4993059edn.570.2020.11.12.05.20.32; Thu, 12 Nov 2020 05:20:33 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-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=mgsPSO4V; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-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 S1728290AbgKLNUa (ORCPT + 8 others); Thu, 12 Nov 2020 08:20:30 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48390 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728298AbgKLNUO (ORCPT ); Thu, 12 Nov 2020 08:20:14 -0500 Received: from mail-wr1-x442.google.com (mail-wr1-x442.google.com [IPv6:2a00:1450:4864:20::442]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DAAD3C061A04 for ; Thu, 12 Nov 2020 05:20:12 -0800 (PST) Received: by mail-wr1-x442.google.com with SMTP id s8so5946288wrw.10 for ; Thu, 12 Nov 2020 05:20: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=8bT6NBr573z4dRmUGzdy7vOSo0LG9hQOBgI7J9L19n0=; b=mgsPSO4Vv1I0HLl+/EpK+bO64s6O30aHTiVXWSNkXtrWiKVu0TONIobdV8BewmbFoU gmKhJSfyHbxWuLsrWBbzord4ktUmXpF/JfK8W7GPrkQpwdmHOCV99d8/+u7G6rslcGi4 T7UW3lD2hbNoZmZOzUqmApvnILA+G/TnMnWP9S6Fb06hjZ+dXQJLn9aSiGrAPx5fGakG W8pK1mZW+Frwk+3qur8oKSxcbaZ9gHPuCo6A+OdWIrnZZab8C+2zIpftvjynOTmNKUNw JwbYgaKPc/iqYVbpiSRhuVSUKBDzj1++R3rOQjwnVHgJo4nJXLSIHVdqHdgJiPjH6K/o DZBw== 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=8bT6NBr573z4dRmUGzdy7vOSo0LG9hQOBgI7J9L19n0=; b=hSfjOzhbwrb9oQZYPUCu6M/psn1QEyVGfoPkz8FCypBlMjYshQ1YZnMrSxTU4FV1qN bHVEpyaXZtcbx+sWMUkG0L/UCjGf/hK/viN/9srac44X6Ixr+pJvsBmg9m5DWkbEcamO rasbJoJXsslBHSC4E1eWF8oWYYYdCNNIGP1ntyiyWsBvzNvBMoAnbOybW15W1fVOw71Q WOoEHTrlSW+vRxwskPm+YKTbRvs8Z6qAMwIqnF0QCY/0w4BjXUFomouTJl+dmgkdBSjI vvvL7yZvMV0b8GjoiX0V7jqNzRMJU5i7tAucKCJfZsWJfFOpjqVZ+mZlTOBluN6XDHod xYPA== X-Gm-Message-State: AOAM5305cSl8gWW6F5YuQhIAXf924VO2CHCeQecwEe+f9Z2utFF79cdS 3fta63qe8HPMw/aMdOyok31Ggg== X-Received: by 2002:adf:ebcb:: with SMTP id v11mr35129463wrn.408.1605187211647; Thu, 12 Nov 2020 05:20:11 -0800 (PST) Received: from dell.default ([91.110.221.159]) by smtp.gmail.com with ESMTPSA id t136sm2806326wmt.18.2020.11.12.05.20.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 05:20:11 -0800 (PST) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org, Lee Jones , Inaky Perez-Gonzalez , linux-wimax@intel.com, "David S. Miller" , Jakub Kicinski , Yanir Lubetkin , netdev@vger.kernel.org, devel@driverdev.osuosl.org Subject: [PATCH 6/6] staging: net: wimax: i2400m: fw: Fix incorrectly spelt function parameter in documentation Date: Thu, 12 Nov 2020 13:19:59 +0000 Message-Id: <20201112131959.2213841-7-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201112131959.2213841-1-lee.jones@linaro.org> References: <20201112131959.2213841-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wimax/i2400m/fw.c:647: warning: Function parameter or member '__chunk_len' not described in 'i2400m_download_chunk' drivers/net/wimax/i2400m/fw.c:647: warning: Excess function parameter 'chunk_len' description in 'i2400m_download_chunk' Cc: Greg Kroah-Hartman Cc: Inaky Perez-Gonzalez Cc: linux-wimax@intel.com Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Yanir Lubetkin Cc: netdev@vger.kernel.org Cc: devel@driverdev.osuosl.org Signed-off-by: Lee Jones --- drivers/staging/wimax/i2400m/fw.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/staging/wimax/i2400m/fw.c b/drivers/staging/wimax/i2400m/fw.c index 9970857063374..edb5eba0898b0 100644 --- a/drivers/staging/wimax/i2400m/fw.c +++ b/drivers/staging/wimax/i2400m/fw.c @@ -636,7 +636,7 @@ ssize_t i2400m_bm_cmd(struct i2400m *i2400m, * * @i2400m: device descriptor * @chunk: the buffer to write - * @chunk_len: length of the buffer to write + * @__chunk_len: length of the buffer to write * @addr: address in the device memory space * @direct: bootrom write mode * @do_csum: should a checksum validation be performed