1 | /* |
2 | * Copyright 2012-present Facebook, Inc. |
3 | * |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
5 | * you may not use this file except in compliance with the License. |
6 | * You may obtain a copy of the License at |
7 | * |
8 | * http://www.apache.org/licenses/LICENSE-2.0 |
9 | * |
10 | * Unless required by applicable law or agreed to in writing, software |
11 | * distributed under the License is distributed on an "AS IS" BASIS, |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
13 | * See the License for the specific language governing permissions and |
14 | * limitations under the License. |
15 | */ |
16 | |
17 | // |
18 | // Exception tracer library. |
19 | |
20 | #pragma once |
21 | |
22 | #include <cstdint> |
23 | #include <iosfwd> |
24 | #include <typeinfo> |
25 | #include <vector> |
26 | |
27 | namespace folly { |
28 | namespace exception_tracer { |
29 | |
30 | struct ExceptionInfo { |
31 | const std::type_info* type{nullptr}; |
32 | // The values in frames are IP (instruction pointer) addresses. |
33 | // They are only filled if the low-level exception tracer library is |
34 | // linked in or LD_PRELOADed. |
35 | std::vector<uintptr_t> frames; // front() is top of stack |
36 | }; |
37 | |
38 | void printExceptionInfo( |
39 | std::ostream& out, |
40 | const ExceptionInfo& info, |
41 | int options); |
42 | std::ostream& operator<<(std::ostream& out, const ExceptionInfo& info); |
43 | |
44 | /** |
45 | * Get current exceptions being handled. front() is the most recent exception. |
46 | * There should be at most one unless rethrowing. |
47 | */ |
48 | std::vector<ExceptionInfo> getCurrentExceptions(); |
49 | |
50 | /** |
51 | * Install the terminate / unexpected handlers to dump exceptions. |
52 | */ |
53 | void installHandlers(); |
54 | |
55 | } // namespace exception_tracer |
56 | } // namespace folly |
57 | |