PartitionAlloc: add a discardSystemPages() hint API.

Source/wtf/PageAllocator.h

Index: Source/wtf/PageAllocator.h
diff --git a/Source/wtf/PageAllocator.h b/Source/wtf/PageAllocator.h
index bcde4e24a44c92d8f41a1ed4b39ae4e9e0654f77..dbecc0586a630325f023bc6a2771af9734e062b3 100644
--- a/Source/wtf/PageAllocator.h
+++ b/Source/wtf/PageAllocator.h
@@ -107,6 +107,23 @@ WTF_EXPORT void decommitSystemPages(void* addr, size_t len);
 // len must be a multiple of kSystemPageSize bytes.
 WTF_EXPORT void recommitSystemPages(void* addr, size_t len);
 
+// Discard one or more system pages. Discarding is a hint to the system that
+// the page is no longer required. The hint may:
+// - Do nothing.
+// - Discard the page immediately, freeing up physical pages.
+// - Discard the page at some time in the future in response to memory pressure.
+// Only committed pages should be discarded. Discarding a page does not
+// decommit it, and it is valid to discard an already-discarded page.

[haraken, 2015/06/18 18:15:40]

I'm a bit confused with "Discarding a page does not decommit it" -- it looks
like you're calling decommitSystemPages in discardSystemPages.

+// A read or write to a discarded page will not fault.

[haraken, 2015/06/18 18:15:40]

Given that you call decommitSystemPages, I guess a read or write to the page can
fault.

+// Reading from a discarded page may return the original page content, or a
+// page full of zeroes.
+// Writing to a discarded page is the only guaranteed way to undo the effect of

[haraken, 2015/06/18 18:15:40]

"undo the effect of discarding it" might be a bit misleading. It's possible that
the page is already discarded and then it can return a page of zeros.

+// discarding it. Once written to, the content of the page is guaranteed stable
+// again. After being written to, the page content may be based on the original
+// page content, or a page of zeroes.
+// len must be a multiple of kSystemPageSize bytes.
+WTF_EXPORT void discardSystemPages(void* addr, size_t len);
+
 } // namespace WTF
 
 #endif // WTF_PageAllocator_h