Better explain re-entrant migration when compaction races with reclaim,
and also mention swapcache readahead pages as possible uncharged migration
sources.
Signed-off-by: Johannes Weiner <hannes@cmpxchg.org>
Cc: Hugh Dickins <hughd@google.com>
Acked-by: Michal Hocko <mhocko@suse.cz>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
        if (PageCgroupUsed(pc))
                return;
 
-       /* Re-entrant migration: old page already uncharged? */
+       /*
+        * Swapcache readahead pages can get migrated before being
+        * charged, and migration from compaction can happen to an
+        * uncharged page when the PFN walker finds a page that
+        * reclaim just put back on the LRU but has not released yet.
+        */
        pc = lookup_page_cgroup(oldpage);
        if (!PageCgroupUsed(pc))
                return;