base: Add ashmem support to base::DiscardableSharedMemory implementation.

base/memory/discardable_shared_memory.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef BASE_MEMORY_DISCARDABLE_SHARED_MEMORY_H_
 #define BASE_MEMORY_DISCARDABLE_SHARED_MEMORY_H_
 
+#ifndef NDEBUG
+#include <set>
+#endif
+
 #include "base/base_export.h"
 #include "base/memory/shared_memory.h"
 #include "base/time/time.h"
 
 namespace base {
 
 // Platform abstraction for discardable shared memory.
 class BASE_EXPORT DiscardableSharedMemory {
  public:
   DiscardableSharedMemory();
 
   // Create a new DiscardableSharedMemory object from an existing, open shared
-  // memory file.
+  // memory file. Memory should be locked.

[Avi (use Gerrit), 2014/12/17 16:58:17]

should? must

[reveman, 2014/12/17 18:38:49]

Done.

   explicit DiscardableSharedMemory(SharedMemoryHandle handle);
 
   // Closes any open files.
   virtual ~DiscardableSharedMemory();
 
   // Creates and maps a locked DiscardableSharedMemory object with |size|.
   // Returns true on success and false on failure.
   bool CreateAndMap(size_t size);
 
-  // Maps the discardable memory into the caller's address space.
+  // Maps the locked discardable memory into the caller's address space.
   // Returns true on success, false otherwise.
   bool Map(size_t size);
 
   // The actual size of the mapped memory (may be larger than requested).
-  size_t mapped_size() const { return shared_memory_.mapped_size(); }
+  size_t mapped_size() const { return mapped_size_; }
 
   // Returns a shared memory handle for this DiscardableSharedMemory object.
   SharedMemoryHandle handle() const { return shared_memory_.handle(); }
 
-  // Locks the memory so that it will not be purged by the system. Returns
-  // true if successful and the memory is still resident. Locking can fail
-  // for three reasons; object might have been purged, our last known usage
+  // Locks a range of memory so that it will not be purged by the system.
+  // Returns true if successful and the memory is still resident. Locking can
+  // fail for three reasons; object might have been purged, our last known usage
   // timestamp might be out of date or memory might already be locked. Last
   // know usage time is updated to the actual last usage timestamp if memory
-  // is still resident or 0 if not.
-  bool Lock();
+  // is still resident or 0 if not. The range of memory must be unlocked. The
+  // result of trying to lock an already locked range is undefined.
+  // |offset| and |length| must both be a multiple of the systems page size.

[Avi (use Gerrit), 2014/12/17 16:58:17]

system's

You might want to call out base::GetPageSize() as the way to get that value.

[reveman, 2014/12/17 18:38:49]

Yes, I fixed this typo already.
Good idea. Done.

+  // Passing 0 for |length| means "everything onward".
+  bool Lock(size_t offset, size_t length);
 
-  // Unlock previously successfully locked memory.
-  void Unlock();
+  // Unlock a previously successfully locked range of memory. The range of
+  // memory must be locked. The result of trying to unlock a not
+  // previously locked range is undefined.
+  // |offset| and |length| must both be a multiple of the systems page size.

[Avi (use Gerrit), 2014/12/17 16:58:17]

Same comment as above.

[reveman, 2014/12/17 18:38:49]

Done.

+  // Passing 0 for |length| means "everything onward".
+  void Unlock(size_t offset, size_t length);
 
   // Gets a pointer to the opened discardable memory space. Discardable memory
   // must have been mapped via Map().
   void* memory() const;
 
   // Returns the last know usage time for DiscardableSharedMemory object. This
   // may be earlier than the "true" usage time when memory has been used by a
   // different process. Returns NULL time if purged.
   Time last_known_usage() const { return last_known_usage_; }
 
@@ skipping 32 matching lines @@
   bool ShareToProcess(ProcessHandle process_handle,
                       SharedMemoryHandle* new_handle) {
     return shared_memory_.ShareToProcess(process_handle, new_handle);
   }
 
  private:
   // Virtual for tests.
   virtual Time Now() const;
 
   SharedMemory shared_memory_;
+  size_t mapped_size_;
+  size_t locked_page_count_;
+#ifndef NDEBUG
+  std::set<size_t> locked_pages_;
+#endif
   Time last_known_usage_;
 
   DISALLOW_COPY_AND_ASSIGN(DiscardableSharedMemory);
 };
 
 }  // namespace base
 
 #endif  // BASE_MEMORY_DISCARDABLE_SHARED_MEMORY_H_