Re: [mm PATCH v3 21/23] mm: Add support for releasing multiple instances of a page
From: Andrew Morton <akpm@linux-foundation.org>
Date: 2016-11-22 06:28:33
Also in:
linux-mm, lkml
From: Andrew Morton <akpm@linux-foundation.org>
Date: 2016-11-22 06:28:33
Also in:
linux-mm, lkml
On Mon, 21 Nov 2016 08:21:39 -0800 Alexander Duyck [off-list ref] wrote:
quoted
quoted
+ __free_pages_ok(page, order); + } +} +EXPORT_SYMBOL(__page_frag_drain);It's an exported-to-modules library function. It should be documented, please? The page-frag API is only partially documented, but that's no excuse.Okay. I assume you want the documentation as a follow-up patch since I received a notice that the patch was added to -mm?
Yes please. Or a replacement patch which I'll temporarily turn into a delta, either is fine.
If you would like I could look at doing a couple of renaming patches so that we make the API a bit more consistent. I could move the __alloc and __free to what you have suggested, and then take a look at trying to rename the refill/drain to be a bit more consistent in terms of what they are supposed to work on and how they are supposed to be used.
I think that would be better - it's hardly high-priority but a bit of attention to the documentation and naming conventions would help tidy things up. When you can't find anything else to do ;) -- To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to majordomo@kvack.org. For more info on Linux MM, see: http://www.linux-mm.org/ . Don't email: <a href=mailto:"dont@kvack.org"> email@kvack.org </a>