1 //
2 // Copyright 2018 The Abseil Authors.
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 //      https://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 #ifndef ABSL_DEBUGGING_INTERNAL_EXAMINE_STACK_H_
18 #define ABSL_DEBUGGING_INTERNAL_EXAMINE_STACK_H_
19 
20 #include "absl/base/config.h"
21 
22 namespace absl {
23 ABSL_NAMESPACE_BEGIN
24 namespace debugging_internal {
25 
26 // Returns the program counter from signal context, or nullptr if
27 // unknown. `vuc` is a ucontext_t*. We use void* to avoid the use of
28 // ucontext_t on non-POSIX systems.
29 void* GetProgramCounter(void* vuc);
30 
31 // Uses `writerfn` to dump the program counter, stack trace, and stack
32 // frame sizes.
33 void DumpPCAndFrameSizesAndStackTrace(
34     void* pc, void* const stack[], int frame_sizes[], int depth,
35     int min_dropped_frames, bool symbolize_stacktrace,
36     void (*writerfn)(const char*, void*), void* writerfn_arg);
37 
38 }  // namespace debugging_internal
39 ABSL_NAMESPACE_END
40 }  // namespace absl
41 
42 #endif  // ABSL_DEBUGGING_INTERNAL_EXAMINE_STACK_H_
43