Re: [PATCH v3 13/14] mm/gup: grab head page refcount once for group of subpages

2021-08-25 Thread Matthew Wilcox
On Wed, Aug 25, 2021 at 08:10:39PM +0100, Joao Martins wrote: > @@ -2273,8 +2273,7 @@ static int __gup_device_huge(unsigned long pfn, > unsigned long addr, > refs = record_subpages(page, addr, next, pages + *nr); > > SetPageReferenced(head); > - pinne

Re: [PATCH] Took care of some grammatical mistakes

2023-11-28 Thread Matthew Wilcox
On Mon, Nov 27, 2023 at 11:41:31AM -0800, Randy Dunlap wrote: > Hi, > > On 11/27/23 07:57, attreyee-muk wrote: > > Respected Maintainers, > > > > I have made some grammatical changes in the livepatch.rst file where I > > felt that the sentence would have sounded more correct and would have > >

Re: [PATCH 0/2] Minor grammatical fixup for livepatch docs

2023-11-29 Thread Matthew Wilcox
On Wed, Nov 29, 2023 at 07:29:35AM -0700, Jonathan Corbet wrote: > Bagas Sanjaya writes: > > > I was prompted to write this little grammar fix series when reading > > the fix from Attreyee [1], with review comments requesting changes > > to that fix. So here's my version of the fix, with reviews

Re: [PATCH 0/2] Minor grammatical fixup for livepatch docs

2023-11-29 Thread Matthew Wilcox
On Thu, Nov 30, 2023 at 06:58:16AM +0700, Bagas Sanjaya wrote: > I do this posting because I thought the OP (Attreyee) didn't respond in > timely manner (just like random Chinese contributors like @cdjrlc.com > and @208suo.com people). That's a ridiculous excuse. The original posting was two days

Re: [PATCH] Sounds better

2023-12-03 Thread Matthew Wilcox
On Sun, Dec 03, 2023 at 07:00:18PM +0530, attreyee-muk wrote: > Hence, sending this patch. Requesting the maintains to have a look at > it. In addition to Greg's comment, after you have made changes to an rst file, you have to try building the documents again (eg "make htmldocs"). I can see you'v

Re: [PATCH] tracefs/eventfs: Use root and instance inodes as default ownership

2024-01-04 Thread Matthew Wilcox
On Thu, Jan 04, 2024 at 10:05:44AM -0500, Steven Rostedt wrote: > > file_system_type: what filesystem instances belong to. Not quite the same > > thing as fs driver (one driver can provide several of those). Usually > > it's 1-to-1, but that's not required (e.g. NFS vs NFSv4, or ext[234], > > or

Re: [PATCH] tracefs/eventfs: Use root and instance inodes as default ownership

2024-01-04 Thread Matthew Wilcox
On Thu, Jan 04, 2024 at 02:15:17PM -0500, Steven Rostedt wrote: > On Thu, 4 Jan 2024 18:25:02 + > Al Viro wrote: > > > Unfortunately, the terms are clumsy as hell - POSIX ends up with > > "file descriptor" (for numbers) vs. "file description" (for IO > > channels), which is hard to distinguis

Re: [PATCH] Documentation: multiple .rst files: Fix grammar and more consistent formatting

2024-02-04 Thread Matthew Wilcox
On Sat, Feb 03, 2024 at 10:53:45PM +0100, Thorsten Blum wrote: > @@ -63,8 +63,7 @@ Image output > > > The kernel documentation build system contains an extension that > -handles images on both GraphViz and SVG formats (see > -:ref:`sphinx_kfigure`). > +handles images on both GraphV

Re: [RFC PATCH 16/20] famfs: Add fault counters

2024-02-23 Thread Matthew Wilcox
On Fri, Feb 23, 2024 at 03:50:33PM -0800, Dan Williams wrote: > Certainly something like that would have satisified this sanity test use > case. I will note that mm_account_fault() would need some help to figure > out the size of the page table entry that got installed. Maybe > extensions to vm_fau

Re: [PATCH v1 01/18] mm: allow for detecting underflows with page_mapcount() again

2024-04-09 Thread Matthew Wilcox
On Tue, Apr 09, 2024 at 09:22:44PM +0200, David Hildenbrand wrote: > Commit 53277bcf126d ("mm: support page_mapcount() on page_has_type() > pages") made it impossible to detect mapcount underflows by treating > any negative raw mapcount value as a mapcount of 0. Yes, but I don't think this is the

Re: [PATCH 2/2] mm: debug: print correct information for slab folios

2024-05-22 Thread Matthew Wilcox
On Wed, May 22, 2024 at 04:46:29PM +0900, Sukrit Bhatnagar wrote: > The function dump_page() prints "anon" even for slab pages. > This is not correct, especially now that struct slab is separated from > struct page, and that the slab pages cannot be mapped to userspace. > > [7.071985] page: re

Re: [PATCH 0/2] Improve dump_page() output for slab pages

2024-05-22 Thread Matthew Wilcox
On Wed, May 22, 2024 at 04:46:27PM +0900, Sukrit Bhatnagar wrote: > On the other hand, the struct slab has kmem_cache which maintains another set > of flags. It would be nice to have these flags added as a part of the debug > output, and to have a convenient way to print them. I don't understand w

Re: [PATCH 5/5] alloc_tag: config to store page allocation tag refs in page flags

2024-08-19 Thread Matthew Wilcox
On Mon, Aug 19, 2024 at 08:15:11AM -0700, Suren Baghdasaryan wrote: > @@ -91,7 +97,7 @@ > #endif > > #if ZONES_WIDTH + LRU_GEN_WIDTH + SECTIONS_WIDTH + NODES_WIDTH + \ > - KASAN_TAG_WIDTH + LAST_CPUPID_SHIFT <= BITS_PER_LONG - NR_PAGEFLAGS > + KASAN_TAG_WIDTH + ALLOC_TAG_REF_WIDTH + LAS

Re: [PATCH 5/5] alloc_tag: config to store page allocation tag refs in page flags

2024-08-19 Thread Matthew Wilcox
On Mon, Aug 19, 2024 at 01:39:16PM -0700, Suren Baghdasaryan wrote: > On Mon, Aug 19, 2024 at 12:34 PM Matthew Wilcox wrote: > > So if ALLOC_TAG_REF_WIDTH is big enough, it's going to force last_cpupid > > into struct page. > > Thanks for taking a look! > Yes, bu

Re: [PATCH v2 6/6] alloc_tag: config to store page allocation tag refs in page flags

2024-09-03 Thread Matthew Wilcox
On Tue, Sep 03, 2024 at 06:25:52PM -0700, John Hubbard wrote: > The more I read this story, the clearer it becomes that this should be > entirely done by the build system: set it, or don't set it, automatically. > > And if you can make it not even a kconfig item at all, that's probably even > bett

Re: [PATCH v2 6/6] alloc_tag: config to store page allocation tag refs in page flags

2024-09-04 Thread Matthew Wilcox
On Wed, Sep 04, 2024 at 09:18:01AM -0700, Suren Baghdasaryan wrote: > I'm not sure I understand your suggestion, Matthew. We allocate a > folio and need to store a reference to the tag associated with the > code that allocated that folio. We are not operating with ranges here. > Are you suggesting

Re: [PATCH 04/12] mm: Allow compound zone device pages

2024-09-09 Thread Matthew Wilcox
On Tue, Sep 10, 2024 at 02:14:29PM +1000, Alistair Popple wrote: > @@ -337,6 +341,7 @@ struct folio { > /* private: */ > }; > /* public: */ > + struct dev_pagemap *pgmap; Shouldn't that be indented by one more tab stop? And for ease of

Re: [PATCH 04/12] mm: Allow compound zone device pages

2024-09-10 Thread Matthew Wilcox
On Tue, Sep 10, 2024 at 04:57:41PM +1000, Alistair Popple wrote: > > Matthew Wilcox writes: > > > On Tue, Sep 10, 2024 at 02:14:29PM +1000, Alistair Popple wrote: > >> @@ -337,6 +341,7 @@ struct folio { > >>/* private: */ > >>

Re: [Linux-kernel-mentees] [PATCH] Doc : fs : move xfs.txt to admin-guide

2019-07-05 Thread Matthew Wilcox
On Fri, Jul 05, 2019 at 02:14:46PM +0100, Sheriff Esseson wrote: > As suggested by Matthew Wilcox, xfs.txt is primarily a guide on available > options when setting up an XFS. This makes it appropriate to be placed under > the admin-guide tree. > > Thus, move xfs.txt to admin-guide

Re: [Linux-kernel-mentees] [PATCH] Documentation: filesystems: Convert jfs.txt to reStructedText format.

2019-07-08 Thread Matthew Wilcox
On Sat, Jul 06, 2019 at 04:22:39PM -0700, Shobhit Kukreti wrote: > +++ b/Documentation/filesystems/index.rst > @@ -41,3 +41,4 @@ Documentation for individual filesystem types can be found > here. > :maxdepth: 2 > > binderfs.rst > + jfs This is the wrong place for this file. See earli

Re: [Linux-kernel-mentees] [PATCH] Doc : fs : move xfs.txt to admin-guide

2019-07-08 Thread Matthew Wilcox
On Fri, Jul 05, 2019 at 08:41:48PM +0100, Sheriff Esseson wrote: > On Fri, Jul 05, 2019 at 12:04:12PM -0700, Matthew Wilcox wrote: > > On Fri, Jul 05, 2019 at 02:14:46PM +0100, Sheriff Esseson wrote: > > > As suggested by Matthew Wilcox, xfs.txt is primarily a guide on available

Re: [linux-kernel-mentees] [PATCH v6] Doc : fs : convert xfs.txt to ReST

2019-07-09 Thread Matthew Wilcox
On Tue, Jul 09, 2019 at 01:48:59PM +0100, Sheriff Esseson wrote: > Convert xfs.txt to ReST, rename and fix broken references, consequently. > > Signed-off-by: Sheriff Esseson > --- > > Changes in v6: > - undo text reflow from v5. > - fix a typo. > - change indication of default

Re: [PATCH v8] Documentation: filesystem: Convert xfs.txt to ReST

2019-07-15 Thread Matthew Wilcox
On Sun, Jul 14, 2019 at 01:58:31PM +0100, Sheriff Esseson wrote: > Move xfs.txt to admin-guide, convert xfs.txt to ReST and broken references > > Signed-off-by: Sheriff Esseson Reviewed-by: Matthew Wilcox (Oracle)

Re: [RFC PATCH] string.h: Add stracpy/stracpy_pad (was: Re: [PATCH] checkpatch: Added warnings in favor of strscpy().)

2019-07-22 Thread Matthew Wilcox
On Mon, Jul 22, 2019 at 10:58:15AM -0700, Joe Perches wrote: > On Mon, 2019-07-22 at 10:43 -0700, Joe Perches wrote: > > On Mon, 2019-07-22 at 10:33 -0700, Kees Cook wrote: > > > On Thu, Jul 04, 2019 at 05:15:57PM -0700, Joe Perches wrote: > > > > On Thu, 2019-07-04 at 13:46 -0700, Joe Perches wrot

Re: [PATCH] idr: Document calling context for IDA APIs mustn't use locks

2019-07-30 Thread Matthew Wilcox
On Tue, Jul 30, 2019 at 02:07:52PM -0700, Stephen Boyd wrote: > The documentation for these functions indicates that callers don't need > to hold a lock while calling them, but that documentation is only in one > place under "IDA Usage". Let's state the same information on each IDA > function so th

Re: [PATCH] Documentation: virt: Fix broken reference to virt tree's index

2019-08-04 Thread Matthew Wilcox
On Sun, Aug 04, 2019 at 04:46:35PM +0100, Sheriff Esseson wrote: > Fix broken reference to virt/index.rst. > > Sequel to: 2f5947dfcaec ("Documentation: move Documentation/virtual to > Documentation/virt") 'Sequel to'? Do you mean 'Fixes'? > Reported-by: Sphinx Reported-by is used for people.

Re: [PATCH v3 -rcu] workqueue: Convert for_each_wq to use built-in list check

2019-08-15 Thread Matthew Wilcox
On Thu, Aug 15, 2019 at 10:18:42AM -0400, Joel Fernandes (Google) wrote: > list_for_each_entry_rcu now has support to check for RCU reader sections > as well as lock. Just use the support in it, instead of explicitly > checking in the caller. ... > #define assert_rcu_or_wq_mutex_or_pool_mutex(wq

Re: [PATCH] doc:lock: remove reference to clever use of read-write lock

2019-09-02 Thread Matthew Wilcox
On Mon, Sep 02, 2019 at 02:21:33PM -0600, Jonathan Corbet wrote: > On Mon, 02 Sep 2019 21:19:24 +0200 > Federico Vaga wrote: > > > > > I am not used to the mathematical English jargon. It make sense, but > > > > then > > > > I > > > > would replace it with "If and only if": for clarity. > > >

Re: [PATCH 0/6] Address issues with SPDX requirements and PEP-263

2019-09-08 Thread Matthew Wilcox
On Sat, Sep 07, 2019 at 11:17:22PM +0200, Thomas Gleixner wrote: > On Sat, 7 Sep 2019, Markus Heiser wrote: > > Am 07.09.19 um 20:04 schrieb Mauro Carvalho Chehab: > > > No idea. I would actually prefer to just remove the restriction, and let > > > the SPDX header to be anywhere inside the first co

Re: [PATCH 1/2] docs: remove :c:func: from genericirq.rst

2019-10-04 Thread Matthew Wilcox
On Fri, Oct 04, 2019 at 10:39:54AM -0600, Jonathan Corbet wrote: > To make the transition to the new model easier and prevent the breakage > -of existing implementations, the :c:func:`__do_IRQ` super-handler is still > +of existing implementations, the __do_IRQ() super-handler is still > availabl

Re: [PATCH] docs/core-api: memory-allocation: fix typo

2019-10-20 Thread Matthew Wilcox
On Mon, Oct 21, 2019 at 01:38:32PM +1300, Chris Packham wrote: > "on the safe size" should be "on the safe side". > > Signed-off-by: Chris Packham Yes, it should. Acked-by: Matthew Wilcox (Oracle) If you like, you could do a follow-up patch mentioning the use

Re: [PATCH] kernel-doc: trivial improvement for warning message

2019-10-21 Thread Matthew Wilcox
On Sun, Oct 20, 2019 at 09:23:23PM +0800, Changbin Du wrote: > The message "Function parameter or member ..." looks weird. > > Signed-off-by: Changbin Du > --- > scripts/kernel-doc | 9 +++-- > 1 file changed, 7 insertions(+), 2 deletions(-) > > diff --git a/scripts/kernel-doc b/scripts/ker

Re: [PATCH] docs: add extra integer types to printk-formats

2019-03-05 Thread Matthew Wilcox
On Tue, Mar 05, 2019 at 11:59:30AM -0800, Joe Perches wrote: > Many of the -Wformat warnings are bogus too. > > There's nothing wrong with using %x for a unsigned int > of less than long size. (u8/u16) I believe you to be incorrect. 6.5.2.2 Function calls 7 If the expression that denotes the ca

Re: [PATCH] docs: add extra integer types to printk-formats

2019-03-05 Thread Matthew Wilcox
On Tue, Mar 05, 2019 at 12:07:25PM -0800, Matthew Wilcox wrote: > On Tue, Mar 05, 2019 at 11:59:30AM -0800, Joe Perches wrote: > > Many of the -Wformat warnings are bogus too. > > > > There's nothing wrong with using %x for a unsigned int > > of less than long size

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Matthew Wilcox
On Fri, Jun 28, 2019 at 10:43:02PM +0100, Sheriff Esseson wrote: > Convert xfs.txt to ReST, markup and rename accordingly. Update > Documentation/index.rst. Didn't get_maintainers.pl suggest that you cc the linux-xfs mailing list? You also need to update MAINTAINERS. > While at

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Matthew Wilcox
On Sat, Jun 29, 2019 at 02:25:08AM +0100, Sheriff Esseson wrote: > On Fri, Jun 28, 2019 at 10:43:24PM +0100, Sheriff Esseson wrote: > > Convert xfs.txt to ReST, markup and rename accordingly. Update > > Documentation/index.rst. Don't quote the entire previous patch when submitting a new on

Re: [linux-kernel-mentees] [PATCH v5] Doc : fs : convert xfs.txt to ReST

2019-07-02 Thread Matthew Wilcox
On Tue, Jul 02, 2019 at 01:30:40PM +0100, Sheriff Esseson wrote: > +When mounting an XFS filesystem, the following options are accepted. For > +boolean mount options, the names with the "(*)" prefix is the default > behaviour. > +For example, take a behaviour enabled by default to be a one (1) or

Re: [linux-kernel-mentees] [PATCH v5] Doc : fs : convert xfs.txt to ReST

2019-07-02 Thread Matthew Wilcox
On Tue, Jul 02, 2019 at 01:30:40PM +0100, Sheriff Esseson wrote: > +++ b/Documentation/filesystems/index.rst > @@ -40,4 +40,5 @@ Documentation for individual filesystem types can be found > here. > .. toctree:: > :maxdepth: 2 > > - binderfs.rst > + binderfs > + xfs I don't think this

Re: [PATCH v1 1/2] Documentation/filesystems: add binderfs

2019-07-02 Thread Matthew Wilcox
gt; You didn't add it to index.rst, so it won't actually become part of the > docs build. I think you added it in the wrong place. >From 8167b80c950834da09a9204b6236f238197c197b Mon Sep 17 00:00:00 2001 From: "Matthew Wilcox (Oracle)" Date: Tue, 2 Jul 2019 13:54:38 -0400 S

[PATCH] kernel-doc: Handle returning pointers to pointers

2017-01-23 Thread Matthew Wilcox
x27;*', not one-or-more. I have tried to fix that, but now I have perl regexes all over my hands, and I fear I shall never be clean again. Signed-off-by: Matthew Wilcox --- scripts/kernel-doc | 14 +++--- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/scripts/kernel-

RE: [PATCH] kernel-doc: Handle returning pointers to pointers

2017-01-23 Thread Matthew Wilcox
From: Markus Heiser [mailto:markus.hei...@darmarit.de] > Am 23.01.2017 um 09:18 schrieb Matthew Wilcox > : > Hi Matthew ! > > short answer: Thanks a lot > Acked-by: Markus Heiser Excellent! > to be more verbose: >what I have tested and what I recommend ... >

RE: [PATCH] kernel-doc: Handle returning pointers to pointers

2017-01-24 Thread Matthew Wilcox
From: Markus Heiser [mailto:markus.hei...@darmarit.de] > Am 23.01.2017 um 16:24 schrieb Jonathan Corbet : > > Markus, would you consider sending out a new patch set for review? > > Yes, I send RFC soon ... Could I ask for some features? I'd've been trying to add them to the perl script, but sin

Omitting documentation for internal structure members

2017-01-26 Thread Matthew Wilcox
Here's a little glitch that I'd like to see fixed: struct radix_tree_iter radix tree iterator state Definition struct radix_tree_iter { unsigned long index; unsigned long next_index; unsigned long tags; struct radix_tree_node * node; #ifdef CONFIG_RADIX_TREE_MULTIORDER unsigned int shift

RE: Omitting documentation for internal structure members

2017-01-26 Thread Matthew Wilcox
From: Jani Nikula [mailto:jani.nik...@linux.intel.com] > You can use /* private: */ within the struct to indicate the following > members should not be included in the generated documentation. It does > however mean you can't then document the members either, or you'll get > warnings. > > I'm gene

[PATCH] Add 'nodoc' option

2017-02-03 Thread Matthew Wilcox
g this new option. >From 26896bd43618e30cb3563114663ad6c39cef7dc6 Mon Sep 17 00:00:00 2001 From: Matthew Wilcox Date: Thu, 26 Jan 2017 11:43:24 -0500 Subject: [PATCH] kerneldoc: Add :nodoc: option This is functionality the perl script already has, we just need to expose it to our rst file

[PATCH] Improve sparse documentation

2017-02-13 Thread Matthew Wilcox
Add documentation of -DCONFIG_SPARSE_RCU_POINTER. I started to add documentation of -D__CHECK_ENDIAN__ as well, but discovered I'm too late; that's now enabled by default. Signed-off-by: Matthew Wilcox diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse

Re: [PATCH 2/4] fs/dcache: Report negative dentry number in dentry-state

2017-07-17 Thread Matthew Wilcox
On Mon, Jul 17, 2017 at 09:39:31AM -0400, Waiman Long wrote: > @@ -63,9 +63,10 @@ struct qstr { > struct dentry_stat_t { > long nr_dentry; > long nr_unused; > - long age_limit; /* age in seconds */ > - long want_pages; /* pages requested by system */ > - lo

Re: [PATCH 1/4] fs/dcache: Limit numbers of negative dentries

2017-07-17 Thread Matthew Wilcox
On Mon, Jul 17, 2017 at 09:39:30AM -0400, Waiman Long wrote: > The number of positive dentries is limited by the number of files > in the filesystems. The number of negative dentries, however, > has no limit other than the total amount of memory available in > the system. So a rogue application tha

Documentation license

2017-12-14 Thread Matthew Wilcox
I've written a couple of thousand words of documentation for the XArray. I need to decide how to license it. There are no SPDX tags in Documentation/ to date, so I have no examples to crib from. 1. How does one add an SPDX tag to an rst file? 2. What license should I use? I'd like people to be

[PATCH] Add errseq_t documentation to the tree

2017-12-22 Thread Matthew Wilcox
th per bit (the SF bit is still disproportionately large, but there's no way to fix that). Signed-off-by: Matthew Wilcox diff --git a/Documentation/core-api/index.rst b/Documentation/core-api/index.rst index eb16ba30aeb6..b8ec120c24f9 100644 --- a/Documentation/core-api/index.rst +++ b/Do

Re: [PATCH] Add errseq_t documentation to the tree

2017-12-22 Thread Matthew Wilcox
On Fri, Dec 22, 2017 at 08:29:34AM -0500, Jeff Layton wrote: > > +++ b/Documentation/core-api/index.rst > > @@ -22,6 +22,7 @@ Core utilities > > flexible-arrays > > librs > > genalloc > > + ../errseq > > > > Should we also move the file into core-api/ dir? I was wondering the same

[PATCH v2] errseq: Add to documentation tree

2017-12-22 Thread Matthew Wilcox
From: Matthew Wilcox - Move errseq.rst into core-api - Add errseq to the core-api index - Promote the header to a more prominent header type, otherwise we get three entries in the table of contents. - Reformat the table to look nicer and be a little more proportional in terms of

Re: [PATCH] Documentation: security/credentials.rst: explain need to sort group_list

2018-01-02 Thread Matthew Wilcox
On Wed, Jan 03, 2018 at 08:01:15AM +1100, NeilBrown wrote: > > +When replacing the group list, the new list must be sorted before it > +is added to the credential, as a binary search is used to test for > +membership. In practice, this means ``groups_sort()`` should be For a .rst file, shouldn'

Re: [PATCH] Documentation: security/credentials.rst: explain need to sort group_list

2018-01-06 Thread Matthew Wilcox
On Sat, Jan 06, 2018 at 11:09:08AM -0700, Jonathan Corbet wrote: > On Tue, 2 Jan 2018 13:04:31 -0800 > Matthew Wilcox wrote: > > > > +When replacing the group list, the new list must be sorted before it > > > +is added to the credential, as a binary search is used to

[PATCH] Documentation: Fix misconversion of #if

2018-01-16 Thread Matthew Wilcox
From: Matthew Wilcox At some stage of the conversion pipeline, something thought that the DocBook entity # should be rendered as NUM instead of #. Signed-off-by: Matthew Wilcox --- Documentation/kernel-hacking/hacking.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a

[PATCH] Mention kernel-doc Context section

2018-01-19 Thread Matthew Wilcox
From: Matthew Wilcox The scripts/kernel-doc processor mentions the ability to add arbitrary section names and suggests including a Context: section. We already have about 450 Context: sections in the kernel, so document it. We also have around 250 Locking: sections in the kernel ... these

[PATCH 0/6] Restructure kernel-doc.rst

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox Jon asked me to redo the Context: patch on top of his current docs tree. Unfortunately, I was on a plane at the time, so I started fixing some other small things, and before I knew it, I'd completely restructured the entire doc-guide/kernel-doc.rst file. Feel free t

[PATCH 4/6] Fix whitespace in example

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox Line up the second line in the way that the example purports to be showing. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation

[PATCH 6/6] Add a Style Guide section

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox Let's try to be consistent and copy each other's best practices. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 42 ++ 1 file changed, 42 insertions(+) diff --git a/Documentation/doc-guide/kernel-

[PATCH 2/6] Minor fixes to kernel-doc.rst

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox The author clearly meant to use the word 'which' here. Also replace some tabs with spaces which fixes the syntax highlighting in my editor. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 16 1 file changed, 8 insert

[PATCH 1/6] Add documentation for Context section

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox This section is mentioned in scripts/kernel-doc, so we should mention it in doc-guide/kernel-doc.rst. There are close to 500 comments using the Context section already, and almost 300 using a Locking section which fulfills much the same purpose (and should probably be

[PATCH 5/6] Restructure kernel-doc.rst

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox I found the layout confusing with multiple introductions to what kernel-doc is and how to use it. I made the following changes: - Moved the 'Including kernel-doc comments' section to the end of the document -- we should explain what it *is* before we explain

[PATCH 3/6] Add scripts/split-man.pl

2018-02-08 Thread Matthew Wilcox
From: Matthew Wilcox Instead of asking the user to copy and paste a small perl script from the documentation, just distribute the perl script in the scripts directory. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 30 ++ scripts/split

[PATCH v2 0/5] Restructure kernel-doc.rst

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox Jon asked me to redo the Context: patch on top of his current docs tree. Unfortunately, I was on a plane at the time, so I started fixing some other small things, and before I knew it, I'd completely restructured the entire doc-guide/kernel-doc.rst file. v2: Dropped

[PATCH v2 1/5] Add documentation for Context section

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox This section is mentioned in scripts/kernel-doc, so we should mention it in doc-guide/kernel-doc.rst. There are close to 500 comments using the Context section already, and almost 300 using a Locking section which fulfills much the same purpose (and should probably be

[PATCH v2 4/5] Fix whitespace in example

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox Line up the second line in the way that the example purports to be showing. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation

[PATCH v2 3/5] Add scripts/split-man.pl

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox Instead of asking the user to copy and paste a small perl script from the documentation, just distribute the perl script in the scripts directory. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 30 ++ scripts/split

[PATCH v2 5/5] Restructure kernel-doc.rst

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox I found the layout confusing with multiple introductions to what kernel-doc is and how to use it. I made the following changes: - Moved the 'Including kernel-doc comments' section to the end of the document -- we should explain what it *is* before we explain

[PATCH v2 2/5] Minor fixes to kernel-doc.rst

2018-02-13 Thread Matthew Wilcox
From: Matthew Wilcox The author clearly meant to use the word 'which' here. Also replace some tabs with spaces which fixes the syntax highlighting in my editor. Signed-off-by: Matthew Wilcox --- Documentation/doc-guide/kernel-doc.rst | 16 1 file changed, 8 insert

Re: [PATCH 0/6] Restructure kernel-doc.rst

2018-02-13 Thread Matthew Wilcox
On Tue, Feb 13, 2018 at 01:03:18PM -0800, Randy Dunlap wrote: > On 02/13/2018 12:59 PM, Jonathan Corbet wrote: > > I think this makes sense to do, but I really would like to see an intro > > comment on the split-man.pl script itself. Somebody wandering through > > the scripts directory should be a

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

2018-02-15 Thread Matthew Wilcox
On Thu, Feb 15, 2018 at 03:45:25PM +0100, Michal Hocko wrote: > > When the amount of kernel > > memory is well bounded for certain systems, it is better to aggressively > > reclaim from existing MIGRATE_UNMOVABLE pageblocks rather than eagerly > > fallback to others. > > > > We have additional

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

2018-02-15 Thread Matthew Wilcox
On Thu, Feb 15, 2018 at 09:49:00AM -0600, Christopher Lameter wrote: > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > > What if ... on startup, slab allocated a MAX_ORDER page for itself. > > It would then satisfy its own page allocation requests from this giant > > page.

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

2018-02-15 Thread Matthew Wilcox
On Thu, Feb 15, 2018 at 09:49:00AM -0600, Christopher Lameter wrote: > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > What if ... on startup, slab allocated a MAX_ORDER page for itself. > > It would then satisfy its own page allocation requests from this giant > > page. If w

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

2018-02-16 Thread Matthew Wilcox
On Fri, Feb 16, 2018 at 09:44:25AM -0600, Christopher Lameter wrote: > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > What I was proposing was an intermediate page allocator where slab would > > request 2MB for its own uses all at once, then allocate pages from that to > >

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

2018-02-16 Thread Matthew Wilcox
On Fri, Feb 16, 2018 at 10:08:28AM -0600, Christopher Lameter wrote: > On Fri, 16 Feb 2018, Matthew Wilcox wrote: > > I don't understand this response. I'm not suggesting mixing objects > > of different sizes within the same page. The vast majority of slabs > > use

Re: [PATCH] linux-next: SLIMbus: doc: Fix a warning "Title underline too short"

2018-02-19 Thread Matthew Wilcox
On Mon, Feb 19, 2018 at 10:55:50PM +0900, Masanari Iida wrote: > Driver and Controller APIs: > --- > +--- > .. kernel-doc:: include/linux/slimbus.h Is this the right fix? Shouldn't we rather delete the : instead? We don't normally have a colon at

Re: [PATCH] doc-guide: kernel-doc: add comment about formatting verification

2018-02-20 Thread Matthew Wilcox
On Tue, Feb 20, 2018 at 04:54:44PM +0200, Mike Rapoport wrote: > level. > > +Running the ``kernel-doc`` tool with increased verbosity and without actual > +output generation may be used to verify proper formating of the "formatting" > +documentation comments. For example:: > + > + scripts/

Re: [PATCH v3] usb: core: Add "quirks" parameter for usbcore

2018-02-25 Thread Matthew Wilcox
On Sun, Feb 25, 2018 at 08:38:33PM +0800, Kai-Heng Feng wrote: > v2: Use in-kernel tolower() function. ... why are you using tolower at all? You've got 13 quirks already; you may need to use upper case as well before too long. > + quirk = vmalloc(sizeof(struct quirk_entry)); vmalloc

Re: [PATCH v4] usb: core: Add "quirks" parameter for usbcore

2018-02-28 Thread Matthew Wilcox
On Mon, Feb 26, 2018 at 11:04:57PM +0800, Kai-Heng Feng wrote: > +static char quirks_param[128]; > +module_param_string(quirks, quirks_param, sizeof(quirks_param), 0644); > +MODULE_PARM_DESC(quirks, "Add/modify USB quirks by specifying > quirks=vendorID:productID:quirks"); > + > +static char quirk

Re: [PATCH v4] usb: core: Add "quirks" parameter for usbcore

2018-02-28 Thread Matthew Wilcox
On Thu, Mar 01, 2018 at 12:01:40AM +0800, Kai Heng Feng wrote: > > Also, you won't need to use a linked list for this; you can just allocate > > an array of quirks. > > I use linked list because the total quirks number is known after the entire > string gets parsed. > Do you suggest that I should

Re: [PATCH] Documentation/sphinx: Fix Directive import error

2018-03-02 Thread Matthew Wilcox
On Fri, Mar 02, 2018 at 12:49:03PM +0100, Takashi Iwai wrote: > I'm no expert of sphinx nor python, so something might be wrong. > Please check it. I'm also not a pythonista, but ... > --- a/Documentation/sphinx/kerneldoc.py > +++ b/Documentation/sphinx/kerneldoc.py > @@ -37,7 +37,10 @@ import gl

Re: [PATCH v2] Documentation/sphinx: Fix Directive import error

2018-03-02 Thread Matthew Wilcox
On Fri, Mar 02, 2018 at 04:28:31PM +0100, Takashi Iwai wrote: > from docutils.parsers.rst import directives > -from sphinx.util.compat import Directive > +try: > +from docutils.parsers.rst import directives, Directive We also don't need 'directives' on this line as it was imported on the prev

Re: [PATCH v2] Documentation/sphinx: Fix Directive import error

2018-03-02 Thread Matthew Wilcox
On Fri, Mar 02, 2018 at 06:01:50PM +0200, Jani Nikula wrote: > On Fri, 02 Mar 2018, Takashi Iwai wrote: > > The sphinx.util.compat for Directive stuff was deprecated in the > > recent Sphinx version, and now we get a build error. > > > > Let's import from the new place, docutils.parsers.rst, while

Re: [PATCH v2] Documentation/sphinx: Fix Directive import error

2018-03-02 Thread Matthew Wilcox
On Fri, Mar 02, 2018 at 08:42:54AM -0800, Matthew Wilcox wrote: > On Fri, Mar 02, 2018 at 06:01:50PM +0200, Jani Nikula wrote: > > On Fri, 02 Mar 2018, Takashi Iwai wrote: > > > The sphinx.util.compat for Directive stuff was deprecated in the > > > recent Sphinx vers

[PATCH v3] Documentation/sphinx: Fix Directive import error

2018-03-02 Thread Matthew Wilcox
From: Matthew Wilcox Sphinx 1.7 removed sphinx.util.compat.Directive so people who have upgraded cannot build the documentation. Switch to docutils.parsers.rst.Directive which has been available since docutils 0.5 released in 2009. Bugzilla: https://bugzilla.opensuse.org/show_bug.cgi?id

Re: [PATCH 2/2] docs: add Co-Developed-by docs

2018-03-05 Thread Matthew Wilcox
On Mon, Mar 05, 2018 at 02:58:21PM +1100, Tobin C. Harding wrote: > -12) When to use Acked-by: and Cc: > -- > +12) When to use Acked-by: and Cc:, and Co-Developed-by: > +--- +12) When to use Acked-by:, Cc:, and Co-

[PATCH] Improve mutex documentation

2018-03-15 Thread Matthew Wilcox
On Wed, Mar 14, 2018 at 01:56:31PM -0700, Andrew Morton wrote: > My memory is weak and our documentation is awful. What does > mutex_lock_killable() actually do and how does it differ from > mutex_lock_interruptible()? From: Matthew Wilcox Add kernel-doc for mutex_lock_killa

[PATCH] kernel-doc: Remove __sched markings

2018-03-15 Thread Matthew Wilcox
From: Matthew Wilcox I find the __sched annotations unaesthetic in the kernel-doc. Remove them like we remove __inline, __weak, __init and so on. Signed-off-by: Matthew Wilcox diff --git a/scripts/kernel-doc b/scripts/kernel-doc index ae3cac118a11..eb986a7809d3 100755 --- a/scripts/kernel

Re: [PATCH] Improve mutex documentation

2018-03-15 Thread Matthew Wilcox
On Thu, Mar 15, 2018 at 03:12:30PM +0300, Kirill Tkhai wrote: > > +/** > > + * mutex_lock_killable() - Acquire the mutex, interruptible by fatal > > signals. > > Shouldn't we clarify that fatal signals are SIGKILL only? It's more complicated than it might seem (... welcome to signal handling!) I

Re: rfc: remove print_vma_addr ? (was Re: [PATCH 00/16] remove eight obsolete architectures)

2018-03-15 Thread Matthew Wilcox
On Thu, Mar 15, 2018 at 09:56:46AM -0700, Joe Perches wrote: > I have a patchset that creates a vsprintf extension for > print_vma_addr and removes all the uses similar to the > print_symbol() removal. > > This now avoids any possible printk interleaving. > > Unfortunately, without some #ifdef in

Re: [PATCH 1/2] COPYING: create a new file with points to the Kernel license files

2018-03-22 Thread Matthew Wilcox
On Thu, Mar 22, 2018 at 06:54:13AM -0300, Mauro Carvalho Chehab wrote: > +++ b/Documentation/process/license-rules.rst > @@ -4,15 +4,17 @@ Linux kernel licensing rules > > > The Linux Kernel is provided under the terms of the GNU General Public > -License version 2

Re: [PATCH net-next 00/12] fscache: Fixes, traces and development

2018-04-06 Thread Matthew Wilcox
On Fri, Apr 06, 2018 at 11:32:11AM -0700, Linus Torvalds wrote: > On Fri, Apr 6, 2018 at 11:21 AM, Linus Torvalds > wrote: > > > > No, but if you can redo the pull request part so that the diffstat I > > get will match the diffstat I see in the pull request, that would be > > good. > > Oh, and ca

Re: [PATCH v2 1/2] mm: introduce ARCH_HAS_PTE_SPECIAL

2018-04-10 Thread Matthew Wilcox
On Tue, Apr 10, 2018 at 05:25:50PM +0200, Laurent Dufour wrote: > arch/powerpc/include/asm/pte-common.h | 3 --- > arch/riscv/Kconfig | 1 + > arch/s390/Kconfig | 1 + You forgot to delete __HAVE_ARCH_PTE_SPE

Re: [PATCH 00/32] docs/vm: convert to ReST format

2018-04-13 Thread Matthew Wilcox
On Fri, Apr 13, 2018 at 01:55:51PM -0600, Jonathan Corbet wrote: > > I believe that keeping the mm docs together will give better visibility of > > what (little) mm documentation we have and will make the updates easier. > > The documents that fit well into a certain topic could be linked there. Fo

Re: [PATCH v11 2/3] ipc: Conserve sequence numbers in ipcmni_extend mode

2018-11-09 Thread Matthew Wilcox
On Fri, Nov 09, 2018 at 03:11:31PM -0500, Waiman Long wrote: > The mixing in of a sequence number into the IPC IDs is probably to > avoid ID reuse in userspace as much as possible. With ipcmni_extend > mode, the number of usable sequence numbers is greatly reduced leading > to higher chance of ID r

Re: [PATCH v2] ksm: allow dedup all tasks memory

2018-11-11 Thread Matthew Wilcox
On Mon, Nov 12, 2018 at 12:26:10AM +0300, Timofey Titovets wrote: > ksm by default working only on memory that added by > madvice(). > > And only way get that work on other applications: > - Use LD_PRELOAD and libraries > - Patch kernel > > Lets use kernel task list in ksm_scan_thread and add l

Re: [PATCH V3] KSM: allow dedup all tasks memory

2018-11-12 Thread Matthew Wilcox
On Tue, Nov 13, 2018 at 02:13:44AM +0300, Timofey Titovets wrote: > Some numbers from different not madvised workloads. > Formulas: > Percentage ratio = (pages_sharing - pages_shared)/pages_unshared > Memory saved = (pages_sharing - pages_shared)*4/1024 MiB > Memory used = free -h > > * Na

Re: [PATCH 01/12] kernfs: add function to find kernfs_node without increasing ref counter

2018-11-12 Thread Matthew Wilcox
On Mon, Nov 12, 2018 at 04:28:40AM -0800, Greg Kroah-Hartman wrote: > On Mon, Nov 12, 2018 at 10:56:21AM +0100, Paolo Valente wrote: > > From: Angelo Ruocco > > > > The kernfs pseudo file system doesn't export any function to only find > > a node by name, without also getting a reference on it. >

Re: [PATCH RFC 2/6] mm: convert PG_balloon to PG_offline

2018-11-14 Thread Matthew Wilcox
On Wed, Nov 14, 2018 at 10:17:00PM +0100, David Hildenbrand wrote: > Rename PG_balloon to PG_offline. This is an indicator that the page is > logically offline, the content stale and that it should not be touched > (e.g. a hypervisor would have to allocate backing storage in order for the > guest t

Re: [LKP] dad4f140ed [ 7.709376] WARNING:suspicious_RCU_usage

2018-11-18 Thread Matthew Wilcox
On Mon, Nov 19, 2018 at 09:08:20AM +0800, kernel test robot wrote: > Greetings, > > 0day kernel testing robot got the below dmesg and the first bad commit is Umm. I don't see a 'suspicious RCU usage' message in here. I see a lot of vmalloc warnings ... ? > [7.699777] swapper: vmalloc: allo

  1   2   >