From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.0 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 88F6EC4360C 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 2A1CA21835 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 2A1CA21835 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) Received: by kanga.kvack.org (Postfix, from userid 40) id 874248E0003; Tue, 8 Oct 2019 16:45:29 -0400 (EDT) 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-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-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-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit 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 --- 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) {