Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
mm: add kernel-doc for folio_mark_accessed()
Convert the existing documentation to kernel-doc and remove references to
pages.
Link: https://lkml.kernel.org/r/20240424191914.361554-7-willy@infradead.org
Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
authored by
Matthew Wilcox (Oracle)
and committed by
Andrew Morton
21db296a
9cbe4954
+10
-7
+10
-7
mm/swap.c
+10
-7
mm/swap.c
···
447
447
}
448
448
#endif /* CONFIG_LRU_GEN */
449
449
450
-
/*
451
-
* Mark a page as having seen activity.
450
+
/**
451
+
* folio_mark_accessed - Mark a folio as having seen activity.
452
+
* @folio: The folio to mark.
452
453
*
453
-
* inactive,unreferenced -> inactive,referenced
454
-
* inactive,referenced -> active,unreferenced
455
-
* active,unreferenced -> active,referenced
454
+
* This function will perform one of the following transitions:
456
455
*
457
-
* When a newly allocated page is not yet visible, so safe for non-atomic ops,
458
-
* __SetPageReferenced(page) may be substituted for mark_page_accessed(page).
456
+
* * inactive,unreferenced -> inactive,referenced
457
+
* * inactive,referenced -> active,unreferenced
458
+
* * active,unreferenced -> active,referenced
459
+
*
460
+
* When a newly allocated folio is not yet visible, so safe for non-atomic ops,
461
+
* __folio_set_referenced() may be substituted for folio_mark_accessed().
459
462
*/
460
463
void folio_mark_accessed(struct folio *folio)
461
464
{