mm/truncate: add parameter explanation for invalidate_mapping_pagevec
Subsystems (4)
PATCH 1/1 mm/truncate: add parameter explanation for invalidate_mapping_pagevec
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'
--- mm/truncate.c | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-)
mm/truncate.c +9 -3
@@ -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)
Signature · 1 line
2.29.GIT
PATCH 1/1 mm/vmalloc: add 'align' parameter explanation for pvm_determine_end_from_reverse
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.
--- mm/vmalloc.c | 1 + 1 file changed, 1 insertion(+)
mm/vmalloc.c +1 -0
@@ -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 */
Signature · 1 line
2.29.GIT
PATCH 1/1 mm/mapping_dirty_helpers: enhance the kernel-doc markups
In reply to Alex ShiAdd 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'
--- mm/mapping_dirty_helpers.c | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
mm/mapping_dirty_helpers.c +4 -2
@@ -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
Signature · 1 line
2.29.GIT