From nobody Wed Jul 1 12:23:18 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 63F24C433F5 for ; Wed, 22 Dec 2021 03:10:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S242045AbhLVDKc (ORCPT ); Tue, 21 Dec 2021 22:10:32 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50152 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229741AbhLVDKb (ORCPT ); Tue, 21 Dec 2021 22:10:31 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:e::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9993BC061574 for ; Tue, 21 Dec 2021 19:10:31 -0800 (PST) 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:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=/N//Hl0MQgQVCERPieC+DOnf7Id6IS5f33LhshO2Vi4=; b=MtjtpfFQ9n5RIgdVg9cWbV4fND 0RirIVTXeIOKjfrGLGuhRUUbt5tqeyg05umhUgw+6/pM5XompMxkZLyUlIB8ZJLh8dufZv5YjPxEE WZmEvWndsxYDG3R5Z1tPXBxUMwXtxIv1YzNNpc0nYE8123AFgSv6FwA2mIpO4glClQsMMkMQbJBI6 KQjUkXeXdZpc2IptN9y97puyyWHvC5l/8xXIV/7xjfNDYOdkUKsPU7mG8Jrl+CIwsizP5GGQ2v2SO jkI7fnq1PsI4TcArWYfHl6e1A7PmLTkfkWFrxLGRJUGJAYS9XnWgY3prxX0Apg5EESzjX54nRTk2H iA4GMcjw==; Received: from [2601:1c0:6280:3f0::aa0b] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1mzs1N-0093r0-4h; Wed, 22 Dec 2021 03:10:29 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Alexander Viro , Richard Weinberger , Andrew Morton , "Eric W. Biederman" , Jens Axboe , Peter Zijlstra , Marco Elver , Thomas Gleixner Subject: [PATCH] signal: clean up kernel-doc comments Date: Tue, 21 Dec 2021 19:10:27 -0800 Message-Id: <20211222031027.29694-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Fix kernel-doc warnings in kernel/signal.c: kernel/signal.c:1830: warning: Function parameter or member 'force_coredump= ' not described in 'force_sig_seccomp' kernel/signal.c:2873: warning: missing initial short description on line: * signal_delivered - Also add a closing parenthesis to the comments in signal_delivered(). Signed-off-by: Randy Dunlap Cc: Alexander Viro Cc: Richard Weinberger Cc: Andrew Morton Cc: "Eric W. Biederman" Cc: Jens Axboe Cc: Peter Zijlstra Cc: Marco Elver Cc: Thomas Gleixner --- kernel/signal.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) --- linux-next-20211221.orig/kernel/signal.c +++ linux-next-20211221/kernel/signal.c @@ -1823,6 +1823,7 @@ int force_sig_perf(void __user *addr, u3 * force_sig_seccomp - signals the task to allow in-process syscall emulat= ion * @syscall: syscall number to send to userland * @reason: filter-supplied reason code to send to userland (via si_errno) + * @force_coredump: true to trigger a coredump * * Forces a SIGSYS with a code of SYS_SECCOMP and related sigsys info. */ @@ -2870,13 +2871,13 @@ out: } =20 /** - * signal_delivered -=20 + * signal_delivered - called after signal delivery to update blocked signa= ls * @ksig: kernel signal struct * @stepping: nonzero if debugger single-step or block-step in use * * This function should be called when a signal has successfully been * delivered. It updates the blocked signals accordingly (@ksig->ka.sa.sa_= mask - * is always blocked, and the signal itself is blocked unless %SA_NODEFER + * is always blocked), and the signal itself is blocked unless %SA_NODEFER * is set in @ksig->ka.sa.sa_flags. Tracing is notified. */ static void signal_delivered(struct ksignal *ksig, int stepping)