* [PATCH] mm/truncate: add parameter explanation for invalidate_mapping_pagevec
@ 2020-11-17 9:24 Alex Shi
2020-11-17 9:24 ` [PATCH] mm/mapping_dirty_helpers: enhance the kernel-doc markups Alex Shi
2020-11-17 9:24 ` [PATCH] mm/vmalloc: add 'align' parameter explanation for pvm_determine_end_from_reverse Alex Shi
0 siblings, 2 replies; 3+ messages in thread
From: Alex Shi @ 2020-11-17 9:24 UTC (permalink / raw)
To: akpm; +Cc: linux-mm, linux-kernel
To fix a kernel-doc markups issue:
mm/truncate.c:646: warning: Function parameter or member 'mapping' not
described in 'invalidate_mapping_pagevec'
mm/truncate.c:646: warning: Function parameter or member 'start' not
described in 'invalidate_mapping_pagevec'
mm/truncate.c:646: warning: Function parameter or member 'end' not
described in 'invalidate_mapping_pagevec'
mm/truncate.c:646: warning: Function parameter or member 'nr_pagevec'
not described in 'invalidate_mapping_pagevec'
Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org
Cc: linux-kernel@vger.kernel.org
---
mm/truncate.c | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/mm/truncate.c b/mm/truncate.c
index 960edf5803ca..c196fad0bb5d 100644
--- a/mm/truncate.c
+++ b/mm/truncate.c
@@ -637,9 +637,15 @@ unsigned long invalidate_mapping_pages(struct address_space *mapping,
EXPORT_SYMBOL(invalidate_mapping_pages);
/**
- * This helper is similar with the above one, except that it accounts for pages
- * that are likely on a pagevec and count them in @nr_pagevec, which will used by
- * the caller.
+ * invalidate_mapping_pagevec - Invalidate all the unlocked pages of one inode
+ * @mapping: the address_space which holds the pages to invalidate
+ * @start: the offset 'from' which to invalidate
+ * @end: the offset 'to' which to invalidate (inclusive)
+ * @nr_pagevec: invalidate failed page number for caller
+ *
+ * This helper is similar with invalidate_mapping_pages, except that it accounts
+ * for pages that failed to invalidate on a pagevec and count them in
+ * @nr_pagevec, which will used by the caller.
*/
void invalidate_mapping_pagevec(struct address_space *mapping,
pgoff_t start, pgoff_t end, unsigned long *nr_pagevec)
--
2.29.GIT
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [PATCH] mm/mapping_dirty_helpers: enhance the kernel-doc markups
2020-11-17 9:24 [PATCH] mm/truncate: add parameter explanation for invalidate_mapping_pagevec Alex Shi
@ 2020-11-17 9:24 ` Alex Shi
2020-11-17 9:24 ` [PATCH] mm/vmalloc: add 'align' parameter explanation for pvm_determine_end_from_reverse Alex Shi
1 sibling, 0 replies; 3+ messages in thread
From: Alex Shi @ 2020-11-17 9:24 UTC (permalink / raw)
To: akpm; +Cc: linux-mm, linux-kernel
Add and change parameter explanation for wp_pte and clean_record_pte, to
avoid W1 warning:
mm/mapping_dirty_helpers.c:34: warning: Function parameter or member
'end' not described in 'wp_pte'
mm/mapping_dirty_helpers.c:88: warning: Function parameter or member
'end' not described in 'clean_record_pte'
Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org
Cc: linux-kernel@vger.kernel.org
---
mm/mapping_dirty_helpers.c | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/mm/mapping_dirty_helpers.c b/mm/mapping_dirty_helpers.c
index 2c7d03675903..b59054ef2e10 100644
--- a/mm/mapping_dirty_helpers.c
+++ b/mm/mapping_dirty_helpers.c
@@ -23,7 +23,8 @@ struct wp_walk {
/**
* wp_pte - Write-protect a pte
* @pte: Pointer to the pte
- * @addr: The virtual page address
+ * @addr: The start of protecting virtual address
+ * @end: The end of protecting virtual address
* @walk: pagetable walk callback argument
*
* The function write-protects a pte and records the range in
@@ -74,7 +75,8 @@ struct clean_walk {
* clean_record_pte - Clean a pte and record its address space offset in a
* bitmap
* @pte: Pointer to the pte
- * @addr: The virtual page address
+ * @addr: The start of virtual address to be clean
+ * @end: The end of virtual address to be clean
* @walk: pagetable walk callback argument
*
* The function cleans a pte and records the range in
--
2.29.GIT
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [PATCH] mm/vmalloc: add 'align' parameter explanation for pvm_determine_end_from_reverse
2020-11-17 9:24 [PATCH] mm/truncate: add parameter explanation for invalidate_mapping_pagevec Alex Shi
2020-11-17 9:24 ` [PATCH] mm/mapping_dirty_helpers: enhance the kernel-doc markups Alex Shi
@ 2020-11-17 9:24 ` Alex Shi
1 sibling, 0 replies; 3+ messages in thread
From: Alex Shi @ 2020-11-17 9:24 UTC (permalink / raw)
To: akpm; +Cc: linux-mm, linux-kernel
Kernel-doc markup has a issue on pvm_determine_end_from_reverse:
mm/vmalloc.c:3145: warning: Function parameter or member 'align' not
described in 'pvm_determine_end_from_reverse'
Add a explanation for it to remove the warning.
Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org
Cc: linux-kernel@vger.kernel.org
---
mm/vmalloc.c | 1 +
1 file changed, 1 insertion(+)
diff --git a/mm/vmalloc.c b/mm/vmalloc.c
index 7e903524e002..4cd7652ce626 100644
--- a/mm/vmalloc.c
+++ b/mm/vmalloc.c
@@ -3137,6 +3137,7 @@ pvm_find_va_enclose_addr(unsigned long addr)
* @va:
* in - the VA we start the search(reverse order);
* out - the VA with the highest aligned end address.
+ * @align: alignment for required highest address
*
* Returns: determined end address within vmap_area
*/
--
2.29.GIT
^ permalink raw reply related [flat|nested] 3+ messages in thread
end of thread, other threads:[~2020-11-17 9:25 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-11-17 9:24 [PATCH] mm/truncate: add parameter explanation for invalidate_mapping_pagevec Alex Shi
2020-11-17 9:24 ` [PATCH] mm/mapping_dirty_helpers: enhance the kernel-doc markups Alex Shi
2020-11-17 9:24 ` [PATCH] mm/vmalloc: add 'align' parameter explanation for pvm_determine_end_from_reverse Alex Shi
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).