| Index: base/trace_event/memory_dump_manager.h
 | 
| diff --git a/base/trace_event/memory_dump_manager.h b/base/trace_event/memory_dump_manager.h
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..fbc71d5e006e0048a2f09c2d83413f2e1676fba9
 | 
| --- /dev/null
 | 
| +++ b/base/trace_event/memory_dump_manager.h
 | 
| @@ -0,0 +1,87 @@
 | 
| +// Copyright 2015 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_TRACE_EVENT_MEMORY_DUMP_MANAGER_H_
 | 
| +#define BASE_TRACE_EVENT_MEMORY_DUMP_MANAGER_H_
 | 
| +
 | 
| +#include <vector>
 | 
| +
 | 
| +#include "base/atomicops.h"
 | 
| +#include "base/memory/singleton.h"
 | 
| +#include "base/synchronization/lock.h"
 | 
| +#include "base/trace_event/trace_event.h"
 | 
| +
 | 
| +namespace base {
 | 
| +namespace trace_event {
 | 
| +
 | 
| +class MemoryDumpProvider;
 | 
| +
 | 
| +// Captures the reason why a dump point is being requested. This is to allow
 | 
| +// selective enabling of dump points, filtering and post-processing.
 | 
| +enum class DumpPointType {
 | 
| +  TASK_BEGIN,         // Dumping memory at the beginning of a message-loop task.
 | 
| +  TASK_END,           // Dumping memory at the ending of a message-loop task.
 | 
| +  PERIODIC_INTERVAL,  // Dumping memory at periodic intervals.
 | 
| +  EXPLICITLY_TRIGGERED,  // Non maskable dump request.
 | 
| +};
 | 
| +
 | 
| +// This is the interface exposed to the rest of the codebase to deal with
 | 
| +// memory tracing. The main entry point for clients is represented by
 | 
| +// RequestDumpPoint(). The extension by Un(RegisterDumpProvider).
 | 
| +class BASE_EXPORT MemoryDumpManager : public TraceLog::EnabledStateObserver {
 | 
| + public:
 | 
| +  static MemoryDumpManager* GetInstance();
 | 
| +
 | 
| +  // Invoked once per process to register the TraceLog observer.
 | 
| +  void Initialize();
 | 
| +
 | 
| +  // MemoryDumpManager does NOT take memory ownership of |mdp|, which is
 | 
| +  // expected to be a singleton.
 | 
| +  void RegisterDumpProvider(MemoryDumpProvider* mdp);
 | 
| +  void UnregisterDumpProvider(MemoryDumpProvider* mdp);
 | 
| +
 | 
| +  // Requests a memory dump. The dump might happen or not depending on the
 | 
| +  // filters and categories specified when enabling tracing.
 | 
| +  void RequestDumpPoint(DumpPointType type);
 | 
| +
 | 
| +  // TraceLog::EnabledStateObserver implementation.
 | 
| +  void OnTraceLogEnabled() override;
 | 
| +  void OnTraceLogDisabled() override;
 | 
| +
 | 
| + private:
 | 
| +  friend struct DefaultSingletonTraits<MemoryDumpManager>;
 | 
| +  friend class MemoryDumpManagerTest;
 | 
| +
 | 
| +  static const char kTraceCategory[];
 | 
| +
 | 
| +  MemoryDumpManager();
 | 
| +  virtual ~MemoryDumpManager();
 | 
| +
 | 
| +  // Tears down the singleton instance.
 | 
| +  static void DeleteForTesting();
 | 
| +
 | 
| +  // Broadcasts the dump requests to the other processes.
 | 
| +  void BroadcastDumpRequest();
 | 
| +
 | 
| +  // Creates a dump point for the current process and appends it to the trace.
 | 
| +  void CreateLocalDumpPoint();
 | 
| +
 | 
| +  std::vector<MemoryDumpProvider*> dump_providers_registered_;  // Not owned.
 | 
| +  std::vector<MemoryDumpProvider*> dump_providers_enabled_;     // Not owned.
 | 
| +
 | 
| +  // Protects from concurrent accesses to the |dump_providers_*|, e.g., tearing
 | 
| +  // down logging while creating a dump point on another thread.
 | 
| +  Lock lock_;
 | 
| +
 | 
| +  // Optimization to avoid attempting any dump point (i.e. to not walk an empty
 | 
| +  // dump_providers_enabled_ list) when tracing is not enabled.
 | 
| +  subtle::AtomicWord memory_tracing_enabled_;
 | 
| +
 | 
| +  DISALLOW_COPY_AND_ASSIGN(MemoryDumpManager);
 | 
| +};
 | 
| +
 | 
| +}  // namespace trace_event
 | 
| +}  // namespace base
 | 
| +
 | 
| +#endif  // BASE_TRACE_EVENT_MEMORY_DUMP_MANAGER_H_
 | 
| 
 |