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 0131FC4828F for ; Sun, 4 Feb 2024 21:34:08 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 67A946B0071; Sun, 4 Feb 2024 16:34:08 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 62A5C6B0072; Sun, 4 Feb 2024 16:34:08 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 5197E6B0074; Sun, 4 Feb 2024 16:34:08 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 3F8BE6B0071 for ; Sun, 4 Feb 2024 16:34:08 -0500 (EST) Received: from smtpin20.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id D84A240466 for ; Sun, 4 Feb 2024 21:34:07 +0000 (UTC) X-FDA: 81755424534.20.7C4E962 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf05.hostedemail.com (Postfix) with ESMTP id F10EB100005 for ; Sun, 4 Feb 2024 21:34:05 +0000 (UTC) Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=kjlY18EM; spf=none (imf05.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1707082446; 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: in-reply-to:in-reply-to:references:references:dkim-signature; bh=oUPc0T9g01EBpJOFoKdeHugi9gR06zfpezwQo4Xu2qY=; b=T/+c/CUI9EJ8poR96xXKrZw8Ruo73dp8NpSH781gSHIQXhTvpaoDmUCBJX1pII+nYyn9es Nsu3fJfGdgj6WJangEAn1LcNC+sBieZRS6SRWRT7a3sx+A+Pg//eVNwVEBIL40pQHrAokn kh1Luj5iCS+qshI0cspmLHPO0hrIpOc= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1707082446; a=rsa-sha256; cv=none; b=wFArke9DlL+kCwBcIFPTHXOf3q8nxvDtgnrY5vgunCuzmalvQM/0NoPDg+5r4SSJOVpGP8 3sJflMqgESNyfgTNJfylFjCntPJPRaN0287duZWKl8+HjpXJWunxWsuxkxVZ601rVR1njA 0li07oRZ3M/hvjlW3ZPBli1qQX0kgTc= ARC-Authentication-Results: i=1; imf05.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=kjlY18EM; spf=none (imf05.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=oUPc0T9g01EBpJOFoKdeHugi9gR06zfpezwQo4Xu2qY=; b=kjlY18EMquQO4rPsntbj3dj6j9 N1MmlpTUgmNoPzoUvDd3yGgPhXrBQRJwzwP9CxdAQiv7He8LE68yVAwI0Ei7Njjzmr82gTLKKf8Pj OhHhUhmf64OYQIYOD9kQjgngDF2oZqlaFY9KIpl6FzJxtDqbkVND2v1/fSWqDSviYl0TAfWR7vr4+ MdfTEJIheGzRRQTlMu7dALld7MDz2YZvG5gf2oUm8746PYZm3GwxQfsR0z6xFR0QWxUPKUBPydhlN qhT+IXfYIR/q13gE/7DFyxuWDFTtEL4Twt6TiMLpUpn6hGz/oAXBB/WzDAjUs4QcoctYYWO0YXsGr q6jzPD5g==; Received: from willy by casper.infradead.org with local (Exim 4.97.1 #2 (Red Hat Linux)) id 1rWk7l-00000007dDv-24V5; Sun, 04 Feb 2024 21:34:01 +0000 Date: Sun, 4 Feb 2024 21:34:01 +0000 From: Matthew Wilcox To: Mike Rapoport Cc: lsf-pc@lists.linux-foundation.org, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, linux-block@vger.kernel.org, linux-ide@vger.kernel.org, linux-scsi@vger.kernel.org, linux-nvme@lists.infradead.org, bpf@vger.kernel.org Subject: Re: [LSF/MM/BPF TOPIC] Reclaiming & documenting page flags Message-ID: References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Rspamd-Queue-Id: F10EB100005 X-Rspam-User: X-Rspamd-Server: rspam11 X-Stat-Signature: et53e43em6xr685bsierg7cd71534wzg X-HE-Tag: 1707082445-742866 X-HE-Meta: U2FsdGVkX18YHi3mctscMvZQ5vl1zo9Sy2my7km5VOBjOXlErEkYVdBp4aIp8cJakIaBvGli1xqyt0tGNSX77IrnRzEFHEjk7SU8CQ27nNp5e/PWuWRHRwdWDLOVLIRLHvhH6xAh3cytYUZ676w2RnOH+IIFrtdy4SU3d/em/GlSoHdOISZMLOByeQwfJqj+fZ5waZtYZfbIgaTr1lRWvzTSeBkFwVoxiHzefbadHVtl0InH0qWLJFEUHphkdsTQ6asSKVQ4qaam1xaQbZrbn/xbZtkrEqfor1t3vT3sanT8ObcZDmjgqa9FGHnYoDfXk9Eu4Y2WUMUIgJ6lm6oGLiLkp1JCLINXIXE4aGvjnvlbQNmDnoC7sWaSHSLO+Jq7zihsIsaFW/gNvDS5mS5ERkIMOXKbldrO/tFegcTdhRjwv4ING32KAz5WHfj4u8E3piymfr0NHrcBEDUvoOTO8q/zVDZYeQ/CfwNHBAoQ/diH8tXFZABWJ3ua6Jkb45GHLVwLmCJTUHxp21EOdjaG43M29Vtsv9JTSpEwXsgpJSUwK67l/DixFE4Rsv3nu+J46XTRtejjXeRHoVeDBmt0QQTu9g2PmUB2oPgdD51k8lUesFs+FVM6l8ezkMksTijBZxsO6sccQQrC0CEO1+EBKUccUnXpReCJBInTs3zEwPdwIP9wvabQ623u3nS61GvPWgZGGZQIjYekJOcEieSdofnxgvo6xSCUdUp77boD52wuGZ8uEjX7vUBypRJQnffTq/ENOE7Dp4W0ow4bPVepYaQAtv5kBSqdsKGN9tjYX5GJBaf7S2zMyauunqaKXoSg0hluL3Rp450UoNBPIB6XzB3piRPlNdofIa0hg1lBNmaHkYSf3WFd67R7kJ5NlRusmIQ/xueLRlWaTNzBoV570FcdJ/34MfM1WaA6aBjad1ISn6L+hT3np9Pxrw2vPtc2srVZNG88BC4hdxuQ/13 eN2bqJiN uN5KUY96pGX7ib3oU6FnQpsPgMZv8Qgg3HBUT90KBKPbS9gHWCow+NO58OEoguvkMeFdXFC8XhX6ldNxWp/bGoWBjwcVITEE4zWHg+vWWyN4GMZ+chMESqB3M9VEziwGQ5U8elCzKbzTt57I= 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: List-Subscribe: List-Unsubscribe: On Sun, Feb 04, 2024 at 11:39:33AM +0100, Mike Rapoport wrote: > On Mon, Jan 29, 2024 at 04:32:03AM +0000, Matthew Wilcox wrote: > > Our documentation of the current page flags is ... not great. I think > > I can improve it for the page cache side of things; I understand the > > meanings of locked, writeback, uptodate, dirty, head, waiters, slab, > > mlocked, mappedtodisk, error, hwpoison, readahead, anon_exclusive, > > has_hwpoisoned, hugetlb and large_remappable. > > > > Where I'm a lot more shaky is the meaning of the more "real MM" flags, > > like active, referenced, lru, workingset, reserved, reclaim, swapbacked, > > unevictable, young, idle, swapcache, isolated, and reported. > > > > Perhaps we could have an MM session where we try to explain slowly and > > carefully to each other what all these flags actually mean, talk about > > what combinations of them make sense, how we might eliminate some of > > them to make more space in the flags word, and what all this looks like > > in a memdesc world. > > > > And maybe we can get some documentation written about it! Not trying > > to nerd snipe Jon into attending this session, but if he did ... > > I suspect Jon will be there anyway, but not sure he'd be willing to do the > writing :) > > I was going to propose the "mm docs" session again, but this one seems more > useful than talking yet again about how hard it is to get MM documentation > done. I'm doing my best to write documentation as I go. I think we're a bit better off than we were last year. Do we have scripts to tell us which public functions (ie EXPORT_SYMBOL and static inline functions in header files) have kernel-doc? And could we run them against kernels from, say, April 2023, 2022, 2021, 2020, 2019 (and in two months against April 2024) and see how we're doing in terms of percentage undocumented functions? There's also the problem of getting long-form documentation done. But I think that's a different problem from getting kernel-doc written. Looking at the 55 commits in the last year to Documentation/mm, we seems to be doing a pretty good job of keeping the documentation we have up to date. Just not a great job of adding new documentation.