1 /* 2 * Copyright (C) 2012 The Android Open Source Project 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 #ifndef _DEBUGGERD_TOMBSTONE_H 18 #define _DEBUGGERD_TOMBSTONE_H 19 20 #include <stdbool.h> 21 #include <stddef.h> 22 #include <sys/types.h> 23 24 #include <map> 25 #include <string> 26 27 #include <android-base/unique_fd.h> 28 29 #include "open_files_list.h" 30 #include "types.h" 31 32 // Forward declarations 33 namespace unwindstack { 34 class Unwinder; 35 } 36 37 // The maximum number of frames to save when unwinding. 38 constexpr size_t kMaxFrames = 256; 39 40 /* Create and open a tombstone file for writing. 41 * Returns a writable file descriptor, or -1 with errno set appropriately. 42 * If out_path is non-null, *out_path is set to the path of the tombstone file. 43 */ 44 int open_tombstone(std::string* path); 45 46 /* Creates a tombstone file and writes the crash dump to it. */ 47 void engrave_tombstone(int tombstone_fd, unwindstack::Unwinder* unwinder, 48 const OpenFilesList* open_files, pid_t pid, pid_t tid, 49 const std::string& process_name, const std::map<pid_t, std::string>& threads, 50 uint64_t abort_msg_address, std::string* amfd_data); 51 52 void engrave_tombstone_ucontext(int tombstone_fd, uint64_t abort_msg_address, siginfo_t* siginfo, 53 ucontext_t* ucontext); 54 55 void engrave_tombstone(android::base::unique_fd output_fd, unwindstack::Unwinder* unwinder, 56 const std::map<pid_t, ThreadInfo>& thread_info, pid_t target_thread, 57 uint64_t abort_msg_address, OpenFilesList* open_files, 58 std::string* amfd_data); 59 60 #endif // _DEBUGGERD_TOMBSTONE_H 61