From patchwork Mon Dec 11 22:56:51 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 121471 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp3387647qgn; Mon, 11 Dec 2017 14:56:55 -0800 (PST) X-Google-Smtp-Source: ACJfBot2LEHkS6jLMv85si7ATBp5H/D/zgOgYHzeArIhPoGFAKaY0rFhURVbkCW1ZiPaleM5go+h X-Received: by 10.98.182.16 with SMTP id j16mr139661pff.47.1513033015336; Mon, 11 Dec 2017 14:56:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1513033015; cv=none; d=google.com; s=arc-20160816; b=S/JQpL8xZF7smx5U94Q6TqmOO1oOBmcA7ds3Ge+PrTyBK6pdzPtqybanXmL9sX2K2w zCxp+ZgzLhGnSj75lV/8pOEyUg+kHcPY3heOE7xhzqNQ5pZX/p4hzGtShODMty/CEHq0 2+vNHMchVGhysPs9spPs+5VXdf189+d7HpLEU1x3Pi+ScRuj7BGP0rtNwsr6BVyS/SlW nuPtl/CszhFlndx+TSSpzr+pNMYt/emg3thggocJmDl8zjRKHB53YVTQOAH54AkQay2w 14g7dDSY+yZ5WE+nne8394+aCFR6095f4jmna1Op6SFrXWfS69UZ88Vp/s+3iM1uH4b8 xcEg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:message-id:subject:cc:to:from:date :arc-authentication-results; bh=Mk3BF+DW1Abjz3WiK5QV27l5TT0170TyotWJ6nofMok=; b=o4vMdmamkVpG6qklHXYNwxJqL4Bfrv9uQ1py92GTgM86EIOo9RTyK2uYKAaQLbGvMD 6l1YA4Pl/1YCap8omBCyoL/iVBSs/D3pmAk0s7ciDI3QBKFosVbv6zbEhKVaxU+OpFdM J8u4Jc4H94UVKBqht6H9F+nFC+QHnpJw9KD4gqKBu9HvGS51pKdqlofw/shUbbeP1zxW T/ufKQ/A/zrRccLzmnnncudau1HFWBIlxvd0sm/2vghVTBB463c4fgW87AXbO8o/QjiX VkYWIIrKFMC7iguZbFSpbQjMOp2sFUcwmCN6topsXnvtFOUeb8slm0Zf2QOFNdcw+VnA X5ww== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id j16si9978657pli.331.2017.12.11.14.56.54; Mon, 11 Dec 2017 14:56:55 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752447AbdLKW4y (ORCPT + 18 others); Mon, 11 Dec 2017 17:56:54 -0500 Received: from ms.lwn.net ([45.79.88.28]:56026 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751612AbdLKW4w (ORCPT ); Mon, 11 Dec 2017 17:56:52 -0500 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 04A5F2E7; Mon, 11 Dec 2017 22:56:51 +0000 (UTC) Date: Mon, 11 Dec 2017 15:56:51 -0700 From: Jonathan Corbet To: Ingo Molnar , Peter Zijlstra Cc: LKML , Al Viro Subject: sched: Update kerneldoc for sched_rr_get_interval() Message-ID: <20171211155651.7b098034@lwn.net> Organization: LWN.net MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit abca5fc535a3e ("sched_rr_get_interval(): move compat to native, get rid of set_fs()") changed the prototype of that function but left the kerneldoc comments unchanged, leading to these docs-build warnings: ./kernel/sched/core.c:5113: warning: No description found for parameter 't' ./kernel/sched/core.c:5113: warning: Excess function parameter 'interval' description in 'sched_rr_get_interval' Update the documentation (noting that it's not a user-space address anymore) and make the docs build a little quieter. Signed-off-by: Jonathan Corbet --- kernel/sched/core.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.14.3 diff --git a/kernel/sched/core.c b/kernel/sched/core.c index 75554f366fd3..a6e9edb55333 100644 --- a/kernel/sched/core.c +++ b/kernel/sched/core.c @@ -5100,12 +5100,12 @@ SYSCALL_DEFINE1(sched_get_priority_min, int, policy) /** * sys_sched_rr_get_interval - return the default timeslice of a process. * @pid: pid of the process. - * @interval: userspace pointer to the timeslice value. + * @t: pointer to the timeslice value. * * this syscall writes the default timeslice value of a given process - * into the user-space timespec buffer. A value of '0' means infinity. + * into the timespec64 buffer. A value of '0' means infinity. * - * Return: On success, 0 and the timeslice is in @interval. Otherwise, + * Return: On success, 0 and the timeslice is in @t. Otherwise, * an error code. */ static int sched_rr_get_interval(pid_t pid, struct timespec64 *t)