OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
13 // limitations under the License. | 13 // limitations under the License. |
14 | 14 |
15 #include "minidump/minidump_crashpad_info_writer.h" | 15 #include "minidump/minidump_crashpad_info_writer.h" |
16 | 16 |
17 #include <windows.h> | 17 #include <windows.h> |
18 #include <dbghelp.h> | 18 #include <dbghelp.h> |
19 | 19 |
| 20 #include <map> |
| 21 #include <string> |
| 22 |
20 #include "gtest/gtest.h" | 23 #include "gtest/gtest.h" |
21 #include "minidump/minidump_extensions.h" | 24 #include "minidump/minidump_extensions.h" |
22 #include "minidump/minidump_file_writer.h" | 25 #include "minidump/minidump_file_writer.h" |
23 #include "minidump/minidump_module_crashpad_info_writer.h" | 26 #include "minidump/minidump_module_crashpad_info_writer.h" |
| 27 #include "minidump/minidump_simple_string_dictionary_writer.h" |
24 #include "minidump/test/minidump_file_writer_test_util.h" | 28 #include "minidump/test/minidump_file_writer_test_util.h" |
25 #include "minidump/test/minidump_string_writer_test_util.h" | 29 #include "minidump/test/minidump_string_writer_test_util.h" |
26 #include "minidump/test/minidump_writable_test_util.h" | 30 #include "minidump/test/minidump_writable_test_util.h" |
27 #include "snapshot/test/test_module_snapshot.h" | 31 #include "snapshot/test/test_module_snapshot.h" |
28 #include "snapshot/test/test_process_snapshot.h" | 32 #include "snapshot/test/test_process_snapshot.h" |
29 #include "util/file/string_file_writer.h" | 33 #include "util/file/string_file_writer.h" |
30 | 34 |
31 namespace crashpad { | 35 namespace crashpad { |
32 namespace test { | 36 namespace test { |
33 namespace { | 37 namespace { |
34 | 38 |
35 void GetCrashpadInfoStream(const std::string& file_contents, | 39 void GetCrashpadInfoStream( |
36 const MinidumpCrashpadInfo** crashpad_info, | 40 const std::string& file_contents, |
37 const MinidumpModuleCrashpadInfoList** module_list) { | 41 const MinidumpCrashpadInfo** crashpad_info, |
| 42 const MinidumpSimpleStringDictionary** simple_annotations, |
| 43 const MinidumpModuleCrashpadInfoList** module_list) { |
38 const MINIDUMP_DIRECTORY* directory; | 44 const MINIDUMP_DIRECTORY* directory; |
39 const MINIDUMP_HEADER* header = | 45 const MINIDUMP_HEADER* header = |
40 MinidumpHeaderAtStart(file_contents, &directory); | 46 MinidumpHeaderAtStart(file_contents, &directory); |
41 ASSERT_NO_FATAL_FAILURE(VerifyMinidumpHeader(header, 1, 0)); | 47 ASSERT_NO_FATAL_FAILURE(VerifyMinidumpHeader(header, 1, 0)); |
42 ASSERT_TRUE(directory); | 48 ASSERT_TRUE(directory); |
43 | 49 |
44 ASSERT_EQ(kMinidumpStreamTypeCrashpadInfo, directory[0].StreamType); | 50 ASSERT_EQ(kMinidumpStreamTypeCrashpadInfo, directory[0].StreamType); |
45 | 51 |
46 *crashpad_info = MinidumpWritableAtLocationDescriptor<MinidumpCrashpadInfo>( | 52 *crashpad_info = MinidumpWritableAtLocationDescriptor<MinidumpCrashpadInfo>( |
47 file_contents, directory[0].Location); | 53 file_contents, directory[0].Location); |
48 ASSERT_TRUE(*crashpad_info); | 54 ASSERT_TRUE(*crashpad_info); |
49 | 55 |
| 56 *simple_annotations = |
| 57 MinidumpWritableAtLocationDescriptor<MinidumpSimpleStringDictionary>( |
| 58 file_contents, (*crashpad_info)->simple_annotations); |
| 59 |
50 *module_list = | 60 *module_list = |
51 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfoList>( | 61 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfoList>( |
52 file_contents, (*crashpad_info)->module_list); | 62 file_contents, (*crashpad_info)->module_list); |
53 } | 63 } |
54 | 64 |
55 TEST(MinidumpCrashpadInfoWriter, Empty) { | 65 TEST(MinidumpCrashpadInfoWriter, Empty) { |
56 MinidumpFileWriter minidump_file_writer; | 66 MinidumpFileWriter minidump_file_writer; |
57 auto crashpad_info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); | 67 auto crashpad_info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); |
58 EXPECT_FALSE(crashpad_info_writer->IsUseful()); | 68 EXPECT_FALSE(crashpad_info_writer->IsUseful()); |
59 | 69 |
60 minidump_file_writer.AddStream(crashpad_info_writer.Pass()); | 70 minidump_file_writer.AddStream(crashpad_info_writer.Pass()); |
61 | 71 |
62 StringFileWriter file_writer; | 72 StringFileWriter file_writer; |
63 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); | 73 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); |
64 | 74 |
65 const MinidumpCrashpadInfo* crashpad_info = nullptr; | 75 const MinidumpCrashpadInfo* crashpad_info = nullptr; |
| 76 const MinidumpSimpleStringDictionary* simple_annotations = nullptr; |
66 const MinidumpModuleCrashpadInfoList* module_list = nullptr; | 77 const MinidumpModuleCrashpadInfoList* module_list = nullptr; |
67 | 78 |
68 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( | 79 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( |
69 file_writer.string(), &crashpad_info, &module_list)); | 80 file_writer.string(), &crashpad_info, &simple_annotations, &module_list)); |
| 81 |
| 82 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, crashpad_info->version); |
| 83 EXPECT_FALSE(simple_annotations); |
| 84 EXPECT_FALSE(module_list); |
| 85 } |
| 86 |
| 87 TEST(MinidumpCrashpadInfoWriter, SimpleAnnotations) { |
| 88 MinidumpFileWriter minidump_file_writer; |
| 89 auto crashpad_info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); |
| 90 |
| 91 const char kKey[] = |
| 92 "a thing that provides a means of gaining access to or understanding " |
| 93 "something"; |
| 94 const char kValue[] = |
| 95 "the numerical amount denoted by an algebraic term; a magnitude, " |
| 96 "quantity, or number"; |
| 97 auto simple_string_dictionary_writer = |
| 98 make_scoped_ptr(new MinidumpSimpleStringDictionaryWriter()); |
| 99 auto simple_string_dictionary_entry_writer = |
| 100 make_scoped_ptr(new MinidumpSimpleStringDictionaryEntryWriter()); |
| 101 simple_string_dictionary_entry_writer->SetKeyValue(kKey, kValue); |
| 102 simple_string_dictionary_writer->AddEntry( |
| 103 simple_string_dictionary_entry_writer.Pass()); |
| 104 crashpad_info_writer->SetSimpleAnnotations( |
| 105 simple_string_dictionary_writer.Pass()); |
| 106 |
| 107 EXPECT_TRUE(crashpad_info_writer->IsUseful()); |
| 108 |
| 109 minidump_file_writer.AddStream(crashpad_info_writer.Pass()); |
| 110 |
| 111 StringFileWriter file_writer; |
| 112 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); |
| 113 |
| 114 const MinidumpCrashpadInfo* crashpad_info = nullptr; |
| 115 const MinidumpSimpleStringDictionary* simple_annotations = nullptr; |
| 116 const MinidumpModuleCrashpadInfoList* module_list = nullptr; |
| 117 |
| 118 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( |
| 119 file_writer.string(), &crashpad_info, &simple_annotations, &module_list)); |
70 | 120 |
71 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, crashpad_info->version); | 121 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, crashpad_info->version); |
72 EXPECT_FALSE(module_list); | 122 EXPECT_FALSE(module_list); |
| 123 |
| 124 ASSERT_TRUE(simple_annotations); |
| 125 ASSERT_EQ(1u, simple_annotations->count); |
| 126 EXPECT_EQ(kKey, |
| 127 MinidumpUTF8StringAtRVAAsString( |
| 128 file_writer.string(), simple_annotations->entries[0].key)); |
| 129 EXPECT_EQ(kValue, |
| 130 MinidumpUTF8StringAtRVAAsString( |
| 131 file_writer.string(), simple_annotations->entries[0].value)); |
73 } | 132 } |
74 | 133 |
75 TEST(MinidumpCrashpadInfoWriter, CrashpadModuleList) { | 134 TEST(MinidumpCrashpadInfoWriter, CrashpadModuleList) { |
76 const uint32_t kMinidumpModuleListIndex = 3; | 135 const uint32_t kMinidumpModuleListIndex = 3; |
77 | 136 |
78 MinidumpFileWriter minidump_file_writer; | 137 MinidumpFileWriter minidump_file_writer; |
79 auto crashpad_info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); | 138 auto crashpad_info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); |
80 | 139 |
81 auto module_list_writer = | 140 auto module_list_writer = |
82 make_scoped_ptr(new MinidumpModuleCrashpadInfoListWriter()); | 141 make_scoped_ptr(new MinidumpModuleCrashpadInfoListWriter()); |
83 auto module_writer = make_scoped_ptr(new MinidumpModuleCrashpadInfoWriter()); | 142 auto module_writer = make_scoped_ptr(new MinidumpModuleCrashpadInfoWriter()); |
84 module_writer->SetMinidumpModuleListIndex(kMinidumpModuleListIndex); | 143 module_writer->SetMinidumpModuleListIndex(kMinidumpModuleListIndex); |
85 module_list_writer->AddModule(module_writer.Pass()); | 144 module_list_writer->AddModule(module_writer.Pass()); |
86 crashpad_info_writer->SetModuleList(module_list_writer.Pass()); | 145 crashpad_info_writer->SetModuleList(module_list_writer.Pass()); |
87 | 146 |
88 EXPECT_TRUE(crashpad_info_writer->IsUseful()); | 147 EXPECT_TRUE(crashpad_info_writer->IsUseful()); |
89 | 148 |
90 minidump_file_writer.AddStream(crashpad_info_writer.Pass()); | 149 minidump_file_writer.AddStream(crashpad_info_writer.Pass()); |
91 | 150 |
92 StringFileWriter file_writer; | 151 StringFileWriter file_writer; |
93 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); | 152 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); |
94 | 153 |
95 const MinidumpCrashpadInfo* crashpad_info = nullptr; | 154 const MinidumpCrashpadInfo* crashpad_info = nullptr; |
96 const MinidumpModuleCrashpadInfoList* module_list; | 155 const MinidumpSimpleStringDictionary* simple_annotations = nullptr; |
| 156 const MinidumpModuleCrashpadInfoList* module_list = nullptr; |
97 | 157 |
98 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( | 158 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( |
99 file_writer.string(), &crashpad_info, &module_list)); | 159 file_writer.string(), &crashpad_info, &simple_annotations, &module_list)); |
100 | 160 |
101 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, crashpad_info->version); | 161 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, crashpad_info->version); |
| 162 EXPECT_FALSE(simple_annotations); |
| 163 |
102 ASSERT_TRUE(module_list); | 164 ASSERT_TRUE(module_list); |
103 ASSERT_EQ(1u, module_list->count); | 165 ASSERT_EQ(1u, module_list->count); |
104 | 166 |
105 const MinidumpModuleCrashpadInfo* module = | 167 const MinidumpModuleCrashpadInfo* module = |
106 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfo>( | 168 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfo>( |
107 file_writer.string(), module_list->children[0]); | 169 file_writer.string(), module_list->children[0]); |
108 ASSERT_TRUE(module); | 170 ASSERT_TRUE(module); |
109 | 171 |
110 EXPECT_EQ(MinidumpModuleCrashpadInfo::kVersion, module->version); | 172 EXPECT_EQ(MinidumpModuleCrashpadInfo::kVersion, module->version); |
111 EXPECT_EQ(kMinidumpModuleListIndex, module->minidump_module_list_index); | 173 EXPECT_EQ(kMinidumpModuleListIndex, module->minidump_module_list_index); |
112 EXPECT_EQ(0u, module->list_annotations.DataSize); | 174 EXPECT_EQ(0u, module->list_annotations.DataSize); |
113 EXPECT_EQ(0u, module->list_annotations.Rva); | 175 EXPECT_EQ(0u, module->list_annotations.Rva); |
114 EXPECT_EQ(0u, module->simple_annotations.DataSize); | 176 EXPECT_EQ(0u, module->simple_annotations.DataSize); |
115 EXPECT_EQ(0u, module->simple_annotations.Rva); | 177 EXPECT_EQ(0u, module->simple_annotations.Rva); |
116 } | 178 } |
117 | 179 |
118 TEST(MinidumpCrashpadInfoWriter, InitializeFromSnapshot) { | 180 TEST(MinidumpCrashpadInfoWriter, InitializeFromSnapshot) { |
| 181 const char kKey[] = "version"; |
| 182 const char kValue[] = "40.0.2214.111"; |
119 const char kEntry[] = "This is a simple annotation in a list."; | 183 const char kEntry[] = "This is a simple annotation in a list."; |
120 | 184 |
121 // Test with a useless module, one that doesn’t carry anything that would | 185 // Test with a useless module, one that doesn’t carry anything that would |
122 // require MinidumpCrashpadInfo or any child object. | 186 // require MinidumpCrashpadInfo or any child object. |
123 auto process_snapshot = make_scoped_ptr(new TestProcessSnapshot()); | 187 auto process_snapshot = make_scoped_ptr(new TestProcessSnapshot()); |
124 | 188 |
125 auto module_snapshot = make_scoped_ptr(new TestModuleSnapshot()); | 189 auto module_snapshot = make_scoped_ptr(new TestModuleSnapshot()); |
126 process_snapshot->AddModule(module_snapshot.Pass()); | 190 process_snapshot->AddModule(module_snapshot.Pass()); |
127 | 191 |
128 auto info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); | 192 auto info_writer = make_scoped_ptr(new MinidumpCrashpadInfoWriter()); |
129 info_writer->InitializeFromSnapshot(process_snapshot.get()); | 193 info_writer->InitializeFromSnapshot(process_snapshot.get()); |
130 EXPECT_FALSE(info_writer->IsUseful()); | 194 EXPECT_FALSE(info_writer->IsUseful()); |
131 | 195 |
132 // Try again with a useful module. | 196 // Try again with a useful module. |
133 process_snapshot.reset(new TestProcessSnapshot()); | 197 process_snapshot.reset(new TestProcessSnapshot()); |
134 | 198 |
| 199 std::map<std::string, std::string> annotations_simple_map; |
| 200 annotations_simple_map[kKey] = kValue; |
| 201 process_snapshot->SetAnnotationsSimpleMap(annotations_simple_map); |
| 202 |
135 module_snapshot.reset(new TestModuleSnapshot()); | 203 module_snapshot.reset(new TestModuleSnapshot()); |
136 std::vector<std::string> annotations_list(1, std::string(kEntry)); | 204 std::vector<std::string> annotations_list(1, std::string(kEntry)); |
137 module_snapshot->SetAnnotationsVector(annotations_list); | 205 module_snapshot->SetAnnotationsVector(annotations_list); |
138 process_snapshot->AddModule(module_snapshot.Pass()); | 206 process_snapshot->AddModule(module_snapshot.Pass()); |
139 | 207 |
140 info_writer.reset(new MinidumpCrashpadInfoWriter()); | 208 info_writer.reset(new MinidumpCrashpadInfoWriter()); |
141 info_writer->InitializeFromSnapshot(process_snapshot.get()); | 209 info_writer->InitializeFromSnapshot(process_snapshot.get()); |
142 EXPECT_TRUE(info_writer->IsUseful()); | 210 EXPECT_TRUE(info_writer->IsUseful()); |
143 | 211 |
144 MinidumpFileWriter minidump_file_writer; | 212 MinidumpFileWriter minidump_file_writer; |
145 minidump_file_writer.AddStream(info_writer.Pass()); | 213 minidump_file_writer.AddStream(info_writer.Pass()); |
146 | 214 |
147 StringFileWriter file_writer; | 215 StringFileWriter file_writer; |
148 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); | 216 ASSERT_TRUE(minidump_file_writer.WriteEverything(&file_writer)); |
149 | 217 |
150 const MinidumpCrashpadInfo* info = nullptr; | 218 const MinidumpCrashpadInfo* info = nullptr; |
| 219 const MinidumpSimpleStringDictionary* simple_annotations; |
151 const MinidumpModuleCrashpadInfoList* module_list; | 220 const MinidumpModuleCrashpadInfoList* module_list; |
152 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( | 221 ASSERT_NO_FATAL_FAILURE(GetCrashpadInfoStream( |
153 file_writer.string(), &info, &module_list)); | 222 file_writer.string(), &info, &simple_annotations, &module_list)); |
154 | 223 |
155 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, info->version); | 224 EXPECT_EQ(MinidumpCrashpadInfo::kVersion, info->version); |
| 225 |
| 226 ASSERT_TRUE(simple_annotations); |
| 227 ASSERT_EQ(1u, simple_annotations->count); |
| 228 EXPECT_EQ(kKey, |
| 229 MinidumpUTF8StringAtRVAAsString( |
| 230 file_writer.string(), simple_annotations->entries[0].key)); |
| 231 EXPECT_EQ(kValue, |
| 232 MinidumpUTF8StringAtRVAAsString( |
| 233 file_writer.string(), simple_annotations->entries[0].value)); |
| 234 |
156 ASSERT_TRUE(module_list); | 235 ASSERT_TRUE(module_list); |
157 ASSERT_EQ(1u, module_list->count); | 236 ASSERT_EQ(1u, module_list->count); |
158 | 237 |
159 const MinidumpModuleCrashpadInfo* module = | 238 const MinidumpModuleCrashpadInfo* module = |
160 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfo>( | 239 MinidumpWritableAtLocationDescriptor<MinidumpModuleCrashpadInfo>( |
161 file_writer.string(), module_list->children[0]); | 240 file_writer.string(), module_list->children[0]); |
162 ASSERT_TRUE(module); | 241 ASSERT_TRUE(module); |
163 | 242 |
164 EXPECT_EQ(MinidumpModuleCrashpadInfo::kVersion, module->version); | 243 EXPECT_EQ(MinidumpModuleCrashpadInfo::kVersion, module->version); |
165 EXPECT_EQ(0u, module->minidump_module_list_index); | 244 EXPECT_EQ(0u, module->minidump_module_list_index); |
166 | 245 |
167 const MinidumpRVAList* list_annotations = | 246 const MinidumpRVAList* list_annotations = |
168 MinidumpWritableAtLocationDescriptor<MinidumpRVAList>( | 247 MinidumpWritableAtLocationDescriptor<MinidumpRVAList>( |
169 file_writer.string(), module->list_annotations); | 248 file_writer.string(), module->list_annotations); |
170 ASSERT_TRUE(list_annotations); | 249 ASSERT_TRUE(list_annotations); |
171 | 250 |
172 ASSERT_EQ(1u, list_annotations->count); | 251 ASSERT_EQ(1u, list_annotations->count); |
173 EXPECT_EQ(kEntry, | 252 EXPECT_EQ(kEntry, |
174 MinidumpUTF8StringAtRVAAsString( | 253 MinidumpUTF8StringAtRVAAsString(file_writer.string(), |
175 file_writer.string(), list_annotations->children[0])); | 254 list_annotations->children[0])); |
176 | 255 |
177 const MinidumpSimpleStringDictionary* simple_annotations = | 256 const MinidumpSimpleStringDictionary* module_simple_annotations = |
178 MinidumpWritableAtLocationDescriptor<MinidumpSimpleStringDictionary>( | 257 MinidumpWritableAtLocationDescriptor<MinidumpSimpleStringDictionary>( |
179 file_writer.string(), module->simple_annotations); | 258 file_writer.string(), module->simple_annotations); |
180 EXPECT_FALSE(simple_annotations); | 259 EXPECT_FALSE(module_simple_annotations); |
181 } | 260 } |
182 | 261 |
183 } // namespace | 262 } // namespace |
184 } // namespace test | 263 } // namespace test |
185 } // namespace crashpad | 264 } // namespace crashpad |
OLD | NEW |