diff options
| author | Christopher Ferris <cferris@google.com> | 2014-01-17 11:19:48 -0800 |
|---|---|---|
| committer | Android Git Automerger <android-git-automerger@android.com> | 2014-01-17 11:19:48 -0800 |
| commit | 237fdb4a95aeb94ad040a737c6fa22d84d05d633 (patch) | |
| tree | 0e0f6b54fea73e17dab88ba89783e3ee1ce1098b /include/backtrace/backtrace.h | |
| parent | e20b5f71c01d912a5ce6aa4140e6e35edae8f4df (diff) | |
| parent | eb8d73b675d8d9613310b5d5e5865571b98d6f78 (diff) | |
| download | system_core-237fdb4a95aeb94ad040a737c6fa22d84d05d633.zip system_core-237fdb4a95aeb94ad040a737c6fa22d84d05d633.tar.gz system_core-237fdb4a95aeb94ad040a737c6fa22d84d05d633.tar.bz2 | |
am eb8d73b6: Merge "Rewrite libbacktrace to be all C++."
* commit 'eb8d73b675d8d9613310b5d5e5865571b98d6f78':
Rewrite libbacktrace to be all C++.
Diffstat (limited to 'include/backtrace/backtrace.h')
| -rw-r--r-- | include/backtrace/backtrace.h | 131 |
1 files changed, 0 insertions, 131 deletions
diff --git a/include/backtrace/backtrace.h b/include/backtrace/backtrace.h deleted file mode 100644 index cfcbf0f..0000000 --- a/include/backtrace/backtrace.h +++ /dev/null @@ -1,131 +0,0 @@ -/* - * Copyright (C) 2013 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef _BACKTRACE_H -#define _BACKTRACE_H - -#include <stdint.h> -#include <stdbool.h> -#include <sys/types.h> - -__BEGIN_DECLS - -// When the pid to be traced is set to this value, then trace the current -// process. If the tid value is not BACKTRACE_NO_TID, then the specified -// thread from the current process will be traced. -#define BACKTRACE_CURRENT_PROCESS -1 -// When the tid to be traced is set to this value, then trace the specified -// current thread of the specified pid. -#define BACKTRACE_CURRENT_THREAD -1 - -#define MAX_BACKTRACE_FRAMES 64 - -typedef struct backtrace_map_info { - struct backtrace_map_info* next; - uintptr_t start; - uintptr_t end; - bool is_readable; - bool is_writable; - bool is_executable; - char name[]; -} backtrace_map_info_t; - -typedef struct { - size_t num; /* The current fame number. */ - uintptr_t pc; /* The absolute pc. */ - uintptr_t sp; /* The top of the stack. */ - size_t stack_size; /* The size of the stack, zero indicate an unknown stack size. */ - const char* map_name; /* The name of the map to which this pc belongs, NULL indicates the pc doesn't belong to a known map. */ - uintptr_t map_offset; /* pc relative to the start of the map, only valid if map_name is not NULL. */ - char* func_name; /* The function name associated with this pc, NULL if not found. */ - uintptr_t func_offset; /* pc relative to the start of the function, only valid if func_name is not NULL. */ -} backtrace_frame_data_t; - -typedef struct { - backtrace_frame_data_t frames[MAX_BACKTRACE_FRAMES]; - size_t num_frames; - - pid_t pid; - pid_t tid; - backtrace_map_info_t* map_info_list; -} backtrace_t; - -typedef struct { - void* data; - const backtrace_t* backtrace; -} backtrace_context_t; - -/* Create a context for the backtrace data and gather the backtrace. - * If pid < 0, then gather the backtrace for the current process. - */ -bool backtrace_create_context( - backtrace_context_t* context, pid_t pid, pid_t tid, size_t num_ignore_frames); - -/* The same as backtrace_create_context, except that it is assumed that - * the pid map has already been acquired and the caller will handle freeing - * the map data. - */ -bool backtrace_create_context_with_map( - backtrace_context_t* context, pid_t pid, pid_t tid, size_t num_ignore_frames, - backtrace_map_info_t* map_info); - -/* Gather the backtrace data for a pthread instead of a process. */ -bool backtrace_create_thread_context( - backtrace_context_t* context, pid_t tid, size_t num_ignore_frames); - -/* Free any memory allocated during the context create. */ -void backtrace_destroy_context(backtrace_context_t* context); - -/* Read data at a specific address for a process. */ -bool backtrace_read_word( - const backtrace_context_t* context, uintptr_t ptr, uint32_t* value); - -/* Get information about the map name associated with a pc. If NULL is - * returned, then map_start is not set. - */ -const char* backtrace_get_map_name( - const backtrace_context_t* context, uintptr_t pc, uintptr_t* map_start); - -/* Get the function name and offset given the pc. If NULL is returned, - * then func_offset is not set. The returned string is allocated using - * malloc and must be freed by the caller. - */ -char* backtrace_get_func_name( - const backtrace_context_t* context, uintptr_t pc, uintptr_t* func_offset); - -/* Loads memory map from /proc/<pid>/maps. If pid < 0, then load the memory - * map for the current process. - */ -backtrace_map_info_t* backtrace_create_map_info_list(pid_t pid); - -/* Frees memory associated with the map list. */ -void backtrace_destroy_map_info_list(backtrace_map_info_t* map_info_list); - -/* Finds the memory map that contains the specified pc. */ -const backtrace_map_info_t* backtrace_find_map_info( - const backtrace_map_info_t* map_info_list, uintptr_t pc); - -/* Create a formatted line of backtrace information for a single frame. */ -void backtrace_format_frame_data( - const backtrace_context_t* context, size_t frame_num, char* buf, - size_t buf_size); - -/* Get the backtrace data structure associated with the context. */ -const backtrace_t* backtrace_get_data(backtrace_context_t* context); - -__END_DECLS - -#endif /* _BACKTRACE_H */ |
