From patchwork Tue Oct 8 20:45:22 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 11180069 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id A352D13BD for ; Tue, 8 Oct 2019 20:45:30 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 661FC218AC for ; Tue, 8 Oct 2019 20:45:30 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="YyjipX9p" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 661FC218AC Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 8C33D8E0005; Tue, 8 Oct 2019 16:45:29 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 874248E0003; Tue, 8 Oct 2019 16:45:29 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 762178E0005; Tue, 8 Oct 2019 16:45:29 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0220.hostedemail.com [216.40.44.220]) by kanga.kvack.org (Postfix) with ESMTP id 4FA5D8E0003 for ; Tue, 8 Oct 2019 16:45:29 -0400 (EDT) Received: from smtpin11.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with SMTP id DFE8D181AC9B4 for ; Tue, 8 Oct 2019 20:45:28 +0000 (UTC) X-FDA: 76021797936.11.basin47_4cc35595fb810 X-Spam-Summary: 2,0,0,5bf2f9a792baca8e,d41d8cd98f00b204,rdunlap@infradead.org,::akpm@linux-foundation.org:elver@google.com,RULES_HIT:41:152:355:379:800:854:960:973:988:989:1260:1277:1311:1313:1314:1345:1431:1437:1515:1516:1518:1534:1541:1593:1594:1711:1730:1747:1777:1792:2194:2199:2393:2559:2562:3138:3139:3140:3141:3142:3352:3865:3866:3867:3868:3870:3871:4250:4321:5007:6119:6261:6653:7576:7875:7903:8603:10004:10400:11026:11658:11914:12043:12296:12297:12517:12519:12555:12679:12760:12986:13069:13311:13357:14096:14097:14181:14394:14721:21080:21451:21627:21972:30054,0,RBL:198.137.202.133:@infradead.org:.lbl8.mailshell.net-62.8.0.100 64.201.201.201,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not bulk,SPF:fn,MSBL:0,DNSBL:neutral,Custom_rules:0:0:0,LFtime:24,LUA_SUMMARY:none X-HE-Tag: basin47_4cc35595fb810 X-Filterd-Recvd-Size: 2774 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) by imf36.hostedemail.com (Postfix) with ESMTP for ; Tue, 8 Oct 2019 20:45:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Date:Message-ID:Subject:From:Cc:To:Sender:Reply-To: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=A84XUBUoEquRO9Rkj6aVKeCMG6+AadHnBTHwjsIcB8s=; b=YyjipX9pSYbZgQEmqZSsq9tM1 ZAgqdhCWAYY6hzi1KkZkRTp2X3rFO7WLNznSRDgXz6VMOtbTEXx+ZG5ikyKAz109e52fS+dUiXAma 0AAPmqp2xNY1iWK8w3YC5UKLZdKRC8lFhWnsXi/wWeql6U3CcZV/6xhA5aGcpMkya8/MwtYTLtYil lJnDPlD14XaQDj9jpBNBV/RoJ72Jeze5hLgAKDV2HPMnXKZNfH07W2CS5a7tPDtqsoxPrhk31tXOX ZVCXQMm8b/WM7hdqZRxojnRg+gxTSpzoFb1P1vXtvXFyh9afkLSxKubd74C0EqQ2VmwOE90jDU8YR Os+88z1Kw==; Received: from [2601:1c0:6280:3f0::9ef4] by bombadil.infradead.org with esmtpsa (Exim 4.92.2 #3 (Red Hat Linux)) id 1iHwME-00067k-Px; Tue, 08 Oct 2019 20:45:22 +0000 To: Linux MM , Andrew Morton Cc: Marco Elver From: Randy Dunlap Subject: [PATCH] mm: slab.c: fix kernel-doc warning for __ksize() Message-ID: <68c9fd7d-f09e-d376-e292-c7b2bdf1774d@infradead.org> Date: Tue, 8 Oct 2019 13:45:22 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.1.1 MIME-Version: 1.0 Content-Language: en-US X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Randy Dunlap Fix kernel-doc warning in mm/slab.c: ../mm/slab.c:4215: warning: Function parameter or member 'objp' not described in '__ksize' Also add Return: documentation section for this function. Fixes: 10d1f8cb3965 ("mm/slab: refactor common ksize KASAN logic into slab_common.c") Signed-off-by: Randy Dunlap Cc: Marco Elver Cc: Andrew Morton Acked-by: Marco Elver --- mm/slab.c | 3 +++ 1 file changed, 3 insertions(+) --- linux-next-20191008.orig/mm/slab.c +++ linux-next-20191008/mm/slab.c @@ -4207,9 +4207,12 @@ void __check_heap_object(const void *ptr /** * __ksize -- Uninstrumented ksize. + * @objp: pointer to the object * * Unlike ksize(), __ksize() is uninstrumented, and does not provide the same * safety checks as ksize() with KASAN instrumentation enabled. + * + * Return: size of the actual memory used by @objp in bytes */ size_t __ksize(const void *objp) {