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 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id A8CB2C4332F for ; Sat, 19 Nov 2022 05:26:56 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id DB5756B0072; Sat, 19 Nov 2022 00:26:55 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id D3DF66B0073; Sat, 19 Nov 2022 00:26:55 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BE0176B0074; Sat, 19 Nov 2022 00:26:55 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id ABBDA6B0072 for ; Sat, 19 Nov 2022 00:26:55 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 77EA114027B for ; Sat, 19 Nov 2022 05:26:55 +0000 (UTC) X-FDA: 80149057590.18.EFA42F6 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) by imf15.hostedemail.com (Postfix) with ESMTP id 46EA9A0008 for ; Sat, 19 Nov 2022 05:26:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=Oyh1N77AUIR8biKDA4ZZW31e5gFvL6G7BfYmUpcFkYs=; b=T86BOnrA6k/isow+Gz6LM8HKrq RuS6bXLabOUjY+GE8XqjpUGtS0pcdI7qr2m1e9avhc3BlDGzBVD9HAmL49dYR/70R7nvAlp/Ax0nm iHzUIl1bCauWQ/4639Oz3TNFJiinEiIWvYKDP5oKF2V8Mh0XTT9SCgem1CJk4a1nRRrKfef92Hfc7 h3h631eiZ7TfnDPXYRpHjqaqcecnXxQdPxsDUFq2YbqTFocAAdy47F1kTaUDKNSlgguWl/iljTw+5 FI1T+c4SXpc/KC3FKrHixzKOWTW9NaNHzCpxSwwUn/46pLT/02HZMHb3lWpr9b0dDmbBlxey4hexp 810QqjPw==; Received: from [2601:1c2:d80:3110::a2e7] by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1owGNM-00BNov-Th; Sat, 19 Nov 2022 05:26:49 +0000 Message-ID: <87c11d37-50ab-2c81-c454-d085c1fdff52@infradead.org> Date: Fri, 18 Nov 2022 21:26:47 -0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.4.2 Subject: Re: Cannot parse struct or union error on mm-everything Content-Language: en-US To: Bagas Sanjaya , Linux Documentation , Linux Memory Management List , LKML , Linus Torvalds Cc: Andrew Morton , "Matthew Wilcox (Oracle)" , Vlastimil Babka , David Hildenbrand , Hugh Dickins , "Liam R. Howlett" , Peter Xu , Yu Zhao , Colin Cross , Arnd Bergmann , Pasha Tatashin References: From: Randy Dunlap In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1668835615; a=rsa-sha256; cv=none; b=F8KtnXqnaNW2oj4v6BzDNXl46GW2VtjMnv9PKTWv3tImZtS0ofE8f3WJIIXpm1Wcbv/VsB iCxke4DljJkmvOj+OmXLgMIecca94sh4JYX26EzS4K9w9cx1YDXkUhPs9i21dIS3lEpmL+ tYvhXEsRg/JrlzOG5jxeMkHP71TPtH4= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=infradead.org header.s=bombadil.20210309 header.b=T86BOnrA; dmarc=none; spf=none (imf15.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 198.137.202.133) smtp.mailfrom=rdunlap@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1668835615; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=Oyh1N77AUIR8biKDA4ZZW31e5gFvL6G7BfYmUpcFkYs=; b=3243UwVugUfh0nJTWfGYzs+mR/sJgyWK2ZnByK2S+y0IjPwlYxIUXyPVM6i5rFbSQoTaaR b8WTNj10u7q18FC4P/HId3OsfgCtxnfzuu57TSoGcTT6qOIKm09b+2XNnBH1bJzSqp9o+5 c/EKFHX1B7cgkzC1tscbr7nEbgxoXW0= Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=infradead.org header.s=bombadil.20210309 header.b=T86BOnrA; dmarc=none; spf=none (imf15.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 198.137.202.133) smtp.mailfrom=rdunlap@infradead.org X-Rspam-User: X-Stat-Signature: 45pp73wg3b6nz6iwdts83gpb3du3yop1 X-Rspamd-Queue-Id: 46EA9A0008 X-Rspamd-Server: rspam11 X-HE-Tag: 1668835613-566106 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: On 11/18/22 20:10, Bagas Sanjaya wrote: > Greetings, > > I found a new htmldocs warning on mm-everything: > > WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 2.4.4 -internal ./include/linux/mm_types.h' failed with return code 1 > > Checking the header with './scripts/kernel-doc -v -none > ./include/linux/mm_types.h', I got the full error: > > include/linux/mm_types.h:255: info: Scanning doc for struct encoded_page > include/linux/mm_types.h:268: error: Cannot parse struct or union! > include/linux/mm_types.h:287: info: Scanning doc for struct folio > include/linux/mm_types.h:917: info: Scanning doc for typedef vm_fault_t > include/linux/mm_types.h:924: info: Scanning doc for enum vm_fault_reason > include/linux/mm_types.h:1028: info: Scanning doc for enum fault_flag > 1 errors > > The culprit is encoded_page struct, which is null struct (nonexistent type) > with kernel-doc comments: > > /** > * struct encoded_page - a nonexistent type marking this pointer > * > * An 'encoded_page' pointer is a pointer to a regular 'struct page', but > * with the low bits of the pointer indicating extra context-dependent > * information. Not super-common, but happens in mmu_gather and mlock > * handling, and this acts as a type system check on that use. > * > * We only really have two guaranteed bits in general, although you could > * play with 'struct page' alignment (see CONFIG_HAVE_ALIGNED_STRUCT_PAGE) > * for more. > * > * Use the supplied helper functions to endcode/decode the pointer and bits. > */ > struct encoded_page; > > The struct is introduced by d57ab372568585 ("mm: introduce 'encoded' page > pointers with embedded extra bits"). https://lore.kernel.org/all/CAHk-=wiyYSrBiOKJEV3phOBDT7EMgdXCnDUrp57E8HGNT4SFdA@mail.gmail.com/ I guess that nobody has "fixed" it yet. -- ~Randy