OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ | 5 #ifndef BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ |
6 #define BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ | 6 #define BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ |
7 | 7 |
8 // This file defines the types and structs used to issue memory dump requests. | 8 // This file defines the types and structs used to issue memory dump requests. |
9 // These are also used in the IPCs for coordinating inter-process memory dumps. | 9 // These are also used in the IPCs for coordinating inter-process memory dumps. |
10 | 10 |
11 #include <stdint.h> | 11 #include <stdint.h> |
12 #include <map> | 12 #include <map> |
13 #include <string> | 13 #include <string> |
14 | 14 |
15 #include "base/base_export.h" | 15 #include "base/base_export.h" |
16 #include "base/callback.h" | 16 #include "base/callback.h" |
17 #include "base/process/process_handle.h" | 17 #include "base/process/process_handle.h" |
18 | 18 |
19 namespace base { | 19 namespace base { |
20 namespace trace_event { | 20 namespace trace_event { |
21 | 21 |
22 // Captures the reason why a memory dump is being requested. This is to allow | 22 // Captures the reason why a memory dump is being requested. This is to allow |
23 // selective enabling of dumps, filtering and post-processing. Important: this | 23 // selective enabling of dumps, filtering and post-processing. Keep this |
24 // must be kept consistent with | 24 // consistent with memory_instrumentation.mojo and |
25 // services/resource_coordinator/public/cpp/memory/memory_infra_traits.cc. | 25 // memory_instrumentation_struct_traits.{h,cc} |
26 enum class MemoryDumpType { | 26 enum class MemoryDumpType { |
27 PERIODIC_INTERVAL, // Dumping memory at periodic intervals. | 27 PERIODIC_INTERVAL, // Dumping memory at periodic intervals. |
28 EXPLICITLY_TRIGGERED, // Non maskable dump request. | 28 EXPLICITLY_TRIGGERED, // Non maskable dump request. |
29 PEAK_MEMORY_USAGE, // Dumping memory at detected peak total memory usage. | 29 PEAK_MEMORY_USAGE, // Dumping memory at detected peak total memory usage. |
30 LAST = PEAK_MEMORY_USAGE // For IPC macros. | 30 LAST = PEAK_MEMORY_USAGE // For IPC macros. |
31 }; | 31 }; |
32 | 32 |
33 // Tells the MemoryDumpProvider(s) how much detailed their dumps should be. | 33 // Tells the MemoryDumpProvider(s) how much detailed their dumps should be. |
34 // Important: this must be kept consistent with | 34 // Keep this consistent with memory_instrumentation.mojo and |
35 // services/resource_Coordinator/public/cpp/memory/memory_infra_traits.cc. | 35 // memory_instrumentation_struct_traits.{h,cc} |
36 enum class MemoryDumpLevelOfDetail : uint32_t { | 36 enum class MemoryDumpLevelOfDetail : uint32_t { |
37 FIRST, | 37 FIRST, |
38 | 38 |
39 // For background tracing mode. The dump time is quick, and typically just the | 39 // For background tracing mode. The dump time is quick, and typically just the |
40 // totals are expected. Suballocations need not be specified. Dump name must | 40 // totals are expected. Suballocations need not be specified. Dump name must |
41 // contain only pre-defined strings and string arguments cannot be added. | 41 // contain only pre-defined strings and string arguments cannot be added. |
42 BACKGROUND = FIRST, | 42 BACKGROUND = FIRST, |
43 | 43 |
44 // For the levels below, MemoryDumpProvider instances must guarantee that the | 44 // For the levels below, MemoryDumpProvider instances must guarantee that the |
45 // total size reported in the root node is consistent. Only the granularity of | 45 // total size reported in the root node is consistent. Only the granularity of |
46 // the child MemoryAllocatorDump(s) differs with the levels. | 46 // the child MemoryAllocatorDump(s) differs with the levels. |
47 | 47 |
48 // Few entries, typically a fixed number, per dump. | 48 // Few entries, typically a fixed number, per dump. |
49 LIGHT, | 49 LIGHT, |
50 | 50 |
51 // Unrestricted amount of entries per dump. | 51 // Unrestricted amount of entries per dump. |
52 DETAILED, | 52 DETAILED, |
53 | 53 |
54 LAST = DETAILED | 54 LAST = DETAILED |
55 }; | 55 }; |
56 | 56 |
57 // Initial request arguments for a global memory dump. (see | 57 // Initial request arguments for a global memory dump. (see |
58 // MemoryDumpManager::RequestGlobalMemoryDump()). Important: this must be kept | 58 // MemoryDumpManager::RequestGlobalMemoryDump()). Keep this consistent with |
59 // consistent with services/memory_infra/public/cpp/memory_infra_traits.cc. | 59 // memory_instrumentation.mojo and memory_instrumentation_struct_traits.{h,cc} |
60 struct BASE_EXPORT MemoryDumpRequestArgs { | 60 struct BASE_EXPORT MemoryDumpRequestArgs { |
61 // Globally unique identifier. In multi-process dumps, all processes issue a | 61 // Globally unique identifier. In multi-process dumps, all processes issue a |
62 // local dump with the same guid. This allows the trace importers to | 62 // local dump with the same guid. This allows the trace importers to |
63 // reconstruct the global dump. | 63 // reconstruct the global dump. |
64 uint64_t dump_guid; | 64 uint64_t dump_guid; |
65 | 65 |
66 MemoryDumpType dump_type; | 66 MemoryDumpType dump_type; |
67 MemoryDumpLevelOfDetail level_of_detail; | 67 MemoryDumpLevelOfDetail level_of_detail; |
68 }; | 68 }; |
69 | 69 |
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
110 BASE_EXPORT const char* MemoryDumpLevelOfDetailToString( | 110 BASE_EXPORT const char* MemoryDumpLevelOfDetailToString( |
111 const MemoryDumpLevelOfDetail& level_of_detail); | 111 const MemoryDumpLevelOfDetail& level_of_detail); |
112 | 112 |
113 BASE_EXPORT MemoryDumpLevelOfDetail | 113 BASE_EXPORT MemoryDumpLevelOfDetail |
114 StringToMemoryDumpLevelOfDetail(const std::string& str); | 114 StringToMemoryDumpLevelOfDetail(const std::string& str); |
115 | 115 |
116 } // namespace trace_event | 116 } // namespace trace_event |
117 } // namespace base | 117 } // namespace base |
118 | 118 |
119 #endif // BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ | 119 #endif // BASE_TRACE_EVENT_MEMORY_DUMP_REQUEST_ARGS_H_ |
OLD | NEW |