1501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown/*
2501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * Copyright (C) 2011 The Android Open Source Project
3501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown *
4501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * Licensed under the Apache License, Version 2.0 (the "License");
5501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * you may not use this file except in compliance with the License.
6501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * You may obtain a copy of the License at
7501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown *
8501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown *      http://www.apache.org/licenses/LICENSE-2.0
9501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown *
10501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * Unless required by applicable law or agreed to in writing, software
11501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * distributed under the License is distributed on an "AS IS" BASIS,
12501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * See the License for the specific language governing permissions and
14501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * limitations under the License.
15501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown */
16501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
17501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown/* Backtrace helper functions. */
18501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
19501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#ifndef _CORKSCREW_BACKTRACE_HELPER_H
20501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#define _CORKSCREW_BACKTRACE_HELPER_H
21501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
22501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#include <corkscrew/backtrace.h>
23501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#include <sys/types.h>
24501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#include <stdbool.h>
25501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
26501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#ifdef __cplusplus
27501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brownextern "C" {
28501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#endif
29501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
30501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown/*
31501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * Add a program counter to a backtrace if it will fit.
32501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown * Returns the newly added frame, or NULL if none.
33501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown */
34501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brownbacktrace_frame_t* add_backtrace_entry(uintptr_t pc,
35501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown        backtrace_frame_t* backtrace,
36501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown        size_t ignore_depth, size_t max_depth,
37501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown        size_t* ignored_frames, size_t* returned_frames);
38501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
39501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#ifdef __cplusplus
40501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown}
41501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#endif
42501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown
43501edd29b823ce1301d2effdd3a9e4b6e2b20b76Jeff Brown#endif // _CORKSCREW_BACKTRACE_HELPER_H
44