1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in 12 * the documentation and/or other materials provided with the 13 * distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #pragma once 30 31 /** 32 * @file android/set_abort_message.h 33 * @brief The android_set_abort_message() function. 34 */ 35 36 #include <sys/cdefs.h> 37 38 #include <stddef.h> 39 #include <stdint.h> 40 #include <string.h> 41 42 __BEGIN_DECLS 43 44 typedef struct crash_detail_t crash_detail_t; 45 46 /** 47 * android_set_abort_message() sets the abort message passed to 48 * [debuggerd](https://source.android.com/devices/tech/debug/native-crash) 49 * for inclusion in any crash. 50 * 51 * This is meant for use by libraries that deliberately abort so that they can 52 * provide an explanation. It is used within bionic to implement assert() and 53 * all FORTIFY and fdsan failures. 54 * 55 * The message appears directly in logcat at the time of crash. It will 56 * also be added to both the tombstone proto in the crash_detail field, and 57 * in the tombstone text format. 58 * 59 * Tombstone proto definition: 60 * https://cs.android.com/android/platform/superproject/main/+/main:system/core/debuggerd/proto/tombstone.proto 61 * 62 * An app can get hold of these for any `REASON_CRASH_NATIVE` instance of 63 * `android.app.ApplicationExitInfo`. 64 * https://developer.android.com/reference/android/app/ApplicationExitInfo#getTraceInputStream() 65 * 66 * The given message is copied at the time this function is called, and does 67 * not need to be valid until the crash actually happens, but typically this 68 * function is called immediately before aborting. See <android/crash_detail.h> 69 * for API more suited to the use case where the caller doesn't _expect_ a 70 * crash but would like to see the information _if_ a crash happens. 71 */ 72 void android_set_abort_message(const char* _Nullable __msg); 73 74 __END_DECLS 75