From patchwork Thu Oct 12 02:48:39 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151664 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945409vqb; Wed, 11 Oct 2023 19:49:18 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHCODVtG138QWyTQZzn+apfdEuvuKrfZPZDJUJRI6wZIeZw9YghQDXeSW18P5yhpgZWb1rN X-Received: by 2002:a05:6830:6206:b0:6b9:d3bd:3985 with SMTP id cd6-20020a056830620600b006b9d3bd3985mr24015480otb.1.1697078958307; Wed, 11 Oct 2023 19:49:18 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078958; cv=none; d=google.com; s=arc-20160816; b=IPlM6FRCSl6eEH/oq2Y3dzthLdRUL0TZ/pqD8xdErIImRu1WM2jvmADiLAYdJry7Zn SIpbAqvQhpKYUgCJGZBGIP32nUaFprWVSz8KQ7kx/B4xIDHZ0pBfVhAE6/p5l2faq8Qi mNQy74cO8pcCoW8Mik2ep6dhU3213aAmRg3R0Tab03RxE8XxdQaY/21Qae6CFVXisJxH RJb8GnZ8aSNJ/PY35Baei1KHaOCmaG0CXtn24ESAmqfAl2IEwlHDdImfQtTbRNdgxOTh XdIo0uAs+/RLOwK5GI4wehQB/ZSJuUN9k2h63iqUxxxlpJgO4FwDVyjdFQLY82eLOdC7 HA1g== 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=Yb5CBcs4CyLblxAoti7+1MYNpg3eCp5q8/+sl9+Lqhw=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=iGu4MwHboaTSws9kHJlgaua+Qm7vlwH3gGNnOe/R6CQCR1AA659sOTXgy3TYB+gpP+ IlHtEo3R6f1taDG75OWbAsC6Vr0hVMLV2B99+05cQHyxLpjMsZ+mlJ2a8u5yxUxbLeou lHEb8GHjHgRwuo5+jK/s2bikkDWnz1TPv9hqapDw95h0RH9vP59jKo6WTfOybOIs/ArA 33LiAcBAPO0/87sMY3DzMq5zAjSQlcDBN3USVJ5ujMew8CRAUTY/pFKuRwfZX+oaCFjz iptr7oWMIvfKPFg9TZSB+J9S0pZ3nOpYRclHBWGUPUOq0g/nEUX95BqXNGbbYj+QXzfU 67ag== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=EDSm8e6o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from groat.vger.email (groat.vger.email. [2620:137:e000::3:5]) by mx.google.com with ESMTPS id f18-20020a056a001ad200b00687008df88dsi13683355pfv.52.2023.10.11.19.49.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:18 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) client-ip=2620:137:e000::3:5; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=EDSm8e6o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id A2C9F8022C6E; Wed, 11 Oct 2023 19:49:12 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234013AbjJLCtA (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56854 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233040AbjJLCsu (ORCPT ); Wed, 11 Oct 2023 22:48:50 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4DDD0A9 for ; Wed, 11 Oct 2023 19:48:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=Yb5CBcs4CyLblxAoti7+1MYNpg3eCp5q8/+sl9+Lqhw=; b=EDSm8e6oxKRUApFxXxfaQvvJeq Lnx6HKfFEw7W4pDYAr4zVdpWDiWrE4iiwsTOzzMvAOSPwC3t+DUi10/0iqgP8ofk+tsCOBQDHQG+X X09l3xja0ybA42HZW4mxcVPqOz6lGYR3H0rGtfdc2Ivojo9rI98qFJfgcp+bhIVmsnXp1NnsemvI0 mAmp6DiFi+KJH91yg1boarQGYzGxziBMt7LKhy414uljQpFOBbWvfGAzgkq2Xkr9T/ZsJr+wgfUq8 1thBPITJD59yGtbRCMR2B1NIHUWGfAzJo0z5TOYGKc5CcWW3sj7nmOWc9lLf0JgEjBHciOjppopOe I5gEWk2A==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkl-00HDiv-3C; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 1/7] misc: mei: hw.h: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:39 -0700 Message-ID: <20231012024845.29169-2-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:12 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516265877561136 X-GMAIL-MSGID: 1779516265877561136 Fix kernel-doc warnings in hw.h: hw.h:809: warning: missing initial short description on line: * struct hbm_client_dma_unmap_request hw.h:812: warning: contents before sections hw.h:825: warning: missing initial short description on line: * struct hbm_client_dma_response hw.h:828: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/hw.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff -- a/drivers/misc/mei/hw.h b/drivers/misc/mei/hw.h --- a/drivers/misc/mei/hw.h +++ b/drivers/misc/mei/hw.h @@ -806,8 +806,8 @@ struct hbm_client_dma_map_request { } __packed; /** - * struct hbm_client_dma_unmap_request - * client dma unmap request from the host to the firmware + * struct hbm_client_dma_unmap_request - client dma unmap request + * from the host to the firmware * * @hbm_cmd: bus message command header * @status: unmap status @@ -822,8 +822,8 @@ struct hbm_client_dma_unmap_request { } __packed; /** - * struct hbm_client_dma_response - * client dma unmap response from the firmware to the host + * struct hbm_client_dma_response - client dma unmap response + * from the firmware to the host * * @hbm_cmd: bus message command header * @status: command status From patchwork Thu Oct 12 02:48:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151663 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945384vqb; Wed, 11 Oct 2023 19:49:14 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFS/qPWm99SmFUPxYDd+XrMuOId4SNf9Ar6V4Cz0wloZmynPI3ehDYoTQFhXemAm2ut14ov X-Received: by 2002:a17:90a:4ca4:b0:274:99ed:a80c with SMTP id k33-20020a17090a4ca400b0027499eda80cmr20431041pjh.3.1697078954456; Wed, 11 Oct 2023 19:49:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078954; cv=none; d=google.com; s=arc-20160816; b=JiYX3q51e/15bz77DaMYeoOoO8oXSJtv8tKsV1x6kVABgB03eN+fm0EQbpR5Ym1Hgc Qk8AHSuSc8tCz+xipbV6BQazWEu3tk8NVSja0pMOV1DdMeqJGWJF3PluKp9EYBpqG+oK gNRvsqphYE3FHGlfCiKZP4TwpexOjc1dOfUy7T6rFLzY1HxmFqUfHxh8+J9i1LBj69wY 3OEHPQJpd8eBtstEbc29wZdHF3uFuBLf8C8vHO9Xz6FmkRAWLbOsTX4CK5+u8ZbM3IPd +jTz2fzgCfVaB33ueAQZoLLKx8WZfZVJ9rUlXkArWErij+f20AXO7DRI8IgFuuKOOjCY 4xZg== 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=9IY1frtEC2rYJqSMRCt/naGt/cJcR9rRktWt5Wfg+dM=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=nUdqz2tPUu/5ka5uSJtNKB7Xp2dzpKaIG2psSjfF3znrRWvickEiHLw4TUjzeSYzwn VZj04ou9HI8oik0VMciL8GP1hMLW9InqZmO4bHJngBlV0rRVTAmRX+K+o668DkOohua9 +lMhq47c0QBfb2n0U/8CezORmqliuv5Q/Ko0XhGNhl+Zfaxt1ZYjm2brapjKRE1WsoPQ zdmVwVPfqBkTukgiwanMnmBvmXwuJU6JmQvRXuY/tknGBhJwHbvTKgsAcBlQXBcehxnk VAN0xaFvhV3boNCMuhb7RnJi81QAdRvcCJQopo1mqLVTLAg5Gausz1/ze5Z50HUw+YB8 N3Mw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Kr5uISvk; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id w24-20020a17090aea1800b00274a22e6364si1158670pjy.92.2023.10.11.19.49.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:14 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Kr5uISvk; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id C4FB681E6EFC; Wed, 11 Oct 2023 19:49:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376865AbjJLCtF (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56868 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1345779AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6D85EB6 for ; Wed, 11 Oct 2023 19:48:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=9IY1frtEC2rYJqSMRCt/naGt/cJcR9rRktWt5Wfg+dM=; b=Kr5uISvkejibDfd4bv+oLqUKK6 uvWVOYjPFk/OGSGX5Me5KH+Lrk92yFZyirFVQwEw7Ee68oseHr4TveGT+5jrze0QLMlWusR/2ZU5g 6DeMHECOMbANJG/P5stZJ/zR4rTxJfeakkaU8GsWHlq7Eas0CBgrgCbgpuiIIXjV1RPi2uQC21MrX FdEcHwc5MAiuiwtVFY9Jq1f1B8I9+6Eq3cc23yMY3NgsCtF2D8jp7tDSUpohkgi9XUC/b42vRrzCh a18NDi3AvqaxmQUFsW7VmXIMi7bnmVS/r1h9raC8IH1PeIlb1xyjbuwY0Gval91TQlK3Flua3ZWzl rG38OASA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-0f; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 2/7] misc: mei: client.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:40 -0700 Message-ID: <20231012024845.29169-3-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516261352250971 X-GMAIL-MSGID: 1779516261352250971 Fix kernel-doc warnings in client.c: client.c:53: warning: contents before sections client.c:68: warning: contents before sections client.c:334: warning: contents before sections client.c:349: warning: contents before sections client.c:364: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/client.c | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff -- a/drivers/misc/mei/client.c b/drivers/misc/mei/client.c --- a/drivers/misc/mei/client.c +++ b/drivers/misc/mei/client.c @@ -48,9 +48,9 @@ struct mei_me_client *mei_me_cl_get(stru /** * mei_me_cl_release - free me client * - * Locking: called under "dev->device_lock" lock - * * @ref: me_client refcount + * + * Locking: called under "dev->device_lock" lock */ static void mei_me_cl_release(struct kref *ref) { @@ -63,9 +63,9 @@ static void mei_me_cl_release(struct kre /** * mei_me_cl_put - decrease me client refcount and free client if necessary * - * Locking: called under "dev->device_lock" lock - * * @me_cl: me client + * + * Locking: called under "dev->device_lock" lock */ void mei_me_cl_put(struct mei_me_client *me_cl) { @@ -329,10 +329,10 @@ void mei_io_cb_free(struct mei_cl_cb *cb /** * mei_tx_cb_enqueue - queue tx callback * - * Locking: called under "dev->device_lock" lock - * * @cb: mei callback struct * @head: an instance of list to queue on + * + * Locking: called under "dev->device_lock" lock */ static inline void mei_tx_cb_enqueue(struct mei_cl_cb *cb, struct list_head *head) @@ -344,9 +344,9 @@ static inline void mei_tx_cb_enqueue(str /** * mei_tx_cb_dequeue - dequeue tx callback * - * Locking: called under "dev->device_lock" lock - * * @cb: mei callback struct to dequeue and free + * + * Locking: called under "dev->device_lock" lock */ static inline void mei_tx_cb_dequeue(struct mei_cl_cb *cb) { @@ -359,10 +359,10 @@ static inline void mei_tx_cb_dequeue(str /** * mei_cl_set_read_by_fp - set pending_read flag to vtag struct for given fp * - * Locking: called under "dev->device_lock" lock - * * @cl: mei client * @fp: pointer to file structure + * + * Locking: called under "dev->device_lock" lock */ static void mei_cl_set_read_by_fp(const struct mei_cl *cl, const struct file *fp) From patchwork Thu Oct 12 02:48:41 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151661 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945349vqb; Wed, 11 Oct 2023 19:49:06 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEzzighpLopVhjbUZlg8U1nlt7rtkH5dufLQTnox6LQwYMdMVqfjXVa6qwv3QODZboavzo0 X-Received: by 2002:a05:6e02:60a:b0:34f:7ba2:50e8 with SMTP id t10-20020a056e02060a00b0034f7ba250e8mr22634762ils.2.1697078945751; Wed, 11 Oct 2023 19:49:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078945; cv=none; d=google.com; s=arc-20160816; b=h+VmKv/hwz96Hp1BP2oJkqhs49f52dxRgkqYmYB0DVjdN4/OCEdzuC9KXDvHYZVTz+ I15ALmMlIhGgnYja5aXBuk6Nklv25RK5sQGqKDPfQ4Zm+dCCXpC+cG7br7/zmyWfHBQ3 QQU8Of2dPAmyH8tINt9/1XsXmppgIsTThKYDPZBNG/PLaJG3c3Hpc1dC4EiPhY9rBMuy iiJpiWz1DidlOw2Vtzo3xWWQP15CnZeXaISSpYck5dgK8Dfwfz9IZY9mpsi9UER49Icm 99X8xp3xP9VXKQFE1nrOgaNewQElqizkDmBc4g8LDqidmIZ9TRLSbUTqQFnol/9xAINt O2gA== 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=qmlUn/f3e8UXJAuEhnJXHHHbWqPpc8bMN+0dzccnErM=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=MMaUtko6/PhH7M46nlYa4nDaBm/X9PCoYslH+9TFadkJ8cJQ75XVX0k7XWdPYUZJTK OW0yBA+Tkbem9y4+qxsDLpOJ0pwdHzWEhQKrtODACA3sOFoDH+A+iWuljOnPiKSMBlck gdJQelxKVB8oSQsyyLcvRwJadWSQq9PezwL6t0y0ZrrPypcXwGkpNFbRMgwF0ZUENSGA ZVYUqqWw+vCuRAUuD0KqauCnO/fPZv5OuMPbpVAy/iA+01+uMA0u277ESX0jP/Mj1PhN kgMjSrP+KL5DZmpJJBQI64HgiQKBsgetBv4vMKHSzKbia7zZI8ktvFs8YOAXHuAl1Y7L f3aA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=zm2Mwrc3; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id d33-20020a631d21000000b00578d7a3a4fdsi1112112pgd.563.2023.10.11.19.49.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:05 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=zm2Mwrc3; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 09A6F81B75F8; Wed, 11 Oct 2023 19:49:05 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376757AbjJLCtB (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56874 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347029AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 91416B7 for ; Wed, 11 Oct 2023 19:48:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=qmlUn/f3e8UXJAuEhnJXHHHbWqPpc8bMN+0dzccnErM=; b=zm2Mwrc3+RHACLCl5aF1CcKVuy zxSSPNlWJsGir9wRV11lZIJ+qZNSa3YbrXZFZKohDTgYLDaAF9XPeSqeDIAfUqShsY2aYsXAayxJZ QHDGxRVve4iQIhvgGy3O+NMVS4TgPAwKHGRnhaN/sg88VAM70/ZExBlcTIA70jQJphYXpxhohVfDE 3S8JrrfMycCxA2+Zrg0Z996KFxwyowlrLc1pRiBA2rD+WWFzj8G+smrOeMxGR9rJIvA382DPaAykk d7fGeC/A+oS5tTmr64UJs081pBY9WQ6H/BeJ0CWbZsY9WumEHmbQKbdcwQrvqzSVATcjJj60gPUnK IS3Ouqsg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-1K; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 3/7] misc: mei: dma-ring.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:41 -0700 Message-ID: <20231012024845.29169-4-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:05 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516252608108065 X-GMAIL-MSGID: 1779516252608108065 Fix kernel-doc warnings in dma-ring.c: dma-ring.c:130: warning: No description found for return value of 'mei_dma_copy_from' dma-ring.c:150: warning: No description found for return value of 'mei_dma_copy_to' Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/dma-ring.c | 4 ++++ 1 file changed, 4 insertions(+) diff -- a/drivers/misc/mei/dma-ring.c b/drivers/misc/mei/dma-ring.c --- a/drivers/misc/mei/dma-ring.c +++ b/drivers/misc/mei/dma-ring.c @@ -124,6 +124,8 @@ void mei_dma_ring_reset(struct mei_devic * @buf: data buffer * @offset: offset in slots. * @n: number of slots to copy. + * + * Return: number of bytes copied */ static size_t mei_dma_copy_from(struct mei_device *dev, unsigned char *buf, u32 offset, u32 n) @@ -144,6 +146,8 @@ static size_t mei_dma_copy_from(struct m * @buf: data buffer * @offset: offset in slots. * @n: number of slots to copy. + * + * Return: number of bytes copied */ static size_t mei_dma_copy_to(struct mei_device *dev, unsigned char *buf, u32 offset, u32 n) From patchwork Thu Oct 12 02:48:42 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151665 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945415vqb; Wed, 11 Oct 2023 19:49:20 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFENozAvNIIzT98E2+IHD8n8dBl8QG7a55CKWn6W87p8XhT7oT2KlxOskU6XoRcpFpz/Fbe X-Received: by 2002:a4a:c509:0:b0:57e:c9bf:696e with SMTP id i9-20020a4ac509000000b0057ec9bf696emr21990942ooq.1.1697078959790; Wed, 11 Oct 2023 19:49:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078959; cv=none; d=google.com; s=arc-20160816; b=FbRaokD66xB0emLvzs33k0OPJvi1/74TZNnQWy7mAsS/LHAriggOJA45xMhpdThkko HfrI8J4Hq/WAlCqdDwP6aQcscxuai93Zbi9Y6G390hub/T2E9ZF8reNarCMGmjOubrp5 K6epIOqxbFMv+WJZlO16YOiJwKs0XAgJzhH3VZs/k5IxKDGy+NYpqSuseUWSb0mmm7gc 1NFCtUgyPFGSm1TSlhoaUivTOrVMCTwTzwpLwjifNYk3f97ZWPwfYvpVa//Z3IengmfS tGBaJpdzTozoA+QO/DZijWXRq/VrpxphcV16hmBbkmFBC0g/vLo3uj73KrIcMoBuo05Z O1Vg== 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=dn2C8Cozz71rqs8hddppMfXGl+lEpmcUyGJqY+sycQI=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=Xxxuq7QtcMwATz6qAaZC55oEU2LDbfvQjV2RxmFKXWnyn2acfPWtI/sYb5VzPXz7V9 rQNzR8desIIL3LuMLCWYY8in8LScgi3/OxUjADVBcILpDwXvJxBGQgkfAHxW8LSImesq DuccFtbLkPpsAivblEekxcSNIW5iXkowPVwwi/pYun5MmOx6lDHgUWonnccZ9g+kaFGP iga3teXv9wyXuSl9IWp2hU6lor0JRbEEvOlNmE371RzoQ4e7WZgW0+k4h7jEVi+d/Uxf OJTIUMX3c9lBa+d5VrGwhVss1d9yMY+fmErnXx81gJibpCqfvHJHW7+1bQzKNnPWpuVO mDUg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=QbqT7uTe; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id 32-20020a630a20000000b0057d08dac754si1112383pgk.671.2023.10.11.19.49.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:19 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=QbqT7uTe; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 35B0D8206D49; Wed, 11 Oct 2023 19:49:19 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376897AbjJLCtJ (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56876 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347031AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BFAF6B8 for ; Wed, 11 Oct 2023 19:48:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=dn2C8Cozz71rqs8hddppMfXGl+lEpmcUyGJqY+sycQI=; b=QbqT7uTe+dPHV0Gc8HjekXUwO+ bDNqag6u+9GjHNEkxuLv4+j8oTQSj95QeU66ghLTOu7HcwvFCenT2uAp8Lf1X6D9IF1MyskYAj1l5 Fn6hc3iK9rvM76LBGwk9KXOj1TeMN4YzP9+JO+P2xTKnGwznl9t5egRIzYcIjxE/hoENnB3WSN4/c e1EGgUjayliAYviLavQhebu7B5nl5odvNuquLjHWJlQD3RhHUDAFDzgvqFAxRwGIviSBjR/8AgVfe vB6UWitbRXt4wDUQa4gd9bTw1PU7OwEBrNKI5U75Zx2VsWoBoWUJtL45C4ZhIU2U1QOnFaFmvQ3fl y6ypWP2w==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-1z; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 4/7] misc: mei: hbm.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:42 -0700 Message-ID: <20231012024845.29169-5-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:19 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516267516234366 X-GMAIL-MSGID: 1779516267516234366 Fix kernel-doc warnings in hbm.c: hbm.c:98: warning: No description found for return value of 'mei_hbm_write_message' Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/hbm.c | 2 ++ 1 file changed, 2 insertions(+) diff -- a/drivers/misc/mei/hbm.c b/drivers/misc/mei/hbm.c --- a/drivers/misc/mei/hbm.c +++ b/drivers/misc/mei/hbm.c @@ -91,6 +91,8 @@ static int mei_cl_conn_status_to_errno(e * @dev: mei device * @hdr: mei header * @data: payload + * + * Return: >=0 on success, <0 on error */ static inline int mei_hbm_write_message(struct mei_device *dev, struct mei_msg_hdr *hdr, From patchwork Thu Oct 12 02:48:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151672 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945821vqb; Wed, 11 Oct 2023 19:50:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IF4qttDJaP9gT+2ix9lKfPAgv4WP39cuOi3+cYbvpMGJ8sTQGEuyg1ZD6RsZXMNgWy+E8nC X-Received: by 2002:a05:6358:cc28:b0:143:92d5:1fdb with SMTP id gx40-20020a056358cc2800b0014392d51fdbmr20544093rwb.0.1697079047705; Wed, 11 Oct 2023 19:50:47 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697079047; cv=none; d=google.com; s=arc-20160816; b=lPYiMI1pV1WHaSsIcH7FI7T+XnseD76wCt1dXsCT3h/N1tk3LBUwJVBs9bOhWpjyil MJyXT5I7LFmNrmggljpEe7IMd+NA0dydkfD6K9eph4IOFZ4k64kFSBA561tV0loTggSe h8TCgpMK7Ac7W+Xzc+jD+ligXjaX4+e1XvKdXMGDKrdo69IDy0fhx3HSpeQ5bOE4D8st ky0CjApexlV3LYGoviYWvhWAEXH1ore1nO0Ewo6htxPN1qS1XENSqO/KLmr8QlEryNJf sGNrk88mhunT6GL7EMhD/vaw70IFpE4Fky/WrlQk3IIdL4/sUFCIcs+cgxe1xfIIKptC Wq9w== 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=Dn9zCcvrcxqpmwWd8vgmyiOH+lNjJ7UYM9Um5cJkFUc=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=ip6q44BV1kZ03ANxxNnMfjbUa0wl9P27Bi5xTDvMzu9D+LwETfBq+85d2TykJoTy12 uiPepCcZj2LitMbdntI6x3bsl4U6b1G2K6/2yTmOBa7az/DxqOLm7yBwweq4iWKDD6wT VQmf8cC4qZ1A/Tum+Ko269lFVj/O/QpYRIpNyJksQgpwfcBjwzoq/0QvUu6/8B8kdOQ9 hr1IJUdizAQwLG7scJG7AvPtt/Npw+Uf/zNgvJ8kISvEkSE5YdrO8EcwjWXOoBpxj5My OJj7Kwotqn9Q8kGfAEDA/hhTIqWvfpAWNPGf3JGPuY3lsib7qysDgOoJGRa1EquRKlwJ 0h0A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Dmc1dCSA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id cf5-20020a056a02084500b005a0110eb91dsi1123977pgb.560.2023.10.11.19.50.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:50:47 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Dmc1dCSA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id D828D8086503; Wed, 11 Oct 2023 19:50:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376873AbjJLCtH (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56878 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347034AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 01F76BA for ; Wed, 11 Oct 2023 19:48:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=Dn9zCcvrcxqpmwWd8vgmyiOH+lNjJ7UYM9Um5cJkFUc=; b=Dmc1dCSAj9y4yj18SrmRTBq5DX QyQgL9ZcjrfABJ2mJhXR55d7MjfpBZLI0Z9IYQ1EdineFmwnZrfJEgbqZ1JcUwnwTTNZdxG5zKzIp NC02PoJBvDRgnHl7cvLD6MBdFqh/KevDaw7n56YS/gKJhDHceEANfRdhwQICGmP+rbWqA7QW/zMdk jlOCXF6JBqXseT7ocQR2CphbizutlWw4aOU6hEqtkgm2LfKzY+EuuNp4LSONnzhQ85otJ31w1q7ci OZj/mXKC3HGP2K1RbdyaxJjfojrgX4f6dy9bcXwq8dMvH9EvI3d1bxQnJrHfHqILjf11WlQYdNV0V bqvmA6fw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-2e; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 5/7] misc: mei: hw-me.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:43 -0700 Message-ID: <20231012024845.29169-6-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:50:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516359467778508 X-GMAIL-MSGID: 1779516359467778508 Fix kernel-doc warnings in hw-me.c: hw-me.c:1391: warning: contents before sections hw-me.c:1475: warning: contents before sections hw-me.c:1501: warning: contents before sections hw-me.c:1525: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/hw-me.c | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff -- a/drivers/misc/mei/hw-me.c b/drivers/misc/mei/hw-me.c --- a/drivers/misc/mei/hw-me.c +++ b/drivers/misc/mei/hw-me.c @@ -1379,6 +1379,8 @@ EXPORT_SYMBOL_GPL(mei_me_irq_thread_hand /** * mei_me_polling_thread - interrupt register polling thread * + * @_dev: mei device + * * The thread monitors the interrupt source register and calls * mei_me_irq_thread_handler() to handle the firmware * input. @@ -1388,8 +1390,6 @@ EXPORT_SYMBOL_GPL(mei_me_irq_thread_hand * time increases yet again by MEI_POLLING_TIMEOUT_ACTIVE * up to MEI_POLLING_TIMEOUT_IDLE. * - * @_dev: mei device - * * Return: always 0 */ int mei_me_polling_thread(void *_dev) @@ -1468,12 +1468,12 @@ static const struct mei_hw_ops mei_me_hw /** * mei_me_fw_type_nm() - check for nm sku * + * @pdev: pci device + * * Read ME FW Status register to check for the Node Manager (NM) Firmware. * The NM FW is only signaled in PCI function 0. * __Note__: Deprecated by PCH8 and newer. * - * @pdev: pci device - * * Return: true in case of NM firmware */ static bool mei_me_fw_type_nm(const struct pci_dev *pdev) @@ -1494,12 +1494,12 @@ static bool mei_me_fw_type_nm(const stru /** * mei_me_fw_type_sps_4() - check for sps 4.0 sku * + * @pdev: pci device + * * Read ME FW Status register to check for SPS Firmware. * The SPS FW is only signaled in the PCI function 0. * __Note__: Deprecated by SPS 5.0 and newer. * - * @pdev: pci device - * * Return: true in case of SPS firmware */ static bool mei_me_fw_type_sps_4(const struct pci_dev *pdev) @@ -1519,11 +1519,11 @@ static bool mei_me_fw_type_sps_4(const s /** * mei_me_fw_type_sps_ign() - check for sps or ign sku * + * @pdev: pci device + * * Read ME FW Status register to check for SPS or IGN Firmware. * The SPS/IGN FW is only signaled in pci function 0 * - * @pdev: pci device - * * Return: true in case of SPS/IGN firmware */ static bool mei_me_fw_type_sps_ign(const struct pci_dev *pdev) From patchwork Thu Oct 12 02:48:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151662 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945380vqb; Wed, 11 Oct 2023 19:49:12 -0700 (PDT) X-Google-Smtp-Source: AGHT+IENUPbpvLsTw94RK4uM0P15uRKb8B+JM6OMRFBAizbnxdGYDcydJ8VX9DdIwdUP3R1rhZ6m X-Received: by 2002:a05:6358:f17:b0:14d:8792:1cec with SMTP id b23-20020a0563580f1700b0014d87921cecmr15148467rwj.1.1697078952204; Wed, 11 Oct 2023 19:49:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078952; cv=none; d=google.com; s=arc-20160816; b=Gp0C46xE2vxyyIzKKOt/W+PyutJthvkIyamcWyWisgx+q007HyNTqBvgzULFfDbKE8 XAGo9f6yr7T4eYvIQM1n8foBQoirWtjRaEuhx+t6m14MqXknHBVGmI5uctjByxD4sSy/ Kgu9pWtboN67GfhloJEDysTXq/2N3sI9c+hboV3+DIJlfshut08vs37tizhclHd8rf97 8TEDXSGi+L5s7ftli/TYNpLfX2tGstSAc1b45ePlQEP7NLkAS3wDe1un3+NDAHpA1zVo bXCjqGoq50oTc5vRcxigMtEvOjgqtOQtn7b3yFAq7Kn1aHfhHRfbbZp3hXPqV9qgdFqT rjcA== 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=6sy2vPKg2Ma8pUzKqIV8BjF+bvF2bXFYRLMo/bjz7+4=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=t0yBdfI/ctKjuYxcLqENXtFzSAyxG1noTD5WaaP+G6LXMsnrF/A3vXB+MMoy4mqFZN JhPw+WbcXWU/9iCjP1JQE/gWDCVWexsWGP3RhvVNV0XFg6C6IhZkdZJqCV4S5KJr8qM3 LCvSpTYLZwU1dAcWllMEcNHb0G/hJ6UGDVt4JQ8qVLRL9tdxd9RUc7igXkFjMPaWi+20 ZllxK4XDCKexP2jbaaEsFyQJ/u+zaZLBaRjXYGJhmDqggZfdaGqR2p9HEz9TBDUddToA U5Ww1JAAcSmCWE39IB0dFm9iPZTmW/4ZFlGHTQqKhRiAszE2rMrXTnS1PZyS1yovWuy9 nd1A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="cLzqD/ie"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id z16-20020a656650000000b00577f4d85fdbsi1074551pgv.548.2023.10.11.19.49.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:12 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="cLzqD/ie"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 9D39681E6EFC; Wed, 11 Oct 2023 19:49:11 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376849AbjJLCtD (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56882 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347036AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 34E6AC0 for ; Wed, 11 Oct 2023 19:48:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=6sy2vPKg2Ma8pUzKqIV8BjF+bvF2bXFYRLMo/bjz7+4=; b=cLzqD/ieDv7DNb5i0XJPJ3Icik 59cGe9IL7J1Lk8mZ6JdpAD0JychgwrkPg/UW+iQT8BXSTsvkqcKRR+CkZa86wz7dWY33rkjKDmFjC 776v+WO5eL7cW0ZIe4CpGupDyJN18+hTNTlint+q3OdwTxITp6oe6G31SpX1FWD2ardz3fYLiDp+i yhHuI93CRgnU+QxaiIiNWgGQM03zFdVenDhptPEVUxE7M01tc7botLsCMMbkfEEV2lSYzo+28ugUP paOawlrLJnszES5LCrkHruJ6d9gMF32bAd5wW8aePK5YIAbhmlw7c5V7R9xvd9P9fw4he1IKdhhlC OpMEm+6A==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkn-00HDiv-07; Thu, 12 Oct 2023 02:48:49 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 6/7] misc: mei: interrupt.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:44 -0700 Message-ID: <20231012024845.29169-7-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:11 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516259230821925 X-GMAIL-MSGID: 1779516259230821925 Fix kernel-doc warnings in interrupt.c: interrupt.c:631: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/interrupt.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/drivers/misc/mei/interrupt.c b/drivers/misc/mei/interrupt.c --- a/drivers/misc/mei/interrupt.c +++ b/drivers/misc/mei/interrupt.c @@ -626,9 +626,9 @@ static void mei_connect_timeout(struct m /** * mei_schedule_stall_timer - re-arm stall_timer work * - * Schedule stall timer - * * @dev: the device structure + * + * Schedule stall timer */ void mei_schedule_stall_timer(struct mei_device *dev) { From patchwork Thu Oct 12 02:48:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151670 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945534vqb; Wed, 11 Oct 2023 19:49:42 -0700 (PDT) X-Google-Smtp-Source: AGHT+IG56OTQGH+KmSJ19ls+VbMyNXep3kfOhNCi3juwoTd/IwzRh7hjrpywTy8sQkWWLGLjURny X-Received: by 2002:a05:6359:639d:b0:149:cbfd:c663 with SMTP id sg29-20020a056359639d00b00149cbfdc663mr18403811rwb.2.1697078982302; Wed, 11 Oct 2023 19:49:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078982; cv=none; d=google.com; s=arc-20160816; b=SN7DqB3ku4DQWxQyr9dF7LtoyS9l8qkWLHK4B7896msOmLjjWWdaO0a8k2SafB06TW POyZIFcm6lfk/cqO5OmOTsPlnPD2xQp8jMhzfjX6mufLEUXO1aJjgIfRW0ory2SF+Be+ zjbJitfovWSsBvf754umupL8NoDLIz22/ZdU2XQBLqP91iO71fP6fgZfNRDcBENvehvp q29a8nvkbiDJkhibpguHocNf9UkBOCsrwKp2dp6N//jbOzu4gaNE5bPmaKQHVaSsR38k 0V4NAp5RDZItLPsxqjXOdDV5Bo/+NQtgSKE+z2FQFmZy1RmAmmgFbSQ7nDl45i/7xjba SQ5Q== 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=oWmEAALGtzray4g5L/dvD0KU1ECIZ68qt/wD69rhLLk=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=hZ++WsAwhatlx/hiS0Clo4j1aLQSy7QgQUqGpEKMEWpq0dwrU0KgbYWZdqa1kH1jYd bSnvW5FALRspqhpaEocBqjNCo5pPnqh3ef+UARlwRNMMsbvlH35HNrqU7JNDUWMQsChu jxkHMRsI2Q7o/mSyvcBImkcmCDhQI0qUk+QuHnTF+TdeQ/zNR/7LblJAPgm6eqYKPdL4 gSILT7N3MQbYo8wgwhglkBGE23DMa+V2VkqqNteo11yHQhX9x+pMA3P74MEy5/Ty52l0 NjVfiHgfOaxRJiC4Tye9zAq5DShCAisyZeAOEnWeKa14MWSY+CGHDJhnwJDdTs6czsrT 5akw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=YmdNrae6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from fry.vger.email (fry.vger.email. [23.128.96.38]) by mx.google.com with ESMTPS id k4-20020a056a00134400b00690d695b113si14357804pfu.337.2023.10.11.19.49.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:42 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) client-ip=23.128.96.38; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=YmdNrae6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by fry.vger.email (Postfix) with ESMTP id 1FEF480A28DB; Wed, 11 Oct 2023 19:49:34 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at fry.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376785AbjJLCtO (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56894 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234092AbjJLCsw (ORCPT ); Wed, 11 Oct 2023 22:48:52 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 64AF2C4 for ; Wed, 11 Oct 2023 19:48:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=oWmEAALGtzray4g5L/dvD0KU1ECIZ68qt/wD69rhLLk=; b=YmdNrae678FNL0fp2me8DmbG8D atkGeY1TuzTciLC/M6riWdU7KxM64V0DjCe2SnesyF3hny4x6f2x93PP8p7LJbuOFtLfnrQUsWfPA rcCjtA9MXFZ3UMJ1pPcHsPNtgN7ZaRX7cLqPcqmvDoLgx0dE11CyM+sW6gu8Icm1cyv+HPYc3vyvs QsdJsWw3WSR/bhCItS2H1WnXGJ0fBQNXtJLPBt3WH+ujc5gEkXILVX44MRa2gjJ7VFVZ0l6Xl9Nc/ meCaC0tmx9ocILeRLvM+5SHrlFRKY7cjecQ35uA19N85NXshBaLq9nCokEBMKWStIm8oxgAzHVMu4 p+vcL2/Q==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkn-00HDiv-0n; Thu, 12 Oct 2023 02:48:49 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 7/7] misc: mei: main.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:45 -0700 Message-ID: <20231012024845.29169-8-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:34 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516290804088322 X-GMAIL-MSGID: 1779516290804088322 Fix kernel-doc warnings in main.c: main.c:465: warning: contents before sections main.c:590: warning: missing initial short description on line: * mei_ioctl_client_notify_request - Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/main.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff -- a/drivers/misc/mei/main.c b/drivers/misc/mei/main.c --- a/drivers/misc/mei/main.c +++ b/drivers/misc/mei/main.c @@ -460,11 +460,11 @@ end: /** * mei_vt_support_check - check if client support vtags * - * Locking: called under "dev->device_lock" lock - * * @dev: mei_device * @uuid: client UUID * + * Locking: called under "dev->device_lock" lock + * * Return: * 0 - supported * -ENOTTY - no such client @@ -587,8 +587,8 @@ static int mei_ioctl_connect_vtag(struct } /** - * mei_ioctl_client_notify_request - - * propagate event notification request to client + * mei_ioctl_client_notify_request - propagate event notification + * request to client * * @file: pointer to file structure * @request: 0 - disable, 1 - enable