1 /*
2  *
3  * Copyright 2020 gRPC authors.
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  *     http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  *
17  */
18 
19 #ifndef GRPC_CORE_LIB_GPRPP_EXAMINE_STACK_H
20 #define GRPC_CORE_LIB_GPRPP_EXAMINE_STACK_H
21 
22 #include <grpc/support/port_platform.h>
23 
24 #include <functional>
25 #include <string>
26 
27 #include "absl/types/optional.h"
28 
29 namespace grpc_core {
30 
31 typedef std::string (*gpr_current_stack_trace_func)();
32 
33 // Returns a current_stack_trace_provider.
34 gpr_current_stack_trace_func GetCurrentStackTraceProvider();
35 
36 // Sets current_stack_trace_provider which provides a current-stack trace.
37 void SetCurrentStackTraceProvider(
38     gpr_current_stack_trace_func current_stack_trace_provider);
39 
40 // Returns the current stack trace as a string via current_stack_trace_provider
41 // If current_stack_trace_provider is not set, it returns absl::nullopt.
42 absl::optional<std::string> GetCurrentStackTrace();
43 
44 }  // namespace grpc_core
45 
46 #endif /* GRPC_CORE_LIB_GPRPP_EXAMINE_STACK_H */
47